Developers and AI agents

Kartapay Data API.

Kartapay publishes its verified UK card-payment acquirer data as a read-only public API and as an MCP server for AI clients. The data is the same one behind the UK Card Acquirer Index: acquirer entity data (legal name, Companies House number, parent group, commercial model, onboarding language). The API is English only because it is a factual data layer, not localised content. No authentication, no personal data, released under CC BY 4.0.

REST endpoints

Base URL https://kartapay.co.uk/api. All responses are JSON with open CORS, an ETag and edge caching, and are rate-limited per IP. Full machine-readable contract: OpenAPI 3.1 spec.

MethodPathDescription
GET /api/acquirers List all tracked acquirers. Optional filters: ?q=, ?model=, ?language=Polish.
https://kartapay.co.uk/api/acquirers?model=payment-facilitator
GET /api/acquirers/{slug} Detail for one acquirer by its stable slug.
https://kartapay.co.uk/api/acquirers/sumup
GET /api/acquirers-snapshot Current snapshot: acquirer count, breakdown by model, and Polish / Romanian onboarding coverage.
https://kartapay.co.uk/api/acquirers-snapshot

MCP server

The same data is exposed as a remote Model Context Protocol server over streamable HTTP, so MCP-capable AI clients can read it directly.

  • Endpoint: https://kartapay.co.uk/mcp (JSON-RPC 2.0, POST)
  • Manifest: /.well-known/mcp.json
  • Resources: kp://dataset, kp://snapshot, kp://acquirers/{slug}
  • Tool: search_acquirers(query?, model?, language?)

Terms

Read-only and free under CC BY 4.0: attribute Kartapay and link back to the UK Card Acquirer Index. Every value originates in our verified acquirer dataset; legal entity fields are taken from Companies House records, which you can verify independently. Please cache responses and avoid abusive request rates.