# Agent Card Starter

> Agent Card Starter is an open-source MCP server for developer tools. Starter kit that writes and validates an A2A agent card and MCP server card. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://flowboxx.de
- **Repository:** https://github.com/flowboxx/agent-card-starter
- **MCP Registry name:** io.github.flowboxx/agent-card-starter
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agent-card-starter
