Agent2Agent Directory

v1.0.0Developer Toolsstable

Agent2Agent (A2A) – AgentCards, Servers, Clients, Docs

a2aa2a-clienta2a-protocola2a-serveragent
Share:
234
Stars
0
Downloads
0
Weekly
0/5

What is Agent2Agent Directory?

Agent2Agent Directory is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to agent2agent (a2a) – agentcards, servers, clients, docs

Agent2Agent (A2A) – AgentCards, Servers, Clients, Docs

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Agent2Agent (A2A) – AgentCards, Servers, Clients, Docs

Use Cases

Discover AgentCards, servers, and clients in the A2A ecosystem.
Access A2A protocol documentation and resources.
Find agent and server implementations.
sing1ee

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx a2a-directory

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Agent2Agent Directory

The A2A Directory MCP server provides a curated, queryable index of Agent2Agent (A2A) protocol resources — including AgentCards, server implementations, client libraries, and official documentation across multiple programming languages. The A2A protocol (originally from Google) defines how AI agents discover, negotiate with, and delegate tasks to other agents using HTTP, JSON-RPC, and SSE. Developers building multi-agent systems use this directory to find reference implementations, SDKs, and community tools rather than searching scattered repositories.

Prerequisites

  • Node.js 18 or later installed (for npx-based launch)
  • Claude Desktop, Claude Code, or another MCP-compatible client
  • Basic familiarity with the Agent2Agent protocol concepts (AgentCards, task delegation)
1

Add the A2A Directory server to your MCP client config

Register the a2a-directory MCP server in your Claude Desktop or Claude Code configuration using npx. No separate installation step is required.

{
  "mcpServers": {
    "a2a-directory": {
      "command": "npx",
      "args": ["a2a-directory"]
    }
  }
}
2

Restart your MCP client

Restart Claude Desktop or reload MCP servers in Claude Code so the directory server is initialized.

3

Query the directory for A2A implementations

Ask your AI assistant to search the directory for AgentCards, server implementations, or client libraries in a specific language.

4

Explore the official A2A samples repository

Once you find an implementation of interest, clone the official samples repo and follow the instructions in /samples to run example agents.

git clone https://github.com/google-a2a/a2a-samples
cd a2a-samples/samples
5

Install an A2A SDK for your language

Use the directory findings to install the right SDK. The official Python and JavaScript SDKs are published by Google.

# Python
pip install a2a-python

# JavaScript / TypeScript
npm install a2a-js

Agent2Agent Directory Examples

Client configuration

Claude Desktop configuration to add the A2A Directory MCP server. No environment variables are required.

{
  "mcpServers": {
    "a2a-directory": {
      "command": "npx",
      "args": ["a2a-directory"]
    }
  }
}

Prompts to try

Use these prompts to discover A2A resources, implementations, and documentation through the directory.

- "List all available A2A server implementations and their languages"
- "Find A2A client libraries for Go and show me how to get started"
- "What is an AgentCard in the A2A protocol and how is it structured?"
- "Show me A2A implementations that support streaming responses via SSE"
- "Find community tools for A2A agent discovery and identity verification"

Troubleshooting Agent2Agent Directory

npx a2a-directory fails with package not found

Ensure Node.js 18+ and npm are installed and you have internet access to the npm registry. Try `npm view a2a-directory` to confirm the package exists. Clear the npx cache with `npx clear-npx-cache` and retry.

Directory returns no results for a language or SDK search

The A2A ecosystem is evolving rapidly. Try broader search terms (e.g., 'a2a' instead of 'a2a TypeScript client'). For the most up-to-date index, check https://github.com/sing1ee/a2a-directory directly.

A2A samples fail to run after cloning the official repo

Each sample has its own requirements. Navigate into the specific sample directory and read its README for prerequisites. Most Python samples need `pip install a2a-python` and most JS samples need `npm install`.

Frequently Asked Questions about Agent2Agent Directory

What is Agent2Agent Directory?

Agent2Agent Directory is a Model Context Protocol (MCP) server that agent2agent (a2a) – agentcards, servers, clients, docs It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Agent2Agent Directory?

Follow the installation instructions on the Agent2Agent Directory GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Agent2Agent Directory?

Agent2Agent Directory works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Agent2Agent Directory free to use?

Yes, Agent2Agent Directory is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "a2a-directory": { "command": "npx", "args": ["-y", "a2a-directory"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Agent2Agent Directory?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides