TunaPay Pay
Your AI pays with a TunaPay prepaid card. You approve each payment in Telegram or on tunapay.ai.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http tunapay-pay 'https://tunapay.ai/gw/mcp'
{
"mcpServers": {
"tunapay-pay": {
"type": "http",
"url": "https://tunapay.ai/gw/mcp"
}
}
}
claude mcp add --transport http tunapay-pay 'https://tunapay.ai/gw/p/mcp' --header 'Authorization: <Bearer <your TunaPay plugin key>. Members create the key on the tunapay.ai member page and can revoke it anytime.>'
{
"mcpServers": {
"tunapay-pay": {
"type": "http",
"url": "https://tunapay.ai/gw/p/mcp",
"headers": {
"Authorization": "<Bearer <your TunaPay plugin key>. Members create the key on the tunapay.ai member page and can revoke it anytime.>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Frequently asked questions
What is TunaPay Pay?
Your AI pays with a TunaPay prepaid card. You approve each payment in Telegram or on tunapay.ai.
How do I install TunaPay Pay?
It runs as a remote server. In Claude Code: claude mcp add --transport http tunapay-pay 'https://tunapay.ai/gw/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does TunaPay Pay need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is TunaPay Pay open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains TunaPay Pay?
It is published by TUNAKINGRWA. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.