Penniless Data Utilities

Penniless 数据工具

为 AI Agent 提供九种确定性数据和查询工具，按调用次数以 USDC 付费。 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

定价

每次调用 0.001 USDC。REST 支持原生 MPP 和 x402 v2（eip155:8453、方案 exact）；MCP 使用 x402 v2。

Base 上的 x402 结算由免费层级的 PayAI facilitator 验证。原生 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}	星标数、复刻数、未解决问题数、语言、许可证
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 授权、重试，并且仅在 facilitator 完成结算后才返回 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。生产环境还配置了加密的 Cloudflare 密钥 MPP_SECRET_KEY，仅用于验证 MPP 挑战。钱包私钥绝不会部署到 Worker。

维护者

GitHub： @danielarif26