utilsforagents-mcp

utilsforagents-mcp

MCP server for https://utilsforagents.com. It exposes eight paid utility tools via x402 plus one free feedback tool for feature requests and usability issues. Paid calls can be signed with either a Base EVM wallet or a Solana wallet.

Available Tools

Tool	Endpoint	Cost	Description
json-diff	POST /v1/diff	$0.003	Compare two JSON values and return a structured diff
exif-summary	POST /v1/image/exif-summary	$0.003	Extract EXIF metadata from a base64-encoded JPEG image
scrub-metadata	POST /v1/image/scrub-metadata	$0.003	Strip metadata from a base64-encoded JPEG or PNG image
html-to-markdown	POST /v1/html/to-markdown	$0.003	Convert an HTML string to clean Markdown
fetch-markdown	POST /v1/html/fetch-markdown	$0.003	Fetch a public URL and convert its HTML to Markdown
fetch-content	POST /v1/text/fetch-content	$0.003	Fetch a public URL and extract readable text
url-metadata	POST /v1/url/metadata	$0.003	Extract title, Open Graph, Twitter Card, favicon, feeds, and canonical metadata
count-tokens	POST /v1/utilities/count-tokens	$0.003	Count tokens for LLM input using exact BPE or estimation
submit-feedback	POST /v1/feedback	free	Submit short product or feature feedback without x402 payment

Payment Model

Paid utility tools use the x402 protocol with USDC. On a paid call, the MCP server signs the payment challenge using the configured wallet and retries automatically. The API currently advertises payment requirements on Base and Solana mainnet. The submit-feedback tool is free and does not trigger x402 payment.

Because this package includes paid tools, you must provide at least one payer key: EVM_PRIVATE_KEY or SOLANA_PRIVATE_KEY.

Quick Start

npx utilsforagents-mcp

Configuration

Variable	Required	Description
EVM_PRIVATE_KEY	Conditionally	EVM private key for a wallet holding USDC on Base. 0x prefix is optional. Provide this or SOLANA_PRIVATE_KEY.
SOLANA_PRIVATE_KEY	Conditionally	Solana private key for a wallet holding USDC on Solana mainnet. Accepts base58, 0x hex, or a JSON byte array such as the contents of ~/.config/solana/id.json. Provide this or EVM_PRIVATE_KEY.
RESOURCE_SERVER_URL	No	Override the API base URL. Defaults to https://utilsforagents.com.

If both payer keys are present, the MCP server registers both payment schemes and lets the x402 client select the matching requirement returned by the API.

Claude Desktop

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

Config path:

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

To use Solana instead, replace EVM_PRIVATE_KEY with SOLANA_PRIVATE_KEY in the env block.

Wallet Setup

• Create or dedicate a low-balance wallet on Base or Solana.
• Fund it with a small amount of USDC on the matching network.
• Export the private key in a supported format.
• Set EVM_PRIVATE_KEY or SOLANA_PRIVATE_KEY before starting the MCP server.

Use a dedicated low-balance wallet for this package. Do not use a wallet that holds significant funds.

Links

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

License

MIT