Penniless Data Utilities

Penniless Data Utilities

AI エージェント向けの、呼び出しごとに USDC で支払う、決定論的なデータ処理・検索ツール 9 種です。 REST はネイティブ MPP と x402 の両方に対応しています。MCP は x402 v2 を使用します。アカウント、API キー、レート制限の段階設定はありません。どのツールも純粋な計算または認証情報不要の公開情報検索であり、別の AI モデルを呼び出すことはないため、結果は再現可能です。

• ライブエンドポイント（MCP）：https://penniless-json-repair.sjaman.workers.dev/mcp
• ライブエンドポイント（REST）：https://penniless-json-repair.sjaman.workers.dev
• ディスカバリー：/health、/openapi.json、/llms.txt、/.well-known/x402

料金

1 回の呼び出しにつき $0.001 USDC です。REST はネイティブ MPP と x402 v2（eip155:8453、スキーム exact）に対応しています。MCP は x402 v2 を使用します。

Base 上の x402 決済は、無料枠の PayAI ファシリテーターによって検証されます。ネイティブ MPP は mppx によってネゴシエートされます。受取先（payTo）：0x3D98800c64C345950E1eAaa076D88C12d1BF5F37。

MCP で接続する

ストリーミング可能な HTTP に対応する MCP クライアントなら、どれでも直接接続できます。

{
  "mcpServers": {
    "penniless-data-utilities": {
      "type": "http",
      "url": "https://penniless-json-repair.sjaman.workers.dev/mcp"
    }
  }
}

トランスポートはステートレスです。セッション ID は発行されず、必要もありません。また、各リクエストは独立しています。initialize と tools/list は無料です。未払いの tools/call は、x402 の支払い要求ペイロードを result.content[0].text（および result.structuredContent）に返します。署名済みの支払い情報を params._meta["x402/payment"] として添付し、呼び出しを再試行してください。

x402 対応の MCP クライアントを使用する場合は、@x402/mcp がこのやり取りを処理します。

ツール

MCP 名	REST パス	引数	戻り値
repair_json	POST /repair/json	{input}	修復済み JSON + 適用された修正内容
yaml_to_json	POST /yaml/tojson	{input}	解析済みの値 + 警告
cron_next_run	POST /cron/nextrun	{expr, after?}	次回の UTC 実行時刻
text_diff	POST /diff	{old, new, context?}	統合差分 + 件数
text_extract	POST /text/extract	{input, numbers?, codeBlocks?}	テキスト、タイトル、見出し、リンク、URL、メールアドレス
domain_whois	POST /domain/whois	{domain}	レジストラ、ステータス、有効期限、ネームサーバー、DNSSEC
dns_lookup	POST /dns/lookup	{domain, type?}	A/AAAA/CNAME/MX/TXT/NS/SOA/PTR/SRV/CAA の DoH 応答
github_repo_stats	POST /github/repo-stats	{repo}	スター数、フォーク数、オープン中の Issue 数、言語、ライセンス
email_validate	POST /email/validate	{email}	構文 + MX のライブ配信可能性

POST /diagnose は無料です。修復後の出力を返さず、不正な JSON ペイロードの問題を分類するため、呼び出し元は支払う前に、支払う価値があるかどうかを確認できます。

例（REST + x402 クライアント）

x402 v2 対応のクライアントなら、どれでも使用できます。リファレンスの TypeScript クライアントと viem アカウントを使用する例：

import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(key), networks: ["eip155:8453"] });
const pay = wrapFetchWithPayment(fetch, client);

const res = await pay("https://penniless-json-repair.sjaman.workers.dev/repair/json", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ input: "{foo: 'bar',}" }),
});
// -> { ok: true, repaired: { foo: "bar" }, applied: ["unquoted-keys","single-quotes","trailing-commas"] }

wrapFetchWithPayment は 402 の往復処理を行います。支払い要件を受け取り、USDC の承認に署名して再試行し、ファシリテーターによる決済完了後にのみ 200 を返します。

開発

npm install
npm test        # 133 tests, runs fully offline (facilitator + upstream are injected)
npx wrangler dev
npx wrangler deploy

環境変数（wrangler.toml で設定）：X402_NETWORK、X402_FACILITATOR、X402_PRICE、X402_PAY_TO。本番環境には、MPP チャレンジの認証にのみ使用する、暗号化済みの Cloudflare シークレット MPP_SECRET_KEY も設定されています。ウォレットの秘密鍵が Worker にデプロイされることはありません。

メンテナー

GitHub： @danielarif26