a2asearch-mcp — Claude Code MCP server: what it does, how to install
Connects your assistant to the A2ASearch registry to discover MCP servers, agents, and CLI tools. Retrieves setup snippets and repository links right inside the chat.
claude mcp add a2asearch-mcp -- npx -y a2asearch-mcpWhat a2asearch-mcp does
The server provides four tools to query the public A2ASearch index: search_agents, get_agent, get_setup, and list_agents. It retrieves repository links, star counts, and last commit dates without requiring an API key for the catalog itself. Search relies on literal keywords rather than semantic matching.
When reading setup steps via get_setup, the tool extracts excerpts and JSON configuration examples straight from project README files. It does not run external code, establish remote connections, or configure client settings automatically. Review every command before executing it.
Running this server requires Node.js 22 or newer. API requests enforce a 15-second timeout and halt if canceled by the client.
What it helps with
- discover MCP servers matching specific keywords
- extract configuration snippets from a project README
- inspect repository links, stars, and commit recency
- browse newly submitted AI agents and CLI tools
Example prompts for the agent
- Find an MCP server for PDF table extraction and display its config example
- List recent CLI tools from the directory sorted by stars
- Get setup instructions and repository links for doc2x-mcp
How to install a2asearch-mcp
Platform CLI
claude mcp add a2asearch-mcp -- npx -y a2asearch-mcpPlatform CLI
codex mcp add a2asearch-mcp -- npx -y a2asearch-mcpConfig file
{
"mcpServers": {
"a2asearch-mcp": {
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}Config file
{
"servers": {
"a2asearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"a2asearch-mcp"
]
}
}
}Platform CLI
gemini mcp add a2asearch-mcp npx -y a2asearch-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about a2asearch-mcp
How to install a2asearch-mcp in Claude Code?
Run claude mcp add a2asearch-mcp -- npx -y a2asearch-mcp in your terminal. You must have Node.js 22 or newer installed.
What does a2asearch-mcp do?
It lets your coding assistant search the A2ASearch directory for tools, agents, and servers. The agent can also inspect listings and extract documented setup instructions.
Does A2ASearch require an API key?
Querying the A2ASearch directory is free and does not require an API key. Any third-party tools discovered through the index may still require their own credentials or paid plans.
