Aparajithn/agent Utils

Agent Utils MCP Server 🛠️

AI エージェント向けの多機能ユーティリティサーバーです。MCP（Streamable HTTP）と REST API を通じて 18 個のツールを提供します。

稼働中: https://agent-utils-mcp.onrender.com

MCP クライアントに追加する

Claude Desktop / Cursor / Windsurf

MCP 設定に追加します：

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

Smithery

smithery mcp add aparajithn/agent-utils

ツール（18）

ツール	説明
tool_json_validate	JSON 文字列を検証し、パースした結果またはエラーを返します
tool_json_format	JSON を整形または最小化します
tool_base64_encode	文字列を base64 にエンコードします
tool_base64_decode	base64 文字列をデコードします
tool_hash_generate	MD5、SHA256、SHA512 ハッシュを生成します
tool_uuid_generate	UUID v4 または v7 を生成します
tool_url_parse	URL を構成要素にパースします
tool_regex_test	正規表現パターンをテストし、一致した箇所を返します
tool_markdown_to_html	Markdown → HTML
tool_html_to_markdown	HTML → Markdown
tool_text_stats	単語数、文字数、読了時間を表示します
tool_slug_generate	テキストから URL セーフなスラッグを生成します
tool_datetime_convert	タイムゾーン、形式、Unix タイムスタンプ間で変換します
tool_cron_parse	cron の説明をわかりやすく表示し、次の N 回の実行時刻を返します
tool_diff_text	2 つのテキスト間の統合 diff を表示します
tool_csv_to_json	CSV → JSON 配列
tool_json_to_csv	JSON 配列 → CSV
tool_jwt_decode	JWT ペイロードをデコードします（検証は行いません）

REST API

すべてのツールは /api/v1/{tool_name} の REST エンドポイントからも利用できます。

# 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 ドキュメント：https://agent-utils-mcp.onrender.com/docs

検出

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

料金

• 無料枠： IP あたり 24 時間ごとに 100 リクエスト
• 有料枠： x402 プロトコル — 1 リクエストあたり $0.001（USDC、Base ネットワーク）

x402 で支払う

無料枠を使い切ると、サーバーは機械可読な支払い要件（x402 v1）を含む HTTP 402 を返します。x402 対応クライアントは自動で支払いを行い、リクエストを再試行します：

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"})

または、支払いヘッダーを自分で付与します。X-Payment ヘッダーには、正確な料金で、サーバーのウォレット宛てに、未使用の nonce を指定し、支払者の EIP-712 キーで署名した EIP-3009 TransferWithAuthorization（Base 上の USDC）を含む、base64 エンコード済みの JSON エンベロープを設定する必要があります。リクエストを処理する前に、支払いは暗号学的に検証されます（署名の復元と金額、受取人、有効期限、リプレイのチェック）。

支払い設定（環境変数）

変数	デフォルト	用途
X402_WALLET_ADDRESS	(未設定 — ペイウォールは無効)	支払いを受け取るウォレット
X402_PRICE_MICROUSD	1000（$0.001）	USDC の最小単位でのリクエストあたりの料金
X402_NETWORK / X402_CHAIN_ID / X402_USDC_CONTRACT	base / 8453 / Base USDC	支払いネットワーク
X402_MAX_TIMEOUT_SECONDS	60	支払いの有効期間
RATE_LIMIT_FREE	100	IP あたり 24 時間ごとの無料リクエスト数

収益の回収（オンチェーン決済）

X402_SETTLER_PRIVATE_KEY を設定すると、検証済みの各支払いは数秒以内にオンチェーンで実行されます。EIP-3009 の transferWithAuthorization が Base 上の USDC コントラクトに送信され、USDC が支払元から X402_WALLET_ADDRESS に移動します。セッターキーは受取ウォレットのキーである必要はありません。EIP-3009 の認可は任意のアドレスで実行できるため、専用のガス代専用バーンキーで送信し、資金をメインウォレットに入金できます。必要なのは、ガス代に使う少額の ETH 残高だけです。

変数	デフォルト	用途
X402_SETTLER_PRIVATE_KEY	(未設定 — 検証のみ、資金は移動しません)	決済トランザクションを送信するキー
X402_RPC_URL	https://mainnet.base.org	Base の JSON-RPC エンドポイント
X402_SETTLE_MIN_MICROUSD	0（各支払いを即時に決済）	保留中の金額がこの値に達するまで支払いをまとめます

決済に失敗した場合は、指数バックオフで再試行されます。すべての再試行に失敗すると、支払い認可の全内容がログに記録され（CRITICAL）、手動で引き換えられるため、支払いが知らないうちに失われることはありません。

技術スタック

• Python 3.11 + FastAPI + MCP SDK（ストリーミング可能な HTTP）
• Render にデプロイ（自動スケーリング）
• GitHub：https://github.com/aparajithn/agent-utils-mcp

ライセンス

MIT