Agent Utils MCP

Agent Utils MCP Server 🛠️

A Swiss-army-knife utility server for AI agents — 18 tools via MCP (Streamable HTTP) + REST API.

Live at: https://agent-utils-mcp.onrender.com

Add to Your MCP Client

Claude Desktop / Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "agent-utils": {
      "url": "https://agent-utils-mcp.onrender.com/mcp"
    }
  }
}

Smithery

smithery mcp add aparajithn/agent-utils

Tools (18)

REST API

All tools also available as REST endpoints at /api/v1/{tool_name}.

# Hash a string
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/hash_generate \
  -H "Content-Type: application/json" \
  -d '{"text": "hello world", "algorithm": "sha256"}'

# Generate UUID
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/uuid_generate \
  -H "Content-Type: application/json" \
  -d '{"version": 4}'

# Convert datetime
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/datetime_convert \
  -H "Content-Type: application/json" \
  -d '{"dt_string": "2025-01-01 12:00", "from_tz": "UTC", "to_tz": "America/New_York"}'

OpenAPI docs: https://agent-utils-mcp.onrender.com/docs

Discovery

• Google A2A: /.well-known/agent-card.json
• Smithery: /.well-known/mcp/server-card.json
• OpenAPI: /openapi.json

Pricing

• Free tier: 100 requests per IP per 24 hours
• Paid tier: x402 protocol — $0.001/request in USDC (Base network)

Paying with x402

When you exhaust the free tier, the server replies with HTTP 402 carrying machine-readable payment requirements (x402 v1). Any x402-aware client pays and retries automatically:

from x402_fetch import x402_fetch  # pip install x402-fetch
response = x402_fetch("https://agent-utils-mcp.onrender.com/api/v1/hash_generate", method="POST",
                      body={"text": "hello", "algorithm": "sha256"})

Or attach the payment header yourself: the X-Payment header must be a base64-encoded JSON envelope containing an EIP-3009 TransferWithAuthorization (USDC on Base) signed with the payer's EIP-712 key for the exact price, addressed to the server's wallet, with an unused nonce. Payments are verified cryptographically (signature recovery + amount/recipient/deadline/replay checks) before the request is served.

Payment configuration (environment variables)

Collecting revenue (on-chain settlement)

With X402_SETTLER_PRIVATE_KEY set, every verified payment is executed on-chain within seconds: the EIP-3009 transferWithAuthorization is submitted to the USDC contract on Base and the USDC moves from the payer to X402_WALLET_ADDRESS. The settler key does not need to be the receiving wallet's key — EIP-3009 authorizations can be executed by any address, so a dedicated gas-only burner key can do the submitting while the funds land in your main wallet. It only needs a small ETH balance on Base for gas.

Failed settlements are retried with exponential backoff; if all retries fail, the full payment authorization is written to the logs (CRITICAL) so it can be redeemed manually — no payment is silently lost.

Tech Stack

• Python 3.11 + FastAPI + MCP SDK (Streamable HTTP)
• Deployed on Render (auto-scaling)
• GitHub: https://github.com/aparajithn/agent-utils-mcp

License

MIT