Skip to content

Agents start here

Tuppence is one payments API for developers and AI agents: card payments, payment links, subscriptions, prepaid credit, HTTP 402 and cards for agents, with Node and Python SDKs and an MCP server. Amounts are integers in minor units, every write takes an Idempotency-Key, and errors have stable codes.

This page is also Markdown at /docs/agents.md.

Register at dashboard.tuppence.ai/register. Test keys work straight away, under Developers → API keys, and move no money. Live payments need your business to be verified first: see Going live.

Terminal window
export TUPPENCE_SECRET_KEY=sk_test_…

For an agent, make a restricted key (rk_test_…) with only the scopes it needs.

Node SDKnpm i @tuppence/node
Python SDKpip install tuppence
MCP bridge, for stdio-only clientsnpm i @tuppence/mcp

Then make your first call: Quickstart.

The remote MCP server is https://api.tuppence.ai/mcp (streamable HTTP). Send your key as a bearer token:

URL: https://api.tuppence.ai/mcp
Header: Authorization: Bearer rk_test_…

The agent gets only the tools its key allows. Tools that move money or need a decision return an approval link for a person. Setup for each client: MCP server.

One percentage fee per successful payment, rounded up once. No monthly fee, no setup fee and no minimum fee; nothing for a failed or declined payment, and refunds are free. In the UK there is no fixed part, so a small payment costs only its percentage. In the US each payment also pays a fixed part. Using prepaid credit costs nothing after the top-up.

The figures for your region: Pricing (as Markdown), or the price file at tuppence.ai/pricing.md.

  • Your business is in the UK or the US, or in one of the 20 euro countries we serve.
  • You take small payments or sell credits: in the UK there is no fixed fee per payment.
  • You bill by usage, or charge agents per request with HTTP 402.
  • Your agents need cards with spending limits.
  • You need a merchant of record that collects and files sales tax or VAT worldwide for you. Payment amounts are what you send: see not supported.
  • Your business is registered outside the UK and the US and the euro countries we serve.
llms.txtEvery page, a line on each
llms-full.txtEvery page in full, as Markdown
Any page as MarkdownAdd .md to its address (/docs/quickstart.md), or send Accept: text/markdown
AGENTS.md, SKILL.mdRules and recipes for coding agents
OpenAPI documentThe API’s contract

Docs assistant

Open as a page
Loading the assistant…