# 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. MCP server of measured platform API behaviour, x402 pre-payment checks and MCP preflight. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://penny-surface-contract.penny-mcamp.workers.dev
- **MCP Registry name:** dev.workers.penny-mcamp.penny-surface-contract/surface-contract
- **Categories:** finance and payments, legal and government, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http surface-contract https://penny-surface-contract.penny-mcamp.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://penny-surface-contract.penny-mcamp.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "surface-contract": {
      "url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "surface-contract": {
      "type": "http",
      "url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "surface-contract": {
      "serverUrl": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "surface-contract": {
      "type": "http",
      "url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/surface-contract-platform-api-behavior-and-x402-pre-payment
