About TunaPay Pay
TunaPay MCP lets AI assistants request online payments using a TunaPay prepaid USD Visa card. Each payment stays pending until approved by the user in Telegram or on tunapay.ai, then uses a one-time card.
Key features
- 01Check wallet balance and payment status
- 02Request one-time payment cards
- 03Request card recharges
- 04View card status and balances
- 05Retrieve details for unused cards
Use cases
- 01Approve a card for an online purchase
- 02Pay for a subscription with a one-time card
- 03Check whether a payment request is pending or complete
MCP support
The server exposes TunaPay wallet and card tools to MCP clients, including payment and recharge requests that require approval before funds move. It can connect remotely or run locally over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://tunapay.ai/gw/mcpclaude mcp add --transport http ai-tunapay-pay https://tunapay.ai/gw/mcp{"mcpServers":{"ai-tunapay-pay":{"type":"http","url":"https://tunapay.ai/gw/mcp"}}}Open in Cursor{"servers":{"ai-tunapay-pay":{"type":"http","url":"https://tunapay.ai/gw/mcp"}}}Open in VS Code{"mcpServers":{"ai-tunapay-pay":{"type":"http","url":"https://tunapay.ai/gw/mcp"}}}{"mcpServers":{"ai-tunapay-pay":{"serverUrl":"https://tunapay.ai/gw/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://tunapay.ai/gw/mcphttps://tunapay.ai/gw/p/mcpAuth requiredTools
Details
From the project READMETunaPay 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.