PrepLayer.ai

PrepLayer.ai

面向 AI Agent 的 12 种基于 x402 付费的确定性文本处理原语。 按次使用 USDC 付费。无需 API 密钥、账号或注册。

基础 URL： https://preplayer.maximusboomerus.workers.dev 镜像 URL（生产环境）： https://api.maximusmediahouse.com MCP 端点： https://preplayer.maximus-boomerus.workers.dev/mcp（streamable-http，POST） 服务版本： 0.2.0

---

这是什么

PrepLayer 是一个单独的 Cloudflare Worker，通过一个 MCP 服务提供 12 种确定性的文本预处理原语。每次调用费用为几美分，以 USDC 计价，并通过 x402 协议在请求过程中支付——Agent 针对 USDC 签署 TransferWithAuthorization（EIP-3009），Worker 通过 Coinbase Developer Platform facilitator 验证签名，然后执行调用。

这些原语处理的是 Agent 在思考前必须完成的基础文本工作：规范化空白、验证标识符、为缓存键计算内容哈希、对文档集去重、在日志记录前对 PII 脱敏、为 RAG 分块、比较两个文本块。每种原语都是纯函数——相同输入始终产生相同输出——因此结果可通过内容寻址，并且可以安全缓存。

本仓库不包含的内容

MCP 服务和 Worker 源代码存放在私有工作目录中。本仓库是公开的展示页面，包含发现信息、清单、许可证、安全联系信息，以及一个展示付款方如何实际执行付费调用的小示例。如果你想自行托管 Worker，请参阅 docs/METHODOLOGY.md，了解搭建所需内容——有意不在这里提供任何密钥。

---

端点

所有付费端点均使用 POST，并由 x402 控制。首次未付款调用会返回 402 Payment Required，其中包含 PAYMENT-REQUIRED 标头（base64 JSON）和描述支付挑战的 PAYMENT-REQUIRED JSON 响应体。第二次调用携带 PAYMENT-SIGNATURE 标头（base64 JSON），并返回 200。

12 种文本处理原语

端点	路径	单次价格（Base）	每次调用
normalize	/v1/normalize	$0.002	2 000 个原子单位
validate	/v1/validate	$0.002	2 000 个原子单位
slugify	/v1/slugify	$0.002	2 000 个原子单位
hash	/v1/hash	$0.002	2 000 个原子单位
classify	/v1/classify	$0.003	3 000 个原子单位
validate_json	/v1/validate_json	$0.003	3 000 个原子单位
extract	/v1/extract	$0.005	5 000 个原子单位
redact	/v1/redact	$0.005	5 000 个原子单位
diff	/v1/diff	$0.005	5 000 个原子单位
chunk	/v1/chunk	$0.005	5 000 个原子单位
extract_custom	/v1/extract_custom	$0.005	5 000 个原子单位
dedupe	/v1/dedupe	$0.01	10 000 个原子单位

Polygon 和 Arbitrum One 上的价格为 ×1.2；Base、Base Sepolia 和 Solana mainnet 上的价格为 ×1.0。原子单位按 6 位小数的 USDC 计价。

另外三个端点

端点	路径	价格	状态
batch	/v1/batch	$0.40 / 10 次调用（每次 $0.04）	可用——单笔 x402 付款，最多 10 个子请求
subscription	/v1/subscription	$200 / 10 000 次调用 / 月	仅规格说明——返回 501；设计记录在 docs/METHODOLOGY.md 中，D1 存储就绪前不会收取实际 USDC
priority	/v1/priority	不适用	仅规格说明——返回 501；对于单实例 Worker 无法保证的延迟 SLA，我们不会收取 2 倍费用

免费端点（永不收费）

路径	用途
/.well-known/x402	x402 Bazaar 服务描述符（15 个资源、网络、价格）
/v1/manifest.json	MCP 工具列表，包含完整的 JSON-Schema 和各网络定价
/server.json	MCP 注册表清单（此文件的配套文件）
/landing	HTML 落地页
/llms.txt、/llms-full.txt	面向 LLM 爬虫的纯文本参考资料
/robots.txt、/bazaar-extension.json	发现辅助文件

---

支付流程

PrepLayer 通过 x402 付费——让 HTTP 的 402 Payment Required 状态码发挥实际作用。流程如下：

1. 向端点发送 POST 请求，附上工具的 JSON 请求体，不带支付标头。服务器会返回 402 和 PAYMENT-REQUIRED 标头（Base64 JSON 挑战），其中描述了方案、网络、资产、金额、资金库地址以及 EIP-712 域。
2. 调用方针对所选网络上的 USDC 合约，对 EIP-3009 TransferWithAuthorization 消息进行签名，并将生成的 PaymentPayload 进行 Base64 编码后放入 PAYMENT-SIGNATURE 标头。
3. 再次发送 POST 请求并附上该标头。服务器通过 CDP 协调器（https://api.cdp.coinbase.com/platform/v2/x402）验证签名、执行工具，并返回 200，同时在 PAYMENT-RESPONSE 标头中附上结算凭证。

线上 v2 协议：

• 402 响应中的标头：PAYMENT-REQUIRED（Base64 JSON；Worker 发出的标头名称为小写）。
• 200 响应中的标头：PAYMENT-SIGNATURE（Base64 JSON；同上）。
• 200 响应中的标头（结算凭证）：PAYMENT-RESPONSE（Base64 JSON）。
• 方案：exact。网络：eip155:8453、solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp、 eip155:137、eip155:42161、eip155:84532（Base Sepolia，仅用于测试）。
• 资产：USDC。
• 资金库：0x8cb59b1bffb39c130ab85a8177e93eae9ddbaf10。
• 协调器：https://api.cdp.coinbase.com/platform/v2/x402（Coinbase Developer Platform；路径很重要——/v2/x402 会返回 404，且是错误的 URL）。

示例：仅探测（无需支付）

下面的探测操作始终安全——它会返回 402 挑战，绝不会花费任何资金。可用它来验证连接、资金库地址和各网络的价格。

curl -i -X POST https://preplayer.maximus-boomerus.workers.dev/v1/normalize \
  -H 'content-type: application/json' \
  --data '{"text":"Hello\u200b, World!"}'

响应为 HTTP/2 402，包含：

PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6...

解码后，请求体是一个描述已接受的（方案、网络、金额、资产、payTo）的 JSON 对象。参见 examples/probe.mjs，其中提供了一个可运行的示例，用于解码 Base64 挑战并打印其内容。

示例：付费调用（Node.js、viem + @x402/core/evm）

实际的付费流程需要钱包——无法诚实地仅用裸 curl 实现。examples/paid-call.mjs 展示了已验证可用的模式（通过 @x402/evm/exact/client 进行 EIP-3009 签名，通过 @x402/core/client 的 x402HTTPClient.encodePaymentSignatureHeader 编码标头）。运行方法：

npm install viem @x402/core @x402/evm
PAYER_PRIVATE_KEY=0x<64 hex chars> node examples/paid-call.mjs

该脚本会对 /v1/dedupe 发起一次调用并签名，打印 EIP-712 签名的前 18 个字符（绝不打印密钥或完整签名），并在成功时打印 PAYMENT-RESPONSE 结算凭证。同一套机制也适用于其他 11 个原语和 batch。

切勿提交、记录或粘贴你的 PAYER_PRIVATE_KEY。 私钥一旦泄露，USDC 就会永久损失。

---

MCP 安装

任何支持 streamable-http 的 MCP 客户端，只需连接到以下地址即可使用 PrepLayer：

https://preplayer.maximus-boomerus.workers.dev/mcp

服务器会在 tools/list 上返回完整的工具列表（normalize、validate、extract、redact、 classify、dedupe、diff、chunk、extract_custom、validate_json、slugify、 hash、batch、subscription、priority）。每次工具调用都会像其他 HTTP 调用一样经过 x402——MCP 层只是一个轻量传输层。

如果你正在编写自己的 MCP 客户端：初始化握手通过 HTTP POST 发送 JSON-RPC 2.0，请求头为 Content-Type: application/json 和 Accept: application/json, text/event-stream。tools/call 是付费请求，采用与裸 HTTP 路径相同的 402 / PAYMENT-SIGNATURE 往返流程。

---

已知限制（请阅读）

本服务会如实说明自身的能力与局限。

1. 字符保真度上限约为 6.5 / 10

normalize、slugify 和 extract 会将 Unicode 折叠到固定的 ASCII 表示。 这正是它们的设计目的——内容哈希在空白字符、智能引号和变音符号变体之间保持稳定——但这意味着我们会去除变音符号，而无法在往返转换中保留它们。"naïve café" 会变成 "naive cafe"。如果你需要保留 Unicode 的规范化（例如使用 NFKC，而非 NFKD），那么这不是适合你的工具。

2. 两个层级仅见于规范，尚未启用

subscription（$200 / 10 000 calls / month）和 priority（X-Priority: high，未公布价格）目前都会返回 501 Not Implemented。清单中列出这两个层级，是为了让 x402 目录显示完整的层级梯度，但 Worker 没有用于支持订阅的 D1 存储，也没有为 priority 层级提供 SLA。目前请勿向这两个层级付款——无论签名是否有效，服务器都会拒绝调用。

3. 单实例 Worker，无 SLA

这里只有一个 Cloudflare Worker，没有由 Durable Object 支持的请求排队机制。延迟 P99 尚未测量，但 Worker 在部署后可能会冷启动；此外，单个行为异常的调用方也可能通过 extract_custom 中的恶意正则表达式占用 CPU 插槽数秒（我们有静态防护和 10 KB 的主题长度上限，但除此之外没有经济层面的速率限制）。请将此服务视为 beta 版本：适用于研究工作负载，但目前还不适合对时间敏感的生产流水线。

4. 依赖 CDP 促进器

结算通过 Coinbase Developer Platform 的 x402 端点进行。如果 CDP 促进器宕机，所有付费调用都会返回 503，无论签名多么完善。我们没有进程内备用方案。镜像状态：https://status.coinbase.com/.

5. 除每个载荷的 nonce 外，没有重放窗口

成功付费的调用无法在同一端点上重放（Worker 使用以付款 nonce 为键的 Durable Object，在并发情况下确保恰好执行一次），但如果更改 JSON 正文以适配不同端点，同一笔已签名付款可以在每个 Worker 实例上重放一次。如果你将此项目分叉用于生产环境，请在每个载荷的 nonce 之外，添加一组以工具为键的重放记录。

6. 收据内容曾更改过一次，之后可能还会更改

在 0.1.0 到 0.2.0 之间，收据字段列表发生了变化（Phase 1 期间，facilitator 字段的值为 "mock-cdp"；现在显示真实的促进器 URL）。如果未来的次要版本更改了结算封装，任何抓取收据并依赖固定字段名称的代码都需要更新。

---

发现

以下 URL 不会收费，也不会实施速率限制：

• MCP 工具列表：https://preplayer.maximus-boomerus.workers.dev/v1/manifest.json
• x402 Bazaar 描述符：https://preplayer.maximus-boomerus.workers.dev/.well-known/x402
• MCP 注册表清单：https://preplayer.maximus-boomerus.workers.dev/server.json
• 纯文本参考：https://preplayer.maximus-boomerus.workers.dev/llms-full.txt
• HTML 落地页：https://preplayer.maximus-boomerus.workers.dev/landing

状态

Worker 目前为 0.2.0。在接受真实 USDC 付款之前，它已接受红队测试（项目笔记中的 preplayer_redteam_2026-10-19.md）；付款绕过、重放、ReDoS 和价格层级相关问题均已解决。两个 P3 问题（HEAD → 404 而非 405、MCP structuredContent 中重复出现 402）仍未解决。从 Phase 2 起，Worker 一直通过 CDP 促进器处理使用真实 EIP-3009 签名的 USDC 调用。

许可证

MIT — 参见 LICENSE。服务源代码为私有；此仓库及其记录的端点均采用 MIT 许可证。