TunaPay MCP

Let your AI assistant pay online with a TunaPay prepaid USD Visa card, while you stay in control of every cent.

Works with Claude (desktop and web), Claude Code, Cursor, and any client that speaks the Model Context Protocol.

How it keeps your money safe

You approve every payment. The AI can only create a pending request. Nothing is charged until you tap approve in Telegram or on tunapay.ai. Requests expire after 10 minutes.
One card per purchase. Each approved request opens a one-time card loaded with exactly the amount needed. It freezes itself after that one payment.
Your wallet, your cards. Money only moves from your own TunaPay wallet onto your own card. The plugin cannot send crypto or pay another person.
Your key, revocable anytime. You create a personal plugin key on the tunapay.ai member page and can revoke it with one click.

1. Get a key

Sign up at tunapay.ai and top up your wallet.
Open the member page, go to AI payment plugin, and create a plugin key (it starts with tpk_).

The plugin is available to TunaPay membership-tier members.

2. Connect your AI

Claude (desktop or claude.ai): no key copying needed

Settings → Connectors → Add custom connector, paste:

https://tunapay.ai/gw/mcp

Claude opens the TunaPay approval page; sign in and click Allow.

Claude Code

claude mcp add --transport http tunapay https://tunapay.ai/gw/p/mcp --header "Authorization: Bearer tpk_YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tunapay": {
      "url": "https://tunapay.ai/gw/p/mcp",
      "headers": { "Authorization": "Bearer tpk_YOUR_KEY" }
    }
  }
}

Run it locally instead (stdio)

This repository is a zero-dependency local server (Node.js 18+) that talks to the same TunaPay API. Use it with any client that launches local MCP servers:

{
  "mcpServers": {
    "tunapay": {
      "command": "npx",
      "args": ["-y", "github:tunakingrwa/tunapay-mcp"],
      "env": { "TUNAPAY_KEY": "tpk_YOUR_KEY" }
    }
  }
}

Tools

Tool	What it does	Moves money?
`wallet`	Wallet balance and how approvals reach you	No
`find_card`	Which card has actually been charged successfully at a given merchant	No
`list_cards`	Your cards (last 4 digits, status, balance), never full numbers	No
`request_new_card`	Ask you to approve a one-time card for one purchase	Only after you approve
`request_recharge`	Ask you to approve topping up one of your cards	Only after you approve
`check_request`	Status of a request (pending, done, expired…)	No
`get_card_details`	Card details of an unused one-time card this plugin opened, to fill a checkout	No

Example

"Buy me one month of Cursor Pro."

The AI checks which card works at Cursor and asks for a one-time card of $20.
You get a Telegram message and tap Approve.
The AI fills the checkout with the one-time card. The card freezes after the payment.

Notes

Cards work for subscriptions and normal online purchases. They cannot top up developer API credit balances (for example the OpenAI or Anthropic consoles).
Never paste your plugin key into a chat. If a key leaks, revoke it on the member page and create a new one.
Questions: tunapay.ai

License

MIT

TunaPay Pay

PLUG IN

README