Agent Tools — x402 MCP Directory

Free, agent-first MCP discovery layer for the x402 paid-service ecosystem.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • 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(
  • 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 th
  • 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

What data it sees

Do you need an account

No: the server works without sign-in

Free, agent-first MCP discovery layer for the x402 paid-service ecosystem. Aggregates 2,000+ x402 / MCP services crawled from awesome-x402, x402scan, x402.org/ecosystem and cdp-bazaar, refreshed every 6 hours.

Built so an autonomous agent can go from "I need to fetch tweets / check whale flows / get a price" to a paid, callable endpoint in seconds — no human in the loop.

Why it's different

  • Quality-scored ranking, not keyword soup. Every result carries an x402scan confidence score (0–1) and tx_30d (30-day real on-chain payment count). Results are ordered healthy + real-traffic first, with a human-readable match_reason so the agent knows why each service was picked.
  • LLM-powered recommendation. ask_services retrieves candidates, then has a backend LLM rank only those candidates and return ready-to-use service cards — gracefully falling back to the deterministic ranker if the LLM is unavailable.
  • Inspect before you pay. get returns a full service card with the exact endpoint, price, network, MCP URL, health, and a ready-to-paste MCP / HTTP-402 call template.

Tools

  • ask_services(intent, …) — LLM-ranked "just give me the best service for this job" recommendation.
  • search(intent | filters, …) — quality-ranked discovery (FTS5 + popularity + health), returns confidence, tx_30d, match_reason, mcp_url.
  • get(slug) — full service card + ready-to-paste call template.
  • list_categories() — browse the taxonomy.
  • stats() — live directory size & health snapshot.
  • register(url, …) — self-register a new x402 / MCP service (free, human-reviewed).

Free

No API key, no usage fees. Backed by agent-tools.cloud and the Apache-2.0 PyPI package agent-tools-mcp.

How to connect

How to connect Agent Tools — x402 MCP Directory to Claude

The server address to paste into Claude settings:

https://agent-tools-x402-directory--kangletian.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Agent Tools — x402 MCP Directory to ChatGPT

The server address to paste into ChatGPT settings:

https://agent-tools-x402-directory--kangletian.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Agent Tools — x402 MCP Directory to Cursor

The server address to paste into Cursor settings:

https://agent-tools-x402-directory--kangletian.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (6)

Raw names from tools/list. Only developers need these.

searchFind 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.
ask_servicesAsk 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.
getGet 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.
list_categoriesList all available service categories in the directory.
statsHigh-level stats about the directory: total services, healthy count, sources.
registerSelf-register an x402 / MCP service in the agent-tools directory. Service owners and agents may submit new services here. Submissions land in a pending queue and are reviewed by a human before they show up in `search` results. 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.