agent-utils-mcp 是一个面向 AI 智能体的“瑞士军刀”式实用工具服务器，通过 MCP（Streamable HTTP）和 REST API 两种方式对外提供 18 项工具。项目由 aparajithn 开发，代码托管在 GitHub，线上服务地址为 https://agent-utils-mcp.onrender.com。
用途 该项目旨在为 AI 智能体提供一组常用的基础工具能力，包括 JSON 校验、base64 编解码、哈希计算、UUID 生成、正则表达式测试、Markdown 转换、日期时间转换、cron 表达式解析以及 JWT 解码等。这些工具以 MCP 服务器和 REST API 的形式暴露，便于智能体在任务执行过程中直接调用。
主要能力
- 提供 18 项工具，覆盖数据校验、编码转换、哈希、标识符生成、正则测试、文本与时间格式转换、cron 解析和 JWT 解码等常见开发与运维场景。
- 同时支持 MCP（Streamable HTTP）和 REST API 两种接入方式。所有工具也可通过 REST 端点访问，路径格式为 /api/v1/{tool_name}。
- 提供 OpenAPI 文档（https://agent-utils-mcp.onrender.com/docs）、Google A2A 代理卡片（/.well-known/agent-card.json）、Smithery 服务器卡片（/.well-known/mcp/server-card.json）以及 OpenAPI 规范（/openapi.json）。
使用方式
- 在 MCP 客户端（如 Claude Desktop、Cursor、Windsurf）的 MCP 配置中添加该服务器即可使用。
- 也可直接调用 REST 端点 /api/v1/{tool_name}。
- 免费额度：每个 IP 每 24 小时可免费请求 100 次。
- 付费方式：超出免费额度后，服务器返回 HTTP 402 及机器可读的支付要求（x402 v1）。任何支持 x402 的客户端可自动支付并重试。价格约为每请求 0.001 USDC（Base 网络）。
- 手动支付：需在 X-Payment 请求头中附带 base64 编码的 JSON 信封，其中包含使用付款方 EIP-712 密钥签名的 EIP-3009 TransferWithAuthorization（Base 上的 USDC），金额需与要求完全一致，收款方为服务器钱包，且 nonce 未被使用。服务器会在处理请求前进行密码学验证（签名恢复以及金额、收款方、截止时间、重放检查）。
- 收款结算：设置 X402_SETTLER_PRIVATE_KEY 后，每笔已验证的支付会在数秒内上链执行，将 EIP-3009 transferWithAuthorization 提交至 Base 上的 USDC 合约，USDC 从付款方转入 X402_WALLET_ADDRESS。结算密钥无需是收款钱包的密钥，因为 EIP-3009 授权可由任意地址执行，因此可使用专用的仅用于 gas 的临时密钥提交，资金仍进入主钱包；该密钥只需在 Base 上持有少量 ETH 用于 gas。失败的结算会以指数退避重试；若全部重试失败，完整的支付授权会写入日志（CRITICAL），以便手动兑现，不会静默丢失支付。
技术栈与部署
- Python 3.11 + FastAPI + MCP SDK（Streamable HTTP）。
- 部署在 Render 上（自动扩缩容）。
适用场景 适合需要为 AI 智能体快速接入常用工具能力的开发者，尤其是在 MCP 生态中构建智能体应用时，可通过统一接口调用多种实用工具，并按使用量通过 x402 微支付进行计费。
限制
- 免费额度为每 IP 每 24 小时 100 次请求，超出后需付费。
- 付费使用 USDC（Base 网络），需要支持 x402 的客户端或手动构造支付头。
- 关于各工具的具体输入输出格式、参数细节及错误码，资料中暂未提供。
