utilsforagents-mcp
MCP server that bridges Claude Desktop (or any MCP-compatible client) to the pay-per-call utility endpoints on utilsforagents.com using the x402 payment protocol.
Tools
json-diff | POST /v1/diff | Structural JSON diff (RFC 6902) |
exif-summary | POST /v1/image/exif-summary | Extract EXIF metadata from JPEG |
scrub-metadata | POST /v1/image/scrub-metadata | Strip metadata from JPEG/PNG |
html-to-markdown | POST /v1/html/to-markdown | Convert HTML string to Markdown |
fetch-markdown | POST /v1/html/fetch-markdown | Fetch URL and convert to Markdown |
fetch-content | POST /v1/text/fetch-content | Fetch URL, auto-detect format, return Markdown |
url-metadata | POST /v1/url/metadata | Extract Open Graph, Twitter Card, meta tags |
Each call costs $0.003 USDC on Base, paid automatically via x402.
Prerequisites
- Node.js v20+
- An Ethereum wallet private key with USDC on Base (mainnet)
Quick start
npx utilsforagents-mcp
Claude Desktop configuration
Add to your Claude Desktop MCP config (claude_desktop_config.json):
{
"mcpServers": {
"utilsforagents": {
"command": "npx",
"args": ["utilsforagents-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x..."
}
}
}
}
Environment variables
EVM_PRIVATE_KEY | Ethereum private key (0x-prefixed) with USDC on Base | Yes |
RESOURCE_SERVER_URL | API base URL (default: https://utilsforagents.com) | No |
How it works
- Claude calls an MCP tool (e.g.
fetch-markdown)
- The MCP server POSTs to the utilsforagents.com endpoint
- The server returns HTTP 402 with payment requirements
@x402/axios automatically signs a USDC payment and retries
- The paid response is returned to Claude as tool output