Log inSubmit server
A2asearch MCP logo

A2asearch MCP

by tadas-github

Searches A2ASearch for MCP servers, agents, CLI tools, and skills, then retrieves listings and setup guidance.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install A2asearch MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tadas-github-a2asearch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "a2asearch-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

tadas-github/a2asearch-mcp connects an MCP client to the public A2ASearch directory of MCP servers, A2A agents, coding agents, CLI tools, and agent skills. Its tools support keyword search, filtered browsing, listing details, and focused setup excerpts with configuration examples. Install it with Node.js 22 or newer through npx; no API key is required to query A2ASearch. Reach for it when an agent needs to discover candidate tools and inspect their documented setup before using them.

Use cases

  • Find MCP servers for a specific capability
  • Compare directory listings by type or popularity
  • Inspect a tool's README and repository details
  • Retrieve setup instructions and configuration examples
  • Browse newly added agents and skills

Key features

  • Keyword search across the A2ASearch directory
  • Detailed listing lookup by slug
  • Filtering and pagination for directory browsing
  • CLI access alongside MCP tools
  • Structured and text tool responses

Tools3

What A2asearch MCP lets your agent do. Expand a tool for its parameters.

Verified live~363 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/6 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · a2asearch-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars21Stargazers on the source repository.
npm downloads319Package downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How A2asearch MCP works

What tadas-github/a2asearch-mcp does

tadas-github/a2asearch-mcp lets an MCP-compatible assistant query the A2ASearch directory, which catalogs MCP servers, A2A agents, AI coding agents, CLI tools, agent skills, and other AI tools. Search and browse results can include names, descriptions, types, capabilities, source links, GitHub stars, languages, and last-commit dates when those values are available.

The server is intended for discovery and inspection. It can return a listing's README and documentation links, and its setup function can extract relevant instructions and JSON configuration examples. It does not install discovered tools, create credentials, contact listed providers, execute submitted code, or modify an MCP client's configuration.

How it works

The server wraps the public A2ASearch REST API and exposes the directory through MCP tools. A typical workflow starts with search_agents using concise keywords such as PDF, database, or browser automation. The result includes a slug, which can then be passed to get_agent or get_setup for deeper inspection. list_agents provides a browsing path when filtering by type or sorting by stars or recent additions is more useful than keyword search.

Search and browse operations support pagination. Result limits range from 1 to 20, with a default of 10, and pages start at 1. Successful calls return structured content with a declared schema as well as serialized text for older clients. Missing directory values are represented as null.

Setup and configuration

Node.js 22 or newer is required. Claude Desktop can launch the package with npx -y a2asearch-mcp through its MCP configuration, and Cursor can use the same command in .cursor/mcp.json. Other clients that support local stdio MCP servers can use the equivalent client-specific configuration.

A basic configuration uses the a2asearch server name, the npx command, and -y a2asearch-mcp as its argument. Pin the package version in the argument when reproducible installs are needed. Terminal users can run the server's companion CLI with npx -y -p a2asearch-mcp a2asearch, or install the package globally with npm.

Tools and capabilities

  • search_agents finds directory entries by keyword, with optional type, page, and result-limit parameters.
  • get_agent retrieves detailed information for a listing identified by its kebab-case slug, including its README, capabilities, repository data, and links.
  • get_setup returns focused setup excerpts, configuration examples, source links, and next steps for a listing.
  • list_agents browses entries by optional type, star count, or newest additions.

The CLI supports directory aliases including mcp, cli, agent, skill, a2a, and tool. Its commands cover searching, listing, retrieving a specific entry, and requesting setup information; JSON output is available for directory operations and setup results.

Limitations and notes

Search is keyword-based rather than semantic, and the API does not provide structured filters for pricing or authentication. Directory data also does not establish runtime reliability, security, hosting, or protocol-test status.

Setup extraction may return links only when supported instructions or configuration examples cannot be found. A submitted URL ending in /mcp or /sse is treated as an endpoint candidate, not as a verified or contacted endpoint. Requests time out after 15 seconds, observe client cancellation, and may return HTTP 429 responses with a retry interval. The package is MIT licensed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about A2asearch MCP

tadas-github/a2asearch-mcp is an MCP server that connects assistants to the public A2ASearch directory. Its main tools search and browse MCP servers, A2A agents, CLI tools, and agent skills, retrieve full listing details, and extract setup instructions and configuration examples without requiring an API key.

Install it with Node.js 22 or newer by configuring your MCP client to run `npx` with `-y a2asearch-mcp` as the argument. Claude Desktop and Cursor use this local stdio command in their respective MCP configuration files.

Yes, tadas-github/a2asearch-mcp works with Cursor through `.cursor/mcp.json`. Configure Cursor to launch `npx` with the `-y a2asearch-mcp` arguments, merging the entry with any existing MCP configuration.

No, tadas-github/a2asearch-mcp only reads the A2ASearch API and returns directory information or setup excerpts. It does not install discovered packages, execute submitted code, contact listed providers, create credentials, or edit client configuration.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewA2asearch MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tadas-github-a2asearch-mcp?style=directory)](https://allmcps.com/mcp/tadas-github-a2asearch-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/tadas-github-a2asearch-mcp"><img src="https://allmcps.com/api/badge/tadas-github-a2asearch-mcp?style=directory" alt="A2asearch MCP on AllMCPs" /></a>