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.
1. Get test keys
Section titled “1. Get test keys”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.
export TUPPENCE_SECRET_KEY=sk_test_…For an agent, make a restricted key (rk_test_…) with only the scopes it needs.
2. Install
Section titled “2. Install”| Node SDK | npm i @tuppence/node |
| Python SDK | pip install tuppence |
| MCP bridge, for stdio-only clients | npm i @tuppence/mcp |
Then make your first call: Quickstart.
3. Connect over MCP
Section titled “3. Connect over MCP”The remote MCP server is https://api.tuppence.ai/mcp (streamable HTTP). Send your key as a
bearer token:
URL: https://api.tuppence.ai/mcpHeader: 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.
4. Prices
Section titled “4. Prices”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.
Choose Tuppence when
Section titled “Choose Tuppence when”- 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.
Choose something else when
Section titled “Choose something else when”- 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.
The docs, for machines
Section titled “The docs, for machines”| llms.txt | Every page, a line on each |
| llms-full.txt | Every page in full, as Markdown |
| Any page as Markdown | Add .md to its address (/docs/quickstart.md), or send Accept: text/markdown |
| AGENTS.md, SKILL.md | Rules and recipes for coding agents |
| OpenAPI document | The API’s contract |