---
title: "MCP surface (JSON-RPC: initialize, tools/list, tools/call)"
method: POST
path: "/mcp"
---

# MCP surface (JSON-RPC: initialize, tools/list, tools/call)

`POST /mcp`

## Request

- Base URL: `https://api.whitemagic.dev`
- URL: `https://api.whitemagic.dev/mcp`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-WM-Key`
  - API key in header `X-PAYMENT`

Tools: verify_bundle, verify_anchor, get_revocations. Discovery methods are keyless; tools/call requires a key or x402 payment.

## Request body

- object
  - `jsonrpc` '2.0', required
  - `id` unknown
  - `method` string, required
  - `params` object

## Response `200`

JSON-RPC response

- object

## Other responses

- `401`: missing or invalid key
- `402`: x402 payment required (challenge body)
- `429`: Daily cap reached (Retry-After: 86400; X-RateLimit-* report the bucket)

---

[API](https://skmtc.dev/whitemagic/apis/whitemagic-receipt-verification-api.md) · [All operations](https://skmtc.dev/whitemagic/apis/whitemagic-receipt-verification-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whitemagic/apis/whitemagic-receipt-verification-api/revisions/92a4341eb473?raw)