mcp-a2a-documentation
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-a2a-documentation search for 'agent card' in topics"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: Holochain MCP Server
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/directoryDocker 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:latestBuilding Locally with Docker
# Build the Docker image (includes pre-indexed documentation)
make docker-build
# Test the server
make docker-runUsing uv (Local Development)
# Initialise the environment
make init
# Build the documentation index
make index
# Run the server
make runContainer 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.
Property | Value |
Registry | Docker Hub |
Image |
|
Platforms |
|
Base image |
|
Index | Pre-built at image build time from the |
# Pull the latest image
docker pull martoc/mcp-a2a-documentation:latest
# Run the MCP server
docker run -i --rm martoc/mcp-a2a-documentation:latestConfiguration
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
Tool | Description |
| Search A2A documentation by keyword query with optional section filter |
| Retrieve the full content of a specific documentation page |
search_documentation
Search A2A protocol documentation using full-text search with stemming support.
Parameter | Type | Required | Default | Description |
| string | Yes | - | Search terms (supports stemming) |
| string | No | None | Filter by section ( |
| string | No | None | Filter by source ( |
| integer | No | 10 | Maximum results (1-50) |
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.
Parameter | Type | Required | Description |
| string | Yes | Source-prefixed path to the document (e.g., |
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 statsDevelopment
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 checkerDocumentation
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.
Available Tools
2 toolsread_documentationA
Read the full content of a specific A2A protocol documentation page.
Inputs: path (required). Returns: result
search_documentationC
Search A2A (Agent2Agent) protocol documentation by keyword query.
Inputs: query (required), limit, source, section. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: search_documentation finds pages by keyword, while read_documentation retrieves a specific page's full content. There is no meaningful overlap that would cause an agent to select the wrong tool.
Both names follow a consistent snake_case verb_noun pattern: search_documentation and read_documentation. The naming is predictable and directly reflects each tool's action and target.
Two tools is a very thin surface, even for a focused documentation server. Search plus read covers the core flow, but the set feels minimal and could benefit from at least an index/listing operation.
Search and read cover the essential documentation workflow: discover relevant pages, then read full content. A listing or table-of-contents tool would improve browsing, but the current surface is workable for most agent needs.
Maintenance
Related MCP Connectors
Read-only search over the public Sikaru documentation: managed agents, inference, evals and traces.
Search and fetch AgendaForge public documentation and marketing content. No authentication needed.
Search Modellix documentation for model APIs, request schemas, and usage guides.
Search the eSignStack e-signature API, webhook and MCP docs. Public and read-only, no sign-in.
Related MCP Servers
- AlicenseAqualityDmaintenanceSearch and fetch MCP protocol documentation using BM25 search with weighted scoring and stemming.241 npm2MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to search and retrieve Holochain documentation, including developer guides, HDK functions, and HDI API references.2MIT
- AlicenseAqualityDmaintenanceProvides access to Agno framework documentation for AI agents, enabling search and retrieval of SDK references, API endpoints, code examples, and integration guides through MCP-compatible tools.73MIT
- AlicenseAqualityCmaintenanceEnables full-text search and paginated retrieval of indexed documentation (PDFs, Markdown, text) through MCP tools, with filtering by category and file.4GPL 2.0