MCP client for AI agents — web utilities via x402 micropayments
Project description
x402-tools
MCP client for AI agents — web utilities via x402 micropayments.
No API keys. No accounts. No billing setup. Your wallet pays per call automatically.
Tools
| Tool | Price | Description |
|---|---|---|
fetch_url |
$0.001 | Convert a URL to clean markdown |
screenshot_url |
$0.002 | Screenshot a URL as PNG (base64) |
Setup
# 1. Generate a wallet and get your MCP config
uvx x402-tools-setup
# 2. Fund your wallet with testnet USDC (free)
# Follow the instructions from the setup wizard
# 3. Add the MCP config to Claude Code or Cursor
MCP Config
Add to ~/.claude/mcp.json (Claude Code) or Cursor MCP settings:
{
"mcpServers": {
"x402-tools": {
"command": "uvx",
"args": ["x402-tools-mcp"],
"env": {
"X402_TOOLS_API_URL": "https://your-agora-server.com",
"EVM_PRIVATE_KEY": "0xYourWalletPrivateKey"
}
}
}
}
Your agent gets two tools: fetch_url and screenshot_url. Payments happen automatically via x402.
Server
This package is the client only. For the API server, see Agora.
E2E Testing
With a running Agora server and a funded wallet:
EVM_PRIVATE_KEY=0x... X402_TOOLS_API_URL=http://localhost:4021 \
uv run python scripts/test_e2e.py
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file x402_mcp-0.1.0.tar.gz.
File metadata
- Download URL: x402_mcp-0.1.0.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
65c5956757f03094c375a334d7cd1411c1863223e3488e605bac97c5a15451b7
|
|
| MD5 |
e1620b123a2c3fbc3f603fd2ba207fc9
|
|
| BLAKE2b-256 |
e016cd93d46eb36ba63dc9c494b4d71c9d0454efd52c0895fbe7f9a34a004915
|
File details
Details for the file x402_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: x402_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3cc3321a1b113d75f0ace1f010f82b4cf3f043d1db83ccef44fdc6425d6118e9
|
|
| MD5 |
c6ad32c19e89e6c55946165bb9859aa4
|
|
| BLAKE2b-256 |
cbde5041408f73274a5346a159e11194dc77d807652a0d4b03adbba0d5a4fc15
|
