Catalog PyPI
PACKAGE EXPLORERView in registry

agent-tools-mcp

PyPI

Discover x402 paid services, MCP servers and A2A agents from any MCP-compatible agent (Claude, Cursor, Cline).

agentagent-toolscryptodirectorymcpmodel-context-protocolweb3x402
Versions collected1
Direct dependencies2From release 0.2.0
Last observed20 Oct, 23:34 UTC

README

Version 0.2.0 documentation

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:

ResourceWhat it solvesTypical object
x402 serviceagent pays per call for an HTTP API/.well-known/x402, 402 endpoint, payTo
MCP serveragent gains external tools & contextStreamable-HTTP / stdio MCP servers
A2A agentagent 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

ToolWhat 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

VarDefaultPurpose
AGENT_TOOLS_API_BASEhttps://agent-tools.cloudPoint at a different deployment (e.g. self-hosted)
AGENT_TOOLS_LOG_LEVELINFOServer log level (stderr only)
AGENT_TOOLS_HTTP_LOG_LEVELWARNINGhttpx/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.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.2.04 Jun 20262

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING
agenttools-cloud/agenttoolscollection

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 23:34 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:0a254875dc99d898a928bc8cce1abd0b900244c253c0b562b4f36866f0f394c4