agent-tools (x402 + MCP + A2A directory)
● Activecloud.agent-tools/agent-tools-mcp
Discover x402 services, MCP servers and A2A agents by intent — agent-tools.cloud directory.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"agent-tools-mcp": {
"command": "uvx",
"args": [
"agent-tools-mcp"
]
}
}
}claude mcp add agent-tools-mcp -- uvx agent-tools-mcpcodex mcp add agent-tools-mcp -- uvx agent-tools-mcpcode --add-mcp '{"name":"agent-tools-mcp","type":"stdio","command":"uvx","args":["agent-tools-mcp"]}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- AI & Agents
- Version
- 0.5.2
- Registry
- active
- Published
- 11/14/2026
Live check
checked Nov 21, 2026, 01:08 UTCThe endpoint answered the MCP handshake as "agent-tools" and listed 23 tools. Answering since Nov 17, 2026.
Context cost ≈ 8.1k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 23 tools.
Tools (23)
tool list changed Nov 18, 2026, 23:08 UTCsearch7 paramsFind x402 / MCP services matching an intent or filter set. Two usage modes (agents pick whichever fits): A. Natural-language: `search(intent="fetch tweets for @user")` B. Pure browse: `search(has_mcp=True, category="defi", top_k=10)` At least one of `intent`, `category`, `chain`, `has_mcp`, `min_confidence` must be supplied — otherwise the call is rejected (we won't dump 2300+ rows). Results are ranked by: (health=ok AND tx_30d>0) → health=ok → has-quality-signal → confidence → tx_30d → recency. So the highest-quality real-traffic services appear first. Each item includes (when available): - confidence : 0.0–1.0 x402scan quality score. - tx_30d : 30-day x402 payment count (proxy for real usage). - match_snippet : FTS snippet showing where `intent` hit ([[token]]). - match_reason : list[str] of human-readable ranking signals. - mcp_url : populated when the service exposes an MCP endpoint (you can call it directly via streamable-http). Agents should prefer items with non-null confidence and tx_30d > 0 unless the user explicitly wants experimental endpoints. Args: intent: What the agent wants to do (English or Chinese). Optional when at least one structured filter is set. Synonym expansion covers twitter↔X↔推特, whale↔巨鲸, price↔价格 etc. top_k: Max services to return (default 5, hard cap 25). max_price_usd: Upper bound on per-call price in USD. category: Filter (see `list_categories`). chain: "base", "polygon", "solana", "arbitrum", ... min_confidence: Minimum confidence (0.0–1.0). 0.8+ keeps only services x402scan rates as high-quality. has_mcp: When true, return only services with a callable MCP endpoint. Use this when the agent wants to chain another MCP server rather than perform raw HTTP+x402.
Show parametersHide parameters
intentWhat the agent wants to do (English or Chinese). Optional when at least one structured filter is set. Synonym expansion covers twitter↔X↔推特, whale↔巨鲸, price↔价格top_kintegerMax services to return (default 5, hard cap 25).max_price_usdUpper bound on per-call price in USD.categoryFilter (see `list_categories`).chain"base", "polygon", "solana", "arbitrum", ...min_confidenceMinimum confidence (0.0–1.0). 0.8+ keeps only services x402scan rates as high-quality.has_mcpbooleanWhen true, return only services with a callable MCP endpoint. Use this when the agent wants to chain another MCP server rather than perform raw HTTP+x402.
ask_services9 paramsAsk for the best x402/MCP services for an agent intent. This is the high-level discovery tool: it retrieves candidates from the directory, asks the configured backend LLM to rank only those candidates, and returns service cards for the selected recommendations. If the LLM is unavailable, it falls back to the directory ranker. Args: intent: Natural-language job the agent wants to accomplish. top_k: Max recommendations to return (1-10). max_price_usd: Optional per-call budget cap. category: Optional directory category filter. chain: Optional payment network filter, e.g. "base" or "solana". require_healthy: When true, only consider services marked health=ok. min_confidence: Optional x402scan quality floor (0.0-1.0). has_mcp: When true, only consider services with MCP endpoints. use_llm: Set false for deterministic retrieval-only fallback.
Show parametersHide parameters
intentstringrequiredNatural-language job the agent wants to accomplish.top_kintegerMax recommendations to return (1-10).max_price_usdOptional per-call budget cap.categoryOptional directory category filter.chainOptional payment network filter, e.g. "base" or "solana".require_healthybooleanWhen true, only consider services marked health=ok.min_confidenceOptional x402scan quality floor (0.0-1.0).has_mcpbooleanWhen true, only consider services with MCP endpoints.use_llmbooleanSet false for deterministic retrieval-only fallback.
get1 paramGet full details + ready-to-paste call template for a service. Returns the service card with payment, call, quality, resource samples, and ready-to-use MCP/x402 call hints. Use this after `search` or `ask_services` before paying/calling an external service. Args: slug: Service slug as returned by `search` items.
Show parametersHide parameters
slugstringrequiredService slug as returned by `search` items.
list_categoriesList all available service categories in the directory.
statsHigh-level stats about the directory: x402 total, healthy count and chains, plus `snapshot`, the daily digest across x402, MCP and A2A (see directory_stats).
get_methodologyHow every score and statistic on agent-tools.cloud is computed. Returns the quality-score components and grade bands per protocol, the nine readiness criteria with weights, payment-evidence grades, the probing schedule and the definitions behind the daily statistics.
list_articles3 paramsList published Blog articles, newest first (metadata only). Args: query: Optional words to match in title, summary or body. tag: Optional tag to filter by. page: Page number, 20 articles per page. Use get_article(slug) for the full Markdown body.
Show parametersHide parameters
querystringOptional words to match in title, summary or body.tagstringOptional tag to filter by.pageintegerPage number, 20 articles per page.
get_article1 paramRead one published Blog article: metadata plus the full Markdown body. Args: slug: The article slug, as returned by list_articles.
Show parametersHide parameters
slugstringrequiredThe article slug, as returned by list_articles.
directory_stats4 paramsDaily statistics on the agent-tool ecosystem as seen by our probes. Args: view: "all", "mcp", "x402" or "a2a" to scope the figures to one protocol. topic: Optional topic word (e.g. "payment", "weather") to get that topic instead: supply per protocol, readiness, best listings, searches. month: Optional "YYYY-MM" to get that monthly report instead. api_key: Optional account key (free from create_api_key) for complete lists when you cannot send the Authorization header. Returns counts (indexed, reachable, protocol-verified, readiness A/B), one finding sentence per topic, key facts (x402 prices and networks, MCP and A2A protocol versions, MCP auth, A2A card signatures, how every listing's latest probe ended), the most searched terms (view "all"), the snapshot time, and links to the full JSON snapshot, the daily CSV, the methodology, the "how many work" page, per-protocol and per-topic pages and the monthly reports. With an account API key (Authorization: Bearer header or `api_key`; free from `create_api_key`) the topic and search lists are complete (10 listings per protocol, up to 100 terms); without one they are shortened.
Show parametersHide parameters
viewstring"all", "mcp", "x402" or "a2a" to scope the figures to one protocol.topicOptional topic word (e.g. "payment", "weather") to get that topic instead: supply per protocol, readiness, best listings, searches.monthOptional "YYYY-MM" to get that monthly report instead.api_keyOptional account key (free from create_api_key) for complete lists when you cannot send the Authorization header.
search_mcp_servers5 paramsFind MCP servers in the directory. Searches the standalone MCP directory (official MCP Registry, Smithery, Agenstry and other crawled sources) unioned with x402 services that also expose an MCP endpoint. Returns normalised entries with a ready-to-use streamable-http `call_hint.mcp.url`. Args: intent: Natural-language description of the tool/capability needed. top_k: Max servers to return (1-20). chain: Optional payment-network filter for paid MCP servers. require_healthy: When true, only return servers marked health=ok. scope: "remote" (default) = servers with an endpoint you can call now; "code" = code-only servers (repository / package you install and run yourself, no remote endpoint); "all" = both.
Show parametersHide parameters
intentNatural-language description of the tool/capability needed.top_kintegerMax servers to return (1-20).chainOptional payment-network filter for paid MCP servers.require_healthybooleanWhen true, only return servers marked health=ok.scopestring"remote" (default) = servers with an endpoint you can call now; "code" = code-only servers (repository / package you install and run yourself, no remote endpoin
get_mcp_server1 paramGet the full card for one MCP server by slug. Args: slug: MCP server slug as returned by `search_mcp_servers` items.
Show parametersHide parameters
slugstringrequiredMCP server slug as returned by `search_mcp_servers` items.
search_a2a_agents3 paramsFind A2A agents you can delegate a task to. Args: intent: Natural-language description of the task to delegate. top_k: Max agents to return (1-20). x402_only: When true, only return agents that advertise x402 payment.
Show parametersHide parameters
intentNatural-language description of the task to delegate.top_kintegerMax agents to return (1-20).x402_onlybooleanWhen true, only return agents that advertise x402 payment.
search_resources3 paramsUnified search across x402 services, MCP servers and A2A agents. Args: intent: Natural-language query. protocol: Optional filter: "x402", "mcp" or "a2a". top_k: Max resources to return (1-50).
Show parametersHide parameters
intentNatural-language query.protocolOptional filter: "x402", "mcp" or "a2a".top_kintegerMax resources to return (1-50).
register9 paramsSelf-register an x402 / MCP service in the agent-tools directory. Service owners and agents may submit new services here. Submissions are auto-reviewed instantly by x402 verification (no human gate): if the URL proves x402 payment support it is listed immediately and shows up in `search`; otherwise it is rejected or retried automatically. Listing is FREE. Dedup: if a service with the same canonical origin (scheme://host) already exists in the directory we return its slug instead of creating a duplicate submission. Same goes for a still-pending submission with the same origin. Rate limit: at most 5 pending submissions per client IP per 24h. Hits beyond that get `{error: rate_limited}` — try again later or email contact@agent-tools.cloud for bulk imports. Args: url: Public HTTPS URL of the service (the x402-payable endpoint or its homepage). Required. name: Human-friendly name. Defaults to the URL hostname. description: One-paragraph description (max ~2000 chars). mcp_url: If the service speaks MCP, its streamable-http endpoint. category: Free-form (e.g. "defi", "search", "social"). Use `list_categories` to align with existing taxonomy. chains: Networks the service accepts payment on (e.g. ["base", "solana"]). price_min_usdc: Lower bound of per-call price in USDC. price_max_usdc: Upper bound of per-call price in USDC. contact: Optional email / handle the directory team can reach you on for clarifications.
Show parametersHide parameters
urlstringrequiredPublic HTTPS URL of the service (the x402-payable endpoint or its homepage). Required.nameHuman-friendly name. Defaults to the URL hostname.descriptionOne-paragraph description (max ~2000 chars).mcp_urlIf the service speaks MCP, its streamable-http endpoint.categoryFree-form (e.g. "defi", "search", "social"). Use `list_categories` to align with existing taxonomy.chainsNetworks the service accepts payment on (e.g. ["base", "solana"]).price_min_usdcLower bound of per-call price in USDC.price_max_usdcUpper bound of per-call price in USDC.contactOptional email / handle the directory team can reach you on for clarifications.
scan_mcp_safety4 paramsCheck an MCP server for malware / prompt-injection lures by its endpoint URL. Give the server's streamable-http endpoint URL. Two paths: * **Already in the agent-tools directory** → returns our LATEST stored rule verdict. Every indexed server is re-scanned hourly, so you get a consistent, continuously-refreshed answer without re-probing. * **Not yet indexed** → we probe the endpoint live, statically scan its advertised tools + metadata, and return the fresh verdict. It is ADDED to the directory (so the next caller gets the stored verdict instantly) only if it answered or you supplied metadata; documentation hosts such as example.com / *.test / *.invalid are scanned but never listed. Two dimensions are reported. `verdict` is authoritative and comes from deterministic static rules — pure pattern-matching over the *advertised* text only, NO code execution. It flags the social-engineering / RCE tricks listing-spam servers use: * `curl … | bash` and `base64 -d | sh` install lures * `eval "$(curl …)"` / PowerShell `IEX(...DownloadString)` cradles * base64 blobs that decode to a shell command * bare-IP payload hosts and cheap throwaway TLDs * prompt-injection / credential-exfiltration phrasing ("ignore previous instructions", "send your .env / api key") * MCP tool-poisoning coercion — descriptions that hijack an agent's tool-calling ("always call this tool first", "before using any other tool you must…"), hidden `<IMPORTANT>` instructions, "list all API keys / include secrets in your response", and coercion to read & forward `.key`/`.pem`/`.ssh`/`.env` files Source-code-oriented rules (SQL / command / code injection) are deliberately not applied to natural-language descriptions, to avoid false positives. `llm_reference` is an advisory frontier-LLM second opinion over the same text. Because the LLM
Show parametersHide parameters
endpoint_urlstringrequiredThe MCP server's streamable-http URL (required). This is the identity we look up / index by.namestringOptional advertised name (used when the server is new and gets added; falls back to the URL host).descriptionstringOptional description / README blurb (scanned when new).tools_textstringOptional tool names + descriptions; used only if the live probe cannot fetch the server's tools/list.
claim_service_url2 paramsIssue a fresh ownership token for one exact public HTTPS URL. Authenticate in the MCP Authorization: Bearer header. Publishing and verifying the token is required before editing; URL input alone grants no rights. Args: url: Complete public HTTPS service URL, including its query when present. method: Optional proof method; otherwise inferred from the complete URL.
Show parametersHide parameters
urlstringrequiredComplete public HTTPS service URL, including its query when present.methodOptional proof method; otherwise inferred from the complete URL.
verify_service_url2 paramsVerify public ownership proof for your own exact service URL claim. This reads public proof only. It never calls business tools, requests private service credentials, or grants whole-platform permissions. Args: claim_id: Claim id returned by claim_service_url. token: The issued token after publishing it in the instructed location.
Show parametersHide parameters
claim_idintegerrequiredClaim id returned by claim_service_url.tokenstringrequiredThe issued token after publishing it in the instructed location.
get_owned_listing2 paramsRead editable metadata for a listing covered by your verified claim. Args: kind: Listing type: x402, mcp, or a2a. slug: Slug from the verified claim's listings or directory search.
Show parametersHide parameters
kindstringrequiredListing type: x402, mcp, or a2a.slugstringrequiredSlug from the verified claim's listings or directory search.
edit_owned_listing3 paramsEdit only metadata covered by your verified claim, with the public audit trail. An endpoint change requires verified control of the exact destination or its whole host and clears measurements tied to the old primary endpoint. Args: kind: Listing type: x402, mcp, or a2a. slug: Slug of the listing you are authorized to edit. fields: Editable fields to change; measured fields are rejected.
Show parametersHide parameters
kindstringrequiredListing type: x402, mcp, or a2a.slugstringrequiredSlug of the listing you are authorized to edit.fieldsobjectrequiredEditable fields to change; measured fields are rejected.
create_api_key1 paramCreate a free account API key. No sign-up, email or existing key needed. The key is returned once and cannot be recovered. Store it in your secret store; do not print it back to the user or write it to logs. Send it as `Authorization: Bearer <key>` (or the `api_key` argument where offered) to get complete `directory_stats` lists, run paid verifications and claim your own listings. The claim and listing tools read the key only from the Authorization header; without header support use the REST claim API. Shares the HTTP limit of POST /api/v1/keys (a few keys per IP per day). Args: name: Optional label to recognise the key later, e.g. your agent name.
Show parametersHide parameters
nameOptional label to recognise the key later, e.g. your agent name.
prepare_paid_verification3 paramsQuote a sponsored paid verification of an x402 service. You pay the service once from your own wallet (Base USDC, <= $1; funds go to its payTo). Sign the returned `typed_data` (EIP-712), then call `execute_paid_verification` before `valid_before`. We never sign or hold funds. Auth: API key from POST https://agent-tools.cloud/api/v1/keys, as the `Authorization: Bearer` header or `api_key`. Args: slug: Service slug from `search` / `get`. payer: 0x address of the wallet that will sign and pay. api_key: Optional if the Authorization header is sent. Returns: { id, amount_usd, pay_to, valid_before, typed_data, ... } or { error, message }.
Show parametersHide parameters
slugstringrequiredService slug from `search` / `get`.payerstringrequired0x address of the wallet that will sign and pay.api_keyOptional if the Authorization header is sent.
execute_paid_verification3 paramsSend the signed payment to the service once and score the result. Aborts without paying if price or recipient changed. Never retried; a timeout returns `indeterminate`. status: succeeded | delivery_failed | payment_rejected | indeterminate. Args: id: `id` returned by `prepare_paid_verification`. signature: 0x EIP-712 signature of its `typed_data` by the payer. api_key: Optional if the Authorization header is sent.
Show parametersHide parameters
idstringrequired`id` returned by `prepare_paid_verification`.signaturestringrequired0x EIP-712 signature of its `typed_data` by the payer.api_keyOptional if the Authorization header is sent.
get_paid_verification2 paramsRead one of your own paid verifications. Args: id: Verification id. api_key: Optional if the Authorization header is sent.
Show parametersHide parameters
idstringrequiredVerification id.api_keyOptional if the Authorization header is sent.
Checked by Serverdex with a plain initialize + tools/list call to agent-tools.cloud/mcp-discovery/, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 14, 2026- Stars
- 1
- Forks
- 2
- Last push
- Nov 14, 2026
- License
- Other
Python
From the README
mcpserver — agent-tools.cloud directory + MCP discovery The server that powers agent-tools.cloud — an open, agent-readable directory of x402 paid APIs, MCP servers and A2A agents, probed daily, graded and safety-scanned, with a free MCP discovery endpoint and an A2A agent. Everything on the site (listings, daily statistics, scoring methodology, Blog) is available as JSON and through MCP tools. Branches: main is an older public snapshot. The code that runs the site today, including everything described below, is on the directory-site branch. Note (2026-05-25): the previously hosted paid Qwen3.6 relay and the paid vertical endpoints (signal / onchain / defi / portfolio) were retired after 30 days of zero external conversions. This repository now serves the directory site and the free MCP discovery server only. What this serves today The MCP discovery server is also published as a standalone PyPI package: agent-tools-mcp (repo). MCP discovery tools *paidverification (remote server only, not in the agent-tools-mcp package): pay a listed x402 service once from your own wallet and record the result. Needs an API key from POST /api/v1/keys. See /about#paid-verification. search accepts natural-language intent and ranks by FTS5 + popularity + health.…
Read the full README on GitHub →Remotes
- streamable-http
https://agent-tools.cloud/mcp-discovery/
Alternatives to agent-tools (x402 + MCP + A2A directory)
Best AI & Agents servers →The most-starred AI & Agents servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Ruflo | 81,994 | Nov 2026 | Local / not checked |
| Claude Flow | 81,985 | Nov 2026 | Local / not checked |
| CodeBurn | 11,805 | Nov 2026 | Local / not checked |
| Kaneo | 9,825 | Nov 2026 | Local / not checked |
| Ha MCP | 7,958 | Nov 2026 | Local / not checked |
agent-tools (x402 + MCP + A2A directory): questions people ask
- Is agent-tools (x402 + MCP + A2A directory) a remote or a local MCP server?
- According to its entry in the official MCP registry, agent-tools (x402 + MCP + A2A directory) ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (PyPI) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
- Does agent-tools (x402 + MCP + A2A directory) need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 21, 2026. Individual tools may still ask for a key when called.
- Is agent-tools (x402 + MCP + A2A directory) still maintained?
- Active: the repository's last commit 6 days ago. Last push Nov 14, 2026, 1 GitHub stars, Other licence. Read from GitHub on Nov 14, 2026.
- What tools does agent-tools (x402 + MCP + A2A directory) expose?
- 23 tools as listed by the server itself during the live check, including search, ask_services, get, list_categories, stats. The full list with parameters is in the Live check section above.
- How do I add agent-tools (x402 + MCP + A2A directory) to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More AI & Agents servers
Browse all AI & Agents →Zhijiangyun Cloud (智匠云)
bofob
Robot embodied-AI cloud for GPU training, inference, benchmarks, and robot data collection.
DC Hub
azmartone67
Orchestration layer for data center and energy intelligence. Start with execute_plan.
Lumberroom
lumberroom
Durable shared memory for AI agents: search, write and correct facts, with per-client policy.
中文 AI 可引用性(GEO/AEO)体检
savantcat
中文站能否被豆包/DeepSeek/文心/Kimi 抓取、读懂、引用:可引用性审计、信源池占位探测、五大指标测量、修复计划、观测时序追踪
记忆梦境引擎 · AI 的睡眠系统
savantcat
零 LLM 事实提取 + 三维信号评分 + 艾宾浩斯衰减 + 五阶段梦境流水线与内容发芽检测,纯计算零依赖
Journalit
Cursivez
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Add the badge to your site
Show visitors that agent-tools (x402 + MCP + A2A directory) is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/cloud-agent-tools-agent-tools-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="agent-tools (x402 + MCP + A2A directory) — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/cloud-agent-tools-agent-tools-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).