Skip to main content

agent-tools-mcp

smithery badge MCP PyPI License

Discover agent-callable resources from any MCP-compatible agent (Claude, Cursor, Cline, Continue, …).

Backed by agent-tools.cloud, an open directory that indexes three kinds of agent-callable resources:

Resource What it solves Typical object
x402 service agent pays per call for an HTTP API /.well-known/x402, 402 endpoint, payTo
MCP server agent gains external tools & context Streamable-HTTP / stdio MCP servers
A2A agent agent delegates a task to another agent /.well-known/agent-card.json, A2A JSON-RPC

A2A tells agents who can do the job. x402 lets them pay for it. MCP gives them the tools to do it.

This is a discovery layer, not a facilitator — your agent keeps full custody of payment. The tools never auto-pay; they only find resources and return call templates. Call the stats tool for live counts across all three protocols.

Also listed on Smithery for one-click hosted install.

Tools

Tool What it does
search(intent, top_k, max_price_usd, category) Natural-language search across x402 paid services
get(slug) Full details (URL, price, call template) of an x402 service
list_categories() Browse x402 categories
search_mcp_servers(intent, top_k, chain) Find MCP servers by intent
get_mcp_server(slug) Full MCP server record (endpoint, transport, capabilities)
search_agents(intent, top_k, x402_only) Find A2A agents to delegate a task to
get_agent(slug) Full A2A agent card (endpoint, skills, auth, x402 info)
search_all(intent, protocol, top_k) Unified search across all three; each result tagged with protocol
stats() Directory size & health across x402 / MCP / A2A

Typical flow: start with search_all if you don't know which resource type fits, or go straight to the protocol-specific search (search / search_mcp_servers / search_agents), then call the matching get* tool for the full call template.

What agents get back (x402 example)

search() and get() return a normalised service record. For services hosted directly on agent-tools.cloud, every paid endpoint advertises the full x402 v2 extensions.bazaar block in its 402 challenge — including JSON Schema and a worked request body example — so the agent can call without trial-and-error:

// shape of get("agent-tools-cloud-signal-token")
{
  "slug": "agent-tools-cloud-signal-token",
  "endpoint": "https://agent-tools.cloud/v1/signal/token",
  "method": "POST",
  "price_usd": 0.01,
  "network": "base-mainnet",
  "asset": "USDC",
  "bazaar": {
    "info": {
      "input":  { "type": "http", "method": "POST", "bodyType": "json",
                  "body":   { "chain": "base", "token": "0x4200...0006" } },
      "output": { "type": "json",
                  "example": { "signal": "buy", "score": 0.78, "confidence": 0.62 } }
    },
    "schema": { "type": "object", "properties": { "body": { "properties":
                  { "chain": {"type":"string","enum":["base","ethereum","solana"]},
                    "token": {"type":"string"} },
                  "required": ["chain", "token"] } } }
  }
}

The response also passes through payment-required (challenge) and payment-response headers, both exposed via Access-Control-Expose-Headers so a browser-side fetch() (e.g. x402-fetch) can read them.

Third-party entries scraped from awesome-x402 / x402scan / x402.org, the MCP registry / PulseMCP, and public A2A agent-cards are passed through as-is and may or may not include full call metadata.

Quick Start

Claude Code CLI

claude mcp add agent-tools -- uvx agent-tools-mcp

Claude Desktop / Cursor / Cline

Add to your MCP config (~/.config/Claude/claude_desktop_config.json, ~/.cursor/mcp.json, …):

{
  "mcpServers": {
    "agent-tools": {
      "command": "uvx",
      "args": ["agent-tools-mcp"]
    }
  }
}

Remote (no install)

Most clients also accept a url-based remote MCP server (Streamable HTTP; the client must send Accept: application/json, text/event-stream):

{
  "mcpServers": {
    "agent-tools": { "url": "https://agent-tools.cloud/mcp-discovery/" }
  }
}

From source

pip install agent-tools-mcp        # or `uv tool install agent-tools-mcp`
agent-tools-mcp                    # stdio server, ready for an MCP client

Environment Variables

Var Default Purpose
AGENT_TOOLS_API_BASE https://agent-tools.cloud Point at a different deployment (e.g. self-hosted)
AGENT_TOOLS_LOG_LEVEL INFO Server log level (stderr only)
AGENT_TOOLS_HTTP_LOG_LEVEL WARNING httpx/httpcore log level

Debugging

# Probe with the official MCP Inspector
npx -y @modelcontextprotocol/inspector uvx agent-tools-mcp

# Or raw JSON-RPC
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | uvx agent-tools-mcp

License

Apache-2.0. See LICENSE.

Related

Metadata

Release files for agent-tools-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-tools-mcp 0.2.0
File Size Uploaded
agent_tools_mcp-0.2.0.tar.gz 9.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-tools-mcp 0.2.0
File Interpreter ABI Platform
agent_tools_mcp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.7 kB

Release files / agent_tools_mcp-0.2.0.tar.gz

Download URL agent_tools_mcp-0.2.0.tar.gz
Size 9.1 kB
Tags Source
SHA-256 checksum
How to use checksums
443b1fb7e7021099d7a2eec368501736315cf85e452c04106087d3594a0fa6f4
BLAKE2b-256 checksum
How to use checksums
58fe915cd2e8808f2df0439f81ff2d62da73d8070a210e323d2403c14eb1249f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / agent_tools_mcp-0.2.0-py3-none-any.whl

Download URL agent_tools_mcp-0.2.0-py3-none-any.whl
Size 8.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
eaa43ecf29c28053b78f59173169815601a308295c4a6b0993432c04d536b870
BLAKE2b-256 checksum
How to use checksums
dd71f151403a9bc52f728a413818e7e5f631bcb76d5518f7f0c9abad93f5b208
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page