Surface Contract: platform API behavior and x402 pre-payment checks

dev.workers.penny-mcamp.penny-surface-contract由 penny-surface-contract.penny-mcamp.workers.dev 发布官方发布者v2026.10.22更新于 Oct 24, 2026

表面契约:API 行为证据、x402 预付款检查、MCP 服务器预检

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

Surface contracts: API behavior evidence, x402 pre-payment check, MCP server preflight

已验证Streamable HTTP可网页运行开发者工具

概览

Surface Contract: platform API behavior and x402 pre-payment checks 的托管 MCP 服务(penny-surface-contract.penny-mcamp.workers.dev),由 penny-surface-contract.penny-mcamp.workers.dev 发布;无需登录;Streamable HTTP;7 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

发布者
penny-surface-contract.penny-mcamp.workers.dev
端点
penny-surface-contract.penny-mcamp.workers.dev
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 Surface Contract: platform API behavior and x402 pre-payment checks,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.workers.penny-mcamp.penny-surface-contract%2Fsurface-contract/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "surface-contract-platform-api-behavior-a": {
      "type": "http",
      "url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}

工具

7

list_surface_contracts

List the platform surface contracts published in Penny's free registry, with claim counts.

无需输入参数。

get_surface_contract

Get the machine-readable surface contract for a platform host (read/write semantics, pending states, rate limits, limits, idempotency, pagination completeness, data portability), each claim carrying its evidence and its verification status.

输入参数id必填

verify_surface

Run the anonymous conformance checks for a contract now and return verified / failed / unknown / manual / unsupported per claim.

输入参数id必填

contribute_discrepancy

Report a platform behaviour that contradicts a published claim, or a new claim, with evidence. One-line call: POST /v1/contribute with {contractId, kind, statement, evidence[], reporter, observedAt}. Stored as pending; a published contract is never changed without independent verification. A contractId no published contract serves is accepted as a NEW-PLATFORM PROPOSAL: the 202 body carries contractExists:false (with proposal:true, proposedContractId and proposedHost), it is listed distinctly at GET /v1/contributions, and it stays pending until a second party reproduces it - it never creates or mutates a contract. A proposal filed by us reads selfProbe:true in that listing, and GET /v1/contributions counts proposals filed by non-self submitters separately from our own self-probes, so only the non-self number is outside coverage.

输入参数kind必填claimIdevidence必填reporterstatement必填contractId必填observedAt

get_integration_recipe

Get a plain-text integration recipe for a platform: the order of operations to use it, and a guard clause for every behaviour we measured going wrong, each naming the contract claim behind it. Derived from the contract, so it cannot drift from it.

输入参数id必填

preflight_mcp_server

Run the anonymous MCP handshake against ANY https MCP endpoint you name, right now, and get back a verdict (open / refused / unreachable / initialize-transport-error), the shape of any refusal body, whether the server is stateful (sets Mcp-Session-Id), how many tools tools/list returns, and the guard clauses that follow. Use it before wiring an MCP server into your own config. Pass `urls` (up to 5) to check a whole mcp.json in one call. When the endpoint refuses, it also reports whether the refusal advertises a credential path (an RFC 9728 resource_metadata pointer) and whether that pointer resolves to a metadata document naming an authorization server, so you learn where a token would come from without writing that parsing yourself. No credential is sent, none is obtained, and none of their tools is ever called.

输入参数urlurls

prepay_check

Check an x402 route BEFORE you pay it. GET /v1/prepay?url=<the route> makes ONE unpaid GET with no payment header and no credential, and returns one row: the measured HTTP status, the parsed x402 v2 challenge (scheme / network / asset / amount / payTo), whether that challenge is schema-valid exact-on-Base, and whether its payTo and price agree with the seller's own card (pass `card` to read that card with one more unpaid GET). No payment is made, no credential is sent, no redirect is followed, and a transport failure on our side is reported as unknown rather than as a fact about the seller. Use it to gate a payment decision on measured terms instead of on a seller's prose.

输入参数url必填card

版本历史

2
  1. v2026.10.22最新Oct 22, 2026
  2. v2026.10.13Oct 14, 2026

评分

已满足适用检查项的 72%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分

    请在注册中心条目中发布图标。

  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。