How do I use agent-tools-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agent-tools-mcp search for image generation APIs under $0.10" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

agent-tools-mcp

MCP PyPI License

Discover and call x402 paid services from any MCP-compatible agent (Claude, Cursor, Cline, Continue, …).

Also listed on Smithery for one-click hosted install.

Backed by agent-tools.cloud, an open directory of 2,000+ x402 paid APIs (awesome-x402, x402scan, x402.org/ecosystem, …). Call the stats tool for live counts.

Tools

Tool	What it does
`search(intent, top_k, max_price_usd, category)`	Natural-language search across the directory
`get(slug)`	Full details (URL, price, call template) of a service
`list_categories()`	Browse categories
`stats()`	Directory size & health snapshot

What agents get back

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 are passed through as-is and may or may not include bazaar 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.

Directory site: https://agent-tools.cloud
x402 spec: https://x402.org
MCP spec: https://modelcontextprotocol.io

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

agent-tools-mcp

agent-tools-mcp

Tools

What agents get back

Quick Start

Claude Code CLI

Claude Desktop / Cursor / Cline

Remote (no install)

From source

Environment Variables

Debugging

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API