Agent Utils MCP

What aparajithn/agent-utils-mcp MCP server does

The aparajithn/agent-utils-mcp MCP server provides a collection of small, stateless utilities for agent workflows. Its 18 MCP tools cover structured data validation and formatting, encoding and hashing, identifier generation, URL and regex inspection, document conversion, time handling, text analysis, and tabular data conversion.

The tool set includes JSON validation, pretty-printing and minification; Base64 encoding and decoding; MD5, SHA-256, and SHA-512 hashing; UUID version 4 and version 7 generation; URL component parsing; regex matching; Markdown and HTML conversion; text counts and estimated reading time; URL-safe slug creation; timezone, format, and Unix timestamp conversion; cron descriptions and upcoming runs; unified text diffs; CSV/JSON conversion; and JWT payload decoding without signature verification.

How it works

The hosted deployment accepts MCP connections over Streamable HTTP at https://agent-utils-mcp.onrender.com/mcp. Claude Desktop, Cursor, and Windsurf can use that URL in their MCP configuration. Each operation is exposed as an MCP tool with a dedicated name such as tool_json_validate or tool_datetime_convert.

The same operations are available through REST at /api/v1/{tool_name}. Requests use JSON bodies, as shown by the documented examples for hashing, UUID generation, and date-time conversion. OpenAPI documentation is available at /docs, and the service publishes discovery metadata through agent-card and MCP server-card paths.

Setup and configuration

For a hosted MCP connection, add the following server entry to the client configuration:

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

The README also documents adding the service through Smithery with smithery mcp add aparajithn/agent-utils. No environment variables or credential values are specified in the provided material. The project is implemented with Python 3.11, FastAPI, and the MCP SDK, and is deployed on Render.

Tools and capabilities

Use the aparajithn/agent-utils-mcp MCP server for tasks such as:

• Checking whether generated or received text is valid JSON and formatting it for display.
• Encoding values, calculating supported hashes, or creating UUIDs.
• Extracting URL components, testing regular expressions, and producing text statistics.
• Converting Markdown to HTML or HTML to Markdown, then generating URL-safe slugs.
• Translating date-time values between timezones, formats, and Unix timestamps.
• Explaining cron schedules and returning a requested number of future runs.
• Comparing two text values with a unified diff.
• Converting CSV rows to JSON arrays and JSON arrays back to CSV.
• Inspecting a JWT payload when signature verification is not required.

Limitations and notes

JWT decoding is explicitly described as payload decoding without verification, so it should not be treated as an authentication or token-integrity check. The published service has a free allowance of 100 requests per IP per 24 hours. A paid x402 tier is listed at $0.001 per request in USDC as coming soon; the supplied material does not provide further payment or authentication configuration.

The repository is licensed under MIT. The hosted endpoint and REST paths are documented, but the provided material does not identify a separate package command for running the project locally.