Agent Utils MCP
Utility tools with x402 micropayments: JSON validation, base64, hashing, UUIDs, regex testing, Markdown and datetime conversion, cron parsing and JWT decoding.
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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-utilsTools (18)
| Tool | Description |
|---|---|
tool_json_validate | Validate JSON string, return parsed or error |
tool_json_format | Pretty-print or minify JSON |
tool_base64_encode | Encode string to base64 |
tool_base64_decode | Decode base64 string |
tool_hash_generate | MD5, SHA256, SHA512 hash |
tool_uuid_generate | UUID v4 or v7 |
tool_url_parse | Parse URL into components |
tool_regex_test | Test regex pattern, return matches |
tool_markdown_to_html | Markdown → HTML |
tool_html_to_markdown | HTML → Markdown |
tool_text_stats | Word count, char count, reading time |
tool_slug_generate | URL-safe slug from text |
tool_datetime_convert | Convert between timezones/formats/Unix timestamps |
tool_cron_parse | Human-readable cron description + next N runs |
tool_diff_text | Unified diff between two texts |
tool_csv_to_json | CSV → JSON array |
tool_json_to_csv | JSON array → CSV |
tool_jwt_decode | Decode JWT payload (no verification) |
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)
| Variable | Default | Purpose |
|---|---|---|
X402_WALLET_ADDRESS | (unset — paywall disabled) | Wallet that receives payments |
X402_PRICE_MICROUSD | 1000 ($0.001) | Price per request in USDC atomic units |
X402_NETWORK / X402_CHAIN_ID / X402_USDC_CONTRACT | base / 8453 / Base USDC | Payment network |
X402_MAX_TIMEOUT_SECONDS | 60 | Payment validity window |
RATE_LIMIT_FREE | 100 | Free requests per IP per 24h |
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.
| Variable | Default | Purpose |
|---|---|---|
X402_SETTLER_PRIVATE_KEY | (unset — verify only, no funds move) | Key that submits settlement transactions |
X402_RPC_URL | https://mainnet.base.org | Base JSON-RPC endpoint |
X402_SETTLE_MIN_MICROUSD | 0 (settle each payment immediately) | Batch payments until pending value reaches this |
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
Frequently asked questions
What is Agent Utils MCP?
Utility tools with x402 micropayments: JSON validation, base64, hashing, UUIDs, regex testing, Markdown and datetime conversion, cron parsing and JWT decoding.
How do I install Agent Utils MCP?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is Agent Utils MCP open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Agent Utils MCP?
It is published by aparajithn. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.