MCP A2A
A2A MCP Server is a lightweight Python bridge that lets Claude Desktop or any MCP client talk to A2A agents. It provides three tools: register servers, list agents, and call an agent, enabling quick integration of A2A-compatible agents with zero boil
What is MCP A2A?
MCP A2A is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to a2a mcp server is a lightweight python bridge that lets claude desktop or any mcp client talk to a2a agents. it provides three tools: register servers, list agents, and call an agent, enabling quick i...
A2A MCP Server is a lightweight Python bridge that lets Claude Desktop or any MCP client talk to A2A agents. It provides three tools: register servers, list agents, and call an agent, enabling quick integration of A2A-compatible agents with zero boil
This server falls under the APIs and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A2A MCP Server is a lightweight Python bridge that lets Clau
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-a2aConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP A2A
MCP A2A Server is a lightweight Python bridge that lets Claude Desktop and other MCP clients communicate directly with A2A (Agent-to-Agent) protocol agents — including those built with pcingola/a2a_min and fast-agent. It exposes three focused MCP tools: registering remote A2A agent servers, listing all registered agents with their capabilities, and calling any registered agent with a prompt and receiving its response. This makes it easy to extend Claude's capabilities by plugging in specialized A2A agents without writing any boilerplate integration code.
Prerequisites
- Python 3.8 or higher
- uv package manager (recommended) or pip
- At least one running A2A-compatible agent server (e.g. built with pcingola/a2a_min or fast-agent)
- Claude Desktop or another MCP-compatible client
Clone the repository
Clone the MCP_A2A repository to your local machine.
git clone https://github.com/regismesquita/MCP_A2A.git
cd MCP_A2AInstall dependencies
Install the required Python packages using uv (recommended) or pip. The server depends on the mcp package.
# Using uv (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install mcp
# Or using pip
pip install mcpStart your A2A agent server
Before connecting via MCP, make sure your A2A agent server is running and reachable. For example, a fast-agent or a2a_min agent running on localhost:8000.
# Example: start an a2a_min agent on port 8000
python your_agent.py --port 8000Add the server to your MCP client configuration
Open your claude_desktop_config.json and configure the MCP A2A server to launch using uv, pointing to the cloned directory.
{
"mcpServers": {
"mcp-a2a": {
"command": "/path/to/.venv/bin/python",
"args": ["/path/to/MCP_A2A/main.py"]
}
}
}Restart Claude Desktop and register your agent
After restarting Claude Desktop, use the a2a_server_registry tool to register your running agent server. Then list agents to confirm registration and start calling agents.
MCP A2A Examples
Client configuration
claude_desktop_config.json entry for MCP A2A Server using a Python virtual environment.
{
"mcpServers": {
"mcp-a2a": {
"command": "/path/to/MCP_A2A/.venv/bin/python",
"args": ["/path/to/MCP_A2A/main.py"]
}
}
}Prompts to try
Prompts that exercise the three MCP tools exposed by the A2A bridge.
- "Register the A2A server called 'security_audit' running at http://localhost:8000"
- "List all registered A2A agents and show their capabilities"
- "Call the agent 'security_audit' with the prompt: scan my GitHub repo at owner/repo for vulnerabilities"
- "Remove the A2A server 'security_audit' from the registry"
- "What agents are currently available?"Troubleshooting MCP A2A
call_agent returns a connection error or timeout
Verify that the A2A agent server is running and accessible at the URL you registered. Test it independently with curl or a browser before calling through MCP. Also check that there are no firewall rules blocking localhost connections.
Claude Desktop does not show the mcp-a2a server
Ensure the Python path in 'command' points to the Python executable inside your virtual environment (not the system Python). The venv must have the 'mcp' package installed. Run '/path/to/.venv/bin/python main.py' manually to check for import errors.
list_agents returns an empty list after registration
The server registry is in-memory and resets when the MCP server process restarts. Re-register your agent with a2a_server_registry after each Claude Desktop restart. Consider adding registration as an automated startup step in your workflow.
Frequently Asked Questions about MCP A2A
What is MCP A2A?
MCP A2A is a Model Context Protocol (MCP) server that a2a mcp server is a lightweight python bridge that lets claude desktop or any mcp client talk to a2a agents. it provides three tools: register servers, list agents, and call an agent, enabling quick integration of a2a-compatible agents with zero boil It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP A2A?
Follow the installation instructions on the MCP A2A GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP A2A?
MCP A2A works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP A2A free to use?
Yes, MCP A2A is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP A2A Alternatives — Similar APIs Servers
Looking for alternatives to MCP A2A? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
★ 43.4k🦍 The API and AI Gateway
API Mega List
★ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHub—period. 💪
Fetch
★ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
★ 2.1kSelf-Hosted API Management for Builders
Korean Law
★ 1.8k국가법령정보MCP v4.0 | 법제처 41개 API → 17개 MCP 도구. 법령·판례·조례 검색 + LLM 환각 방지 인용검증 + 조문 영향 그래프(impact_map) + 시점 비교 자동 diff(time_travel) + 시민 5단계 실행 가이드(action_plan) | 41 Korean legal APIs → 17 MCP tools
RuleGo
★ 1.5k⛓️RuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP A2A in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP A2A?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.