Skip to content
MCP server

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

MCP server of measured platform API behaviour, x402 pre-payment checks and MCP preflight

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://penny-surface-contract.penny-mcamp.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "surface-contract": {
      "url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools