MCP A2A Documentation Server

An MCP (Model Context Protocol) server that provides search and retrieval tools for the Agent2Agent (A2A) protocol documentation. This server enables AI assistants like Claude to search and read A2A documentation directly from the upstream repository.

Source

This server indexes documentation from the a2aproject/A2A repository's docs/ directory, which powers a2a-protocol.org.

Related MCP server: openground

Features

• Full-text search using SQLite FTS5 with BM25 ranking and Porter stemming

• Section filtering to narrow search results by documentation category (root, topics, tutorials, sdk)

• Sparse checkout for efficient cloning of only the required docs/ directory

• Docker support for portable deployment across projects

• STDIO transport for seamless MCP client integration

Quick Start

Using the Container Image (Recommended)

The martoc/mcp-a2a-documentation container image is published to Docker Hub with the documentation index pre-built. Available for linux/amd64 and linux/arm64.

# Pull and run the server
docker run -i --rm martoc/mcp-a2a-documentation:latest

Building Locally with Docker

# Build the Docker image (includes pre-indexed documentation)
make docker-build

# Test the server
make docker-run

Using uv (Local Development)

# Initialise the environment
make init

# Build the documentation index
make index

# Run the server
make run

Container Image

The martoc/mcp-a2a-documentation container image is published to Docker Hub. It includes the pre-built documentation index so the server is ready to use immediately.

# Pull the latest image
docker pull martoc/mcp-a2a-documentation:latest

# Run the MCP server
docker run -i --rm martoc/mcp-a2a-documentation:latest

Configuration

Claude Code / Claude Desktop

Add to your .mcp.json or global settings to use the published container image:

{
  "mcpServers": {
    "a2a-documentation": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "martoc/mcp-a2a-documentation:latest"]
    }
  }
}

For local development without Docker:

{
  "mcpServers": {
    "a2a-documentation": {
      "command": "uv",
      "args": ["run", "mcp-a2a-documentation"],
      "cwd": "/path/to/mcp-a2a-documentation"
    }
  }
}

MCP Tools

search_documentation

Search A2A protocol documentation using full-text search with stemming support.

Available sections: root (specification, community, roadmap, partners, etc.), topics (core protocol concepts), tutorials (the Python quickstart), sdk (SDK overview).

read_documentation

Retrieve the full content of a documentation page.

CLI Commands

# Build/rebuild the documentation index
uv run a2a-docs-index index
uv run a2a-docs-index index --rebuild
uv run a2a-docs-index index --branch main

# Show index statistics
uv run a2a-docs-index stats

Development

make init       # Initialise development environment
make build      # Run full build (lint, typecheck, test)
make test       # Run tests with coverage
make format     # Format code
make lint       # Run linter
make typecheck  # Run type checker

Documentation

• USAGE.md - Detailed usage instructions

• CODESTYLE.md - Code style guidelines

• CLAUDE.md - Claude Code instructions

Licence

This project is licensed under the MIT Licence - see the LICENSE file for details.