# 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

```bash
npm install
npm run build
```

## Usage

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

```json
{
  "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:**
```typescript
{
  "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

```bash
# 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