README.md
Swiss-army-knife utility server for AI agents
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)
| 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 (coming soon)
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
Tools (18)
tool_json_validateValidate JSON string, return parsed or errortool_json_formatPretty-print or minify JSONtool_base64_encodeEncode string to base64tool_base64_decodeDecode base64 stringtool_hash_generateMD5, SHA256, SHA512 hashtool_uuid_generateUUID v4 or v7tool_url_parseParse URL into componentstool_regex_testTest regex pattern, return matchestool_markdown_to_htmlMarkdown to HTML conversiontool_html_to_markdownHTML to Markdown conversiontool_text_statsWord count, char count, reading timetool_slug_generateURL-safe slug from texttool_datetime_convertConvert between timezones/formats/Unix timestampstool_cron_parseHuman-readable cron description + next N runstool_diff_textUnified diff between two textstool_csv_to_jsonCSV to JSON array conversiontool_json_to_csvJSON array to CSV conversiontool_jwt_decodeDecode JWT payloadConfiguration
claude_desktop_config.json
{"mcpServers": {"agent-utils": {"url": "https://agent-utils-mcp.onrender.com/mcp"}}}Try it
→Validate this JSON string and fix any syntax errors: { 'name': 'test' }
→Convert this CSV data into a JSON array: name,age\nAlice,30\nBob,25
→Generate a SHA256 hash for the string 'hello world'
→What does the cron expression '0 0 * * *' mean and when are the next 3 runs?
→Convert this Markdown text to HTML: # Hello World