agent-tools (x402 + MCP + A2A directory)
Discover x402 services, MCP servers and A2A agents by intent — agent-tools.cloud directory.
| Endpoint | https://agent-tools.cloud/mcp-discovery/ (streamable-http) |
|---|---|
| Registry version | 0.4.0 |
| Now | 14 tools · grade F (11) · pin ts_cb84f93a38bd1d5dd30b0b450db0267e · protocol 2025-06-18 |
| First / last listed | 2026-11-01 00:50 UTC / 2026-11-01 00:50 UTC |
| Grade over time | 2026-11-01: F (11), 14 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search ask_services get list_categories stats search_mcp_servers get_mcp_server search_a2a_agents search_resources register scan_mcp_safety prepare_paid_verification execute_paid_verification get_paid_verification
search | Find 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
r params: intent, top_k, max_price_usd, category, chain, min_confidence, has_mcp |
ask_services | Ask 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 age params: intent*, top_k, max_price_usd, category, chain, require_healthy, min_confidence, has_mcp, use_llm |
get | Get 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.
params: slug* |
list_categories | List all available service categories in the directory. params: none |
stats | High-level stats about the directory: total services, healthy count, sources. params: none |
search_mcp_servers | Find MCP servers in the directory.
Searches the standalone MCP directory (PulseMCP / official MCP registry
import) 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 params: intent, top_k, chain, require_healthy |
get_mcp_server | Get the full card for one MCP server by slug. params: slug* |
search_a2a_agents | Find 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.
params: intent, top_k, x402_only |
search_resources | Unified 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).
params: intent, protocol, top_k |
register | Self-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 serv params: url*, name, description, mcp_url, category, chains, price_min_usdc, price_max_usdc, contact |
scan_mcp_safety | Check 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 params: endpoint_url*, name, description, tools_text |
prepare_paid_verification | Quote 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 params: slug*, payer*, api_key |
execute_paid_verification | Send 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.
params: id*, signature*, api_key |
get_paid_verification | Read one of your own paid verifications.
Args:
id: Verification id.
api_key: Optional if the Authorization header is sent.
params: id*, api_key |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.