# @a2a/mcp

MCP gateway for a2acloud agents. It runs locally as a stdio MCP server and
exposes deployed A2A agents as tools to Claude Code, Cursor, and other MCP
clients.

## Quickstart

```bash
npx -y @a2a/mcp login
npx -y @a2a/mcp add <agent-name>
npx -y @a2a/mcp doctor
```

Add it to your MCP client config:

```json
{
  "mcpServers": {
    "a2a": {
      "command": "npx",
      "args": ["-y", "@a2a/mcp"]
    }
  }
}
```

Restart the client after adding or removing agents.

## Commands

```bash
a2a-mcp login              # save control-plane credentials
a2a-mcp whoami             # show current account
a2a-mcp agents             # list agents visible to your account
a2a-mcp add <name>         # expose one agent through this gateway
a2a-mcp list               # list locally enabled agents
a2a-mcp remove <name>      # stop exposing an agent
a2a-mcp doctor             # probe enabled agents and count tools
a2a-mcp logout             # clear local credentials
```

Running `a2a-mcp` with no command starts the MCP gateway over stdio.