An MCP bridge server between Model Context Protocol (MCP) and Agent-to-Agent (A2A) protocol. Enables AI assistants (like Claude) to interact with A2A agents through a unified interface.

Installation

Smithery

npx -y @smithery/cli install @GongRzhe/A2A-MCP-Server --client claude

PyPI

pip install a2a-mcp-server

From Source

git clone https://github.com/GongRzhe/A2A-MCP-Server.git
cd A2A-MCP-Server
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Command Line

uvx a2a-mcp-server

Configuration

Claude Desktop (PyPI)

{
  "mcpServers": {
    "a2a": {
      "command": "uvx",
      "args": [
        "a2a-mcp-server"
      ]
    }
  }
}

Claude Desktop (Local)

{
  "a2a": {
    "command": "C:\\path\\to\\python.exe",
    "args": [
      "C:\\path\\to\\A2A-MCP-Server\\a2a_mcp_server.py"
    ],
    "env": {
      "MCP_TRANSPORT": "stdio",
      "PYTHONPATH": "C:\\path\\to\\A2A-MCP-Server"
    }
  }
}

Available Tools

Tool	Description
`register_agent`	Register an A2A agent on the bridge server
`list_agents`	Get a list of all registered agents
`unregister_agent`	Remove an A2A agent from the bridge server
`send_message`	Send a message to an agent and get a task_id response
`send_message_stream`	Send a message and stream the response
`get_task_result`	Get a task result by its ID
`cancel_task`	Cancel a running task

Features

Register A2A agents on the bridge server
View all registered agents
Remove agents as needed
Send messages to A2A agents and receive responses
Stream responses from A2A agents in real-time
Track which A2A agent is processing which task
Retrieve task results by ID
Cancel running tasks
Multiple transport types: stdio, streamable-http, SSE

Environment Variables

Optional

MCP_TRANSPORT — transport type: stdio, streamable-http, or sse
MCP_HOST — MCP server host
MCP_PORT — MCP server port (for HTTP transports)
MCP_PATH — path to MCP server endpoint (for HTTP transports)
MCP_SSE_PATH — path to SSE endpoint (for SSE transport)
MCP_DEBUG — enable debug logging

Usage Examples

I need to register a new agent. Can you help me with that? (Agent URL: http://localhost:41242)

Ask the agent at http://localhost:41242 what it can do.

Can you get the results for task ID: 550e8400-e29b-41d4-a716-446655440000?

What's the exchange rate from USD to EUR?

Register an agent at http://localhost:41242

Notes

Supports multiple MCP clients: Claude (web and desktop), Cursor IDE, Windsurf Browser. The server acts as a bridge between MCP and A2A protocols, enabling task management and real-time communication with A2A agents. Includes config_creator.py script for automatic Claude Desktop setup.

A2A MCP Server