utilsforagents-mcp

MCP server for AI agents — connects to utilsforagents.com to provide high-speed utility tools: JSON diffing, HTML-to-Markdown conversion, EXIF extraction, image metadata scrubbing, and URL metadata extraction.

Every tool call costs $0.003 USD, paid automatically via the x402 protocol using USDC on Base (no API keys, no accounts — just a wallet).

Available Tools

| Tool | Description | |---|---| | json-diff | Compare two JSON values and return a structured diff (RFC 6902 ops, RFC 6901 pointers) | | exif-summary | Extract EXIF metadata from a base64-encoded JPEG image | | scrub-metadata | Strip all EXIF/XMP/ICC/IPTC metadata from a JPEG or PNG image, returns cleaned base64 | | html-to-markdown | Convert an HTML string to clean, readable Markdown | | fetch-markdown | Fetch a public URL and convert its HTML content to Markdown | | fetch-content | Fetch a public URL and extract readable text — auto-detects HTML, JSON, Markdown, or plain text | | url-metadata | Extract Open Graph, Twitter Card, favicon, canonical URL, and other page metadata from a URL | | count-tokens | Count tokens in text for LLM input — exact WASM BPE for OpenAI (cl100k_base, o200k_base), estimates for Claude/Gemini |

How Payment Works

This server uses the x402 protocol — a lightweight HTTP payment standard built on top of USDC on Base (Ethereum L2).

When you call a tool:

1. The server requests a $0.003 USDC micropayment from your wallet
2. The @x402/axios client signs the payment automatically using your EVM_PRIVATE_KEY
3. The API processes the request and returns the result

No subscriptions, no rate limits, no API keys. You only pay when you use it.

Your wallet needs a small amount of USDC on Base Mainnet (roughly $1 covers ~330 calls).

Quick Start

npx utilsforagents-mcp

Requires EVM_PRIVATE_KEY to be set in your environment (see Configuration below).

Configuration

Environment Variables

| Variable | Required | Description | |---|---|---| | EVM_PRIVATE_KEY | Yes | Hex private key of an EVM wallet holding USDC on Base (with or without 0x prefix) | | RESOURCE_SERVER_URL | No | Override the API base URL (defaults to https://utilsforagents.com) |

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "utilsforagents": {
      "command": "npx",
      "args": ["-y", "utilsforagents-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

The config file is located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Other MCP Clients

Pass EVM_PRIVATE_KEY as an environment variable to the npx utilsforagents-mcp process. The server communicates over stdio.

Getting a Wallet & USDC on Base

1. Create an EVM wallet (e.g. MetaMask, Coinbase Wallet)
2. Export the private key from your wallet settings
3. Bridge or buy a small amount of USDC on Base (a few dollars is plenty)
4. Set EVM_PRIVATE_KEY to the exported private key

Security: Use a dedicated low-balance wallet for this purpose. Never use a wallet that holds significant funds.

Links

• Website: https://utilsforagents.com
• OpenAPI spec: https://utilsforagents.com/openapi.json
• MCP Registry: https://registry.modelcontextprotocol.io (search: com.utilsforagents)
• Smithery: https://smithery.ai/servers/utilsforagents/utilsforagents-mcp

License

MIT

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

| Tool | Endpoint | Description | |---|---|---| | 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

| Variable | Description | Required | |---|---|---| | 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

1. Claude calls an MCP tool (e.g. fetch-markdown)
2. The MCP server POSTs to the utilsforagents.com endpoint
3. The server returns HTTP 402 with payment requirements
4. @x402/axios automatically signs a USDC payment and retries
5. The paid response is returned to Claude as tool output