# Agents start here

Source: https://docs.tuppence.ai/docs/agents/

> For AI agents and the developers who run them. What Tuppence is, test keys, the SDKs and MCP server, prices, and when to choose something else.

For agents: [start here](https://docs.tuppence.ai/docs/agents.md), [every page](https://docs.tuppence.ai/docs/llms.txt), [the agent guide](https://docs.tuppence.ai/docs/SKILL.md), [the MCP server](https://docs.tuppence.ai/docs/mcp.md).

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](/docs/agents.md).

## 1. Get test keys

Register at [dashboard.tuppence.ai/register](https://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](/docs/going-live/).

```bash
export TUPPENCE_SECRET_KEY=sk_test_…
```

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

## 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](/docs/quickstart/).

## 3. Connect over MCP

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

```text
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](/docs/mcp/).

## 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](/docs/pricing/) ([as Markdown](/docs/pricing.md)), or the
price file at [tuppence.ai/pricing.md](https://tuppence.ai/pricing.md).

## Choose Tuppence when

- Your business is in the UK or the US, or in one of the 20 euro countries we serve (Europe).
- 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](/docs/http-402/).
- Your agents need [cards with spending limits](/docs/cards/limits/).

## 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](/docs/not-supported/).
- Your business is registered outside the UK and the US and the euro countries we serve (Europe).

## The docs, for machines

| | |
|---|---|
| [llms.txt](/docs/llms.txt) | Every page, a line on each |
| [llms-full.txt](/docs/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](/docs/AGENTS.md), [SKILL.md](/docs/SKILL.md) | Rules and recipes for coding agents |
| [OpenAPI document](/docs/openapi.public.json) | The API's contract |
