A2A ClientSAFE

An MCP server that acts as a client to the Agent-to-Agent (A2A) protocol, allowing LLMs to interact with A2A agents through the Model Context Protocol (MCP).

Features

• Connect to any A2A-compatible agent
• Send and receive messages
• Track and manage tasks
• Support for streaming responses
• Query agent capabilities and metadata

Installation

# Install globally
npm install -g a2a-client-mcp-server

# Or run directly with npx
npx a2a-client-mcp-server

Configuration

Environment Variables

• A2A_ENDPOINT_URL: URL of the A2A agent to connect to (default: "http://localhost:41241")

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

npm run build
npm link

{
"mcpServers": {
"a2a-client": {
"command": "npx",
"args": ["-y", "a2a-client-mcp-server"],
"env": {
"A2A_ENDPOINT_URL": "http://localhost:41241"
}
}
}
}

Docker

Build the Docker image:

docker build -t a2a-client-mcp-server .

Configure Claude Desktop:

{
"mcpServers": {
"a2a-client": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"A2A_ENDPOINT_URL",
"a2a-client-mcp-server"
],
"env": {
"A2A_ENDPOINT_URL": "http://localhost:41241"
}
}
}
}

Available Tools

a2asendtask

Send a task to an A2A agent

• message (string): Message to send to the agent
• taskId (string, optional): Task ID (generated if not provided)

a2agettask

Get the current state of a task

• taskId (string): ID of the task to retrieve

a2acanceltask

Cancel a running task

• taskId (string): ID of the task to cancel

a2asendtask_subscribe

Send a task and subscribe to updates (streaming)

• message (string): Message to send to the agent
• taskId (string, optional): Task ID (generated if not provided)
• maxUpdates (number, opt