Agent Card Starter
Starter kit that writes and validates an A2A agent card and MCP server card
- 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-starterAdd to claude_desktop_config.json
{
"mcpServers": {
"agent-card-starter": {
"command": "uvx",
"args": [
"agent-card-starter"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-card-starter": {
"command": "uvx",
"args": [
"agent-card-starter"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools