Skip to content
MCP server

Agent Card Starter

Starter kit that writes and validates an A2A agent card and MCP server card

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.2
Listing updated
3 days ago

About Agent Card Starter

Agent Card Starter is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The aim is to make a small business readable to AI assistants through a small JSON file at /.well-known/agent-card.json. The command-line tool writes that file from a name, description, website and skills, then checks it with a strict validator. Everything runs offline with no account and the Python standard library only (Python 3.9 or later, MIT licensed). The README is clear that uploading the file does not guarantee an assistant will mention the business.

The repository also ships an A2A agent card for a fictional German roofing company, an annotated JSONC copy, an MCP server card, blank templates and an AI catalog template. A minimal example MCP server over stdio exposes two tools: leistungen (services) and anfrage_anlegen (create an inquiry), the latter a stub.

It is maintained by flowboxx, a German agency building AI-ready websites. A WordPress sibling is planned to let an assistant leave an inquiry that arrives as an email, with that inquiry service listed as coming soon. Docs are bilingual in English and German.

Install

Run in a terminal

claude mcp add agent-card-starter -- uvx agent-card-starter

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-card-starter": {
      "command": "uvx",
      "args": [
        "agent-card-starter"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-card-starter": {
      "command": "uvx",
      "args": [
        "agent-card-starter"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agent-card-starter": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-card-starter"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-card-starter": {
      "command": "uvx",
      "args": [
        "agent-card-starter"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-card-starter": {
      "command": "uvx",
      "args": [
        "agent-card-starter"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

leistungen
Lists the example business's services.
anfrage_anlegen
Creates an inquiry; a stub in the example server.

What it does

Agent card generator
Writes an A2A agent card from your business details.
Strict validator
Checks the card against expected structure before upload.
MCP server card
Includes a server card and blank templates to adapt.
Example MCP server
A stdio demo with leistungen and a stub inquiry tool.
Offline, no dependencies
Standard library only, no account or network.
Bilingual docs
README sections in English and German.

Good for

  • Make a local business's services readable to AI assistants
  • Validate an agent card before publishing it
  • Learn how an MCP server card is structured
  • Prototype a small MCP server for inquiries

Pricing

Open source

MIT licence

Prices change. Check flowboxx.de before you buy.

Agent Card Starter FAQ

Where does the generated file go?

Upload it to https://your-domain/.well-known/agent-card.json.

Does it guarantee AI assistants will mention my business?

No. The README states nothing guarantees that.

What do I need to run it?

Python 3.9 or newer; there are no third-party dependencies.

Is the inquiry tool functional?

In the example server it is a stub.

Is Agent Card Starter free?

Yes. Agent Card Starter is open source, so you can use and self-host it for free.

How do I add Agent Card Starter to Claude Code?

Run this command in your terminal: claude mcp add agent-card-starter -- uvx agent-card-starter

What are the best alternatives to Agent Card Starter?

The closest alternatives to Agent Card Starter are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Agent Card Starter

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools