Metadata-Version: 2.4
Name: agent-tools-mcp
Version: 0.1.2
Summary: Search and call x402 paid services from any MCP-compatible agent (Claude, Cursor, Cline).
Project-URL: Homepage, https://agent-tools.cloud
Project-URL: Repository, https://github.com/JoursBleu/agent-tools-mcp
Project-URL: Issues, https://github.com/JoursBleu/agent-tools-mcp/issues
Project-URL: Registry, https://registry.modelcontextprotocol.io/
Author-email: JoursBleu <kangletian@hotmail.com>
License: Apache-2.0
License-File: LICENSE
Keywords: agent,agent-tools,crypto,directory,mcp,model-context-protocol,web3,x402
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# agent-tools-mcp

[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)
[![PyPI](https://img.shields.io/pypi/v/agent-tools-mcp)](https://pypi.org/project/agent-tools-mcp/)
[![License](https://img.shields.io/badge/License-Apache_2.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

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

Backed by [agent-tools.cloud](https://agent-tools.cloud), an open directory of 400+ x402 paid APIs (`awesome-x402`, `x402.org/ecosystem`, …).

## 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 |

## Quick Start

### Claude Code CLI

```bash
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`, …):

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

### Remote (no install)

Most clients also accept a `url`-based remote MCP server:

```json
{
  "mcpServers": {
    "agent-tools": { "url": "https://agent-tools.cloud/mcp/v2" }
  }
}
```

### From source

```bash
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

```bash
# 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](LICENSE).

## Related

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

<!-- mcp-name: io.github.JoursBleu/agent-tools-mcp -->
