Surface Contract: platform API behavior and x402 pre-payment checks
MCP server of measured platform API behaviour, x402 pre-payment checks and MCP preflight
- Pricing
- Free
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 2026.10.22
- Listing updated
- 2 days ago
About Surface Contract: platform API behavior and x402 pre-payment checks
Surface Contract: platform API behavior and x402 pre-payment checks is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.
This service publishes machine-readable records of how platforms actually behave, so an agent need not discover a platform's limitations by losing actions to them. It holds 125 contracts, 109 of them measured by one anonymous test battery, and each claim is derived from requests that were really made. Reads are free, CC0 and need no authentication.
The MCP tools split into lookups and checks. Lookups return a contract, a plain-text card or an integration recipe that orders operations and adds a guard for each failure measured. verify_surface re-tests anonymous claims live. prepay_check makes one unpaid GET to a URL and reports the HTTP status, whether the x402 challenge is valid exact-on-Base and whether payTo and price match the seller's own card, without ever paying. preflight_mcp_server runs the same battery against any https MCP endpoint of yours.
There are also reports on the official MCP registry walk and an observed-versus-declared join. One route is payable: a portable verification credential for a named route costs 0.25 USDC via x402, charged only after the route has been measured. Anyone can submit discrepancies or confirmations, which stay pending until independently reproduced.
Install
Run in a terminal
claude mcp add --transport http surface-contract https://penny-surface-contract.penny-mcamp.workers.dev/mcpAdd to Settings → Connectors → Add custom connector
https://penny-surface-contract.penny-mcamp.workers.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"surface-contract": {
"url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"surface-contract": {
"type": "http",
"url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"surface-contract": {
"serverUrl": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"surface-contract": {
"type": "http",
"url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- list_surface_contracts
- List published surface contracts.
- get_surface_contract
- Fetch one surface contract.
- verify_surface
- Re-test a contract's anonymous claims live.
- contribute_discrepancy
- Submit a discrepancy or confirmation.
- get_integration_recipe
- Get an ordered integration recipe with failure guards.
- preflight_mcp_server
- Run the anonymous MCP test battery against an https endpoint.
- prepay_check
- Inspect an x402 challenge with one unpaid GET.
What it does
- Prepay check
- Inspects an x402 challenge with one unpaid request and never pays.
- MCP preflight
- Runs an anonymous test battery against any https MCP endpoint.
- Live claim verification
- Re-tests contract claims and reports verified, failed or unknown.
- Integration recipes
- Gives an ordered recipe with a guard for every measured failure.
- Portable credentials
- Serves measured routes with a sha256 and a re-runnable check.
- Public contributions
- Accepts discrepancies and confirmations as pending records.
Good for
- Check an x402 seller's challenge before sending money
- Test a new MCP server's behaviour against a standard battery
- Look up how a platform's API actually responds
- Paste a ready-made integration card into an agent's context
- Report a mismatch between a published contract and reality
Pricing
Free
Free CC0 reads; one credential route costs 0.25 USDC via x402
Prices change. Check penny-surface-contract.penny-mcamp.workers.dev before you buy.
Surface Contract: platform API behavior and x402 pre-payment checks FAQ
Does it cost anything?
Reads are free, CC0 and unauthenticated; only the credential-order route is payable, at 0.25 USDC per named route.
Will prepay_check spend money?
No. It makes one unpaid GET and never pays.
How many platforms are covered?
125 contracts, 109 measured by one anonymous battery.
Can I check my own MCP server?
Yes, by passing its https URL to the preflight tool or endpoint.
Is Surface Contract: platform API behavior and x402 pre-payment checks free?
Yes. Surface Contract: platform API behavior and x402 pre-payment checks is free to use.
How do I add Surface Contract: platform API behavior and x402 pre-payment checks to Claude Code?
Run this command in your terminal: claude mcp add --transport http surface-contract https://penny-surface-contract.penny-mcamp.workers.dev/mcp
What are the best alternatives to Surface Contract: platform API behavior and x402 pre-payment checks?
The closest alternatives to Surface Contract: platform API behavior and x402 pre-payment checks are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Surface Contract: platform API behavior and x402 pre-payment checks

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools