ericabouaf/a2a-mcp-server

A2A MCP Server

MCP (Model Context Protocol) server for interacting with Agent-to-Agent (A2A) protocol compliant agents.

Overview

This MCP server enables LLMs to communicate with A2A-compliant agents through the Agent-to-Agent protocol. It provides tools for sending messages, managing tasks, and retrieving agent information.

Features

• a2a_send_message: Send messages to A2A agents and optionally continue existing conversations
• a2a_get_task: Retrieve task status and details by task ID
• a2a_cancel_task: Cancel a running task
• a2a_get_agent_card: Fetch agent metadata and capabilities

Installation

npm install
npm run build

Usage

The server communicates via stdio and can be configured in your MCP client:

{
  "mcpServers": {
    "a2a": {
      "command": "node",
      "args": ["/path/to/a2a-mcp-server/dist/index.js"]
    }
  }
}

Tools

a2a_send_message

Send a message to an A2A agent.

Parameters:

• agentCardUrl (string, required): URL to the agent's card endpoint
• message (string, required): The message text to send
• taskId (string, optional): Existing task ID to continue conversation

Example:

{
  "agentCardUrl": "https://example.com/.well-known/agent-card.json",
  "message": "Hello, what can you do?",
  "taskId": "optional-task-id-to-continue"
}

a2a_get_task

Retrieve the status and details of a task.

Parameters:

• agentCardUrl (string, required): URL to the agent's card endpoint
• taskId (string, required): The task ID to retrieve

a2a_cancel_task

Cancel a running task.

Parameters:

• agentCardUrl (string, required): URL to the agent's card endpoint
• taskId (string, required): The task ID to cancel

a2a_get_agent_card

Retrieve an agent's card with metadata and capabilities.

Parameters:

• agentCardUrl (string, required): URL to the agent's card endpoint

Development

# Install dependencies
npm install

# Run in development mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

License

MIT