“What’s my SwapWallet balance?”
get_total_balance
Total value
125,213,790IRT| Coin | Amount | Value in Toman |
|---|---|---|
 TetherUSDT | 184.2 | 47,081,336IRT |
 BitcoinBTC | 0.0021 | 44,740,596IRT |
 PAX GoldPAXG | 0.021 | 22,449,416IRT |
 ToncoinTON | 31 | 10,942,442IRT |
SwapWallet MCP Server Connect your AI assistant to your crypto wallet
From Claude, ChatGPT or any tool that speaks MCP, check your SwapWallet balances, profit and loss and transactions, and file swaps or withdrawals. No money moves until you approve it yourself.
Server URL
https://swapwallet.app/mcp- Claude
- ChatGPT
- Cursor
- Claude Code
- Gemini CLI
Check the latest Bitcoin news and tell me whether to hold my BTC
Web Search("bitcoin news this week")
Did 1 search in 2s
swapwallet - get_balance (MCP)(tokens: ["BTC", "USDT"])
{"balance":{"IRT":"91821932","USD":"359.24"},
"tokens":[{"token":"BTC","amount":"0.0021",…},…]}
"tokens":[{"token":"BTC","amount":"0.0021",…},…]}
swapwallet - get_profit_and_loss (MCP)(tokens: ["BTC"])
{"items":[{"token":"BTC","weightedAveragePrice":{"USD":"76410"},
"unrealizedProfitAndLossPercent":{"USD":"9.1"},…}]}
"unrealizedProfitAndLossPercent":{"USD":"9.1"},…}]}
News: nothing seriously bad about Bitcoin itself this week; most headlines are about money flowing into Bitcoin ETFs.
Your position: 0.0021 BTC, about 44.7 million Toman, up 9.1% on your average buy price.
If you’re holding long term, I see no reason to sell right away. It’s your call; this isn’t investment advice.
Buy more Bitcoin with 100 USDT
swapwallet - request_swap (MCP)(sourceToken: "USDT", destinationToken: "BTC", amount: "100")
{"requestId":48213,"type":"SWAP","status":"PENDING","approvalChannel":"telegram",…}
Request filed: 100 USDT for about 0.0012 BTC. It’s waiting in your Telegram for 15 minutes for your approval.
swapwallet - get_action_request (MCP)(requestId: 48213)
{"requestId":48213,"type":"SWAP","status":"EXECUTED",…}
Done. Your Bitcoin balance is now 0.0033 BTC.
🤖 Claude Code is asking to run this on your account:
🔄 Coin Swap Details
• Source Coin: 100 USDT
• Destination Coin: 0.0011971 BTC
✅ ApproveCancel
✅ Swap finalized successfully
10:42Manage your crypto with AI, in plain words
No tool names or commands to learn. Write what you want, from checking a balance to buying and selling, and the assistant works out which SwapWallet tool to use.
“Convert 100 of my USDT to Toman”
request_swap
Swap request
100 USDT→25,548,300IRT
Waiting for your approval in Telegram
I sent the request to your Telegram. You have 15 minutes to approve it.
“Check the latest Bitcoin news and tell me whether to hold my BTC”
Web searchget_balanceget_profit_and_loss
- News: nothing seriously bad about Bitcoin itself this week; most headlines are about money flowing into Bitcoin ETFs.
- Your position: 0.0021 BTC, up 9.1% on your average buy price.
- Bottom line: if you’re holding long term, I see no reason to sell right away. It’s your call.
The assistant searches the web for the news itself; the balance and P&L come from SwapWallet.
A few more to try; tap one to copy it:
Amounts are examples, priced at October 2026 rates.
The assistant can’t move your money on its own
The swap, transfer and withdrawal tools only file requests. Nothing happens until you tap Approve in Telegram, and the assistant has no access to your Telegram.
🤖 Claude is asking to run this on your account:
🔄 Coin Swap Details
• Source Coin: 100 USDT
• Destination Coin: 25,548,300 IRT
✅ ApproveCancel
✅ Swap finalized successfully
10:42The request
The assistant calls one of the request tools, say
request_swap, and SwapWallet works out the amount, rate and fee.A preview in Telegram
The SwapWallet bot sends you that message with Approve and Cancel buttons, in Telegram, where the assistant can’t reach.
Your decision
You have 15 minutes. If you do nothing, the request cancels itself.
Execution
Once you approve, the rate is quoted again and the action runs. The assistant checks the outcome with
get_action_requestand doesn’t say “done” before then.
- The “move funds without asking you” permission is always off and is never granted to any app.
- If two-factor authentication is on, crypto withdrawals and transfers can’t be filed from an assistant, only from the SwapWallet app itself.
- SwapWallet doesn’t see your chat with the assistant; only the name of the tool called and its inputs reach the server.
- You can cut off an assistant’s access from the SwapWallet app at any time.
You decide what the assistant can see
The first time an assistant connects to SwapWallet, this page opens: sign in with your mobile number and a text-message code, and untick any permission you don’t want. Change the ticks here to see which tools the assistant gets.
On the real page every box starts ticked; here only the read permissions are on.
What is MCP?
MCP (Model Context Protocol) is an open standard that AI assistants use to connect to other services. With SwapWallet’s MCP server, your assistant reads your SwapWallet account with your permission and files requests for you.
SwapWallet’s MCP server URL
https://swapwallet.app/mcpNothing to install: the server runs on SwapWallet itself, so you only give your assistant this URL.
Your assistantClaude, ChatGPT, Cursor
MCP
SwapWallet MCP serverswapwallet.app/mcp
Read
Your accountBalances, P&L, transactions
Swap & withdraw
Your TelegramRuns only after you approve
Connect Claude, ChatGPT and other assistants
All you need is a SwapWallet account. For swaps, transfers and withdrawals, the account must be linked to Telegram too.
Connect Claude to SwapWallet
Claude on the web and the desktop app
- In Claude, go to Settings › Connectors. Open Connectors
- Choose Add custom connector, name it SwapWallet and enter this URL:
https://swapwallet.app/mcp - Press Connect. SwapWallet’s sign-in page opens: sign in with your mobile number and the text-message code, then approve the permissions.
- Now ask in the chat: “What’s my SwapWallet balance?”
Connect ChatGPT to SwapWallet
ChatGPT on the web, on plans with custom connectors
- In ChatGPT, go to Settings › Apps & Connectors and turn on Developer mode under Advanced settings.
- Press Create. Name it SwapWallet, enter this URL as the MCP Server URL and set Authentication to OAuth:
https://swapwallet.app/mcp - Sign in on SwapWallet’s page and approve the permissions.
- Open a new chat, pick SwapWallet from the tools list and ask away.
ChatGPT moves these menus around now and then. If you can’t find Developer mode, search the settings for it.
Connect Cursor to SwapWallet
In one click, or with a config file
Add to CursorOr add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"swapwallet": {
"url": "https://swapwallet.app/mcp"
}
}
}The first time, Cursor opens SwapWallet’s sign-in page.
Connect Claude Code to SwapWallet
In the terminal, with one command
- Run:
claude mcp add --transport http swapwallet https://swapwallet.app/mcp - In Claude Code, run
/mcp, pick swapwallet and choose Authenticate to open SwapWallet’s sign-in page in your browser.
Or install it as a plugin. The plugin brings the SwapWallet skill along, which tells Claude never to report anything as “done” until you’ve approved it:
/plugin marketplace add SwapWallet/swapwallet-mcp
/plugin install swapwallet@swapwalletOther clients
Any client that supports remote (HTTP) MCP servers and OAuth sign-in
- VS Code (GitHub Copilot)
- Install in VS Code
code --add-mcp '{"name":"swapwallet","type":"http","url":"https://swapwallet.app/mcp"}' - Gemini CLI
gemini mcp add --transport http swapwallet https://swapwallet.app/mcp- Codex CLI
codex mcp add swapwallet --url https://swapwallet.app/mcp- Windsurf
In
~/.codeium/windsurf/mcp_config.json:{ "mcpServers": { "swapwallet": { "serverUrl": "https://swapwallet.app/mcp" } } }- Everything else
Add the URL as a Streamable HTTP server; the client discovers that sign-in is OAuth. Steps for Cline and other clients are in llms-install.md.
Or let the assistant install it
Claude Code, Codex, Cline and any agent that can run commands adds the server itself with this message:
Install the SwapWallet MCP server for me. Setup guide:
https://github.com/SwapWallet/swapwallet-mcp/blob/main/llms-install.mdFor developers
The server runs on SwapWallet’s own backend. Its description, plugins, the agent skill and ready-made client configs are on GitHub.
SwapWallet / swapwallet-mcpMIT
Official SwapWallet MCP server: AI agents read crypto balances, P&L and history, and request swaps, transfers and withdrawals the user approves in Telegram.
server.jsonFor the official MCP Registry.mcp.jsonReady-made config for Claude Code and other clientsskills/swapwallet/SKILL.mdA skill that teaches agents to use the tools safely.claude-plugin/A Claude Code plugin, bundling the skill.codex-plugin/A Codex plugingemini-extension.jsonA Gemini CLI extensionllms-install.mdSetup steps for agents that install servers themselves
- URL
https://swapwallet.app/mcp- Transport
- Streamable HTTP, JSON responses, stateless
- Auth
- OAuth 2.1 with dynamic client registration (RFC 7591) and PKCE; no API key
- Tokens
- Access token for one hour; refresh token until you revoke access
- Protocol versions
2025-06-18, 2025-03-26, 2024-11-05- Official registry
- app.swapwallet/mcp
| Tool | What it does | Permission |
|---|---|---|
get_total_balance | Total balance | View your balances |
get_balance | Balance of specific coins | View your balances |
get_user_info | Account details | View your balances |
get_deposit_address | Deposit address | View your balances |
get_profit_and_loss | Profit and loss | View your portfolio |
get_transactions | Transaction history | View your transactions |
get_contacts | Saved contacts | View your contacts |
get_ibans | Verified IBANs | View your contacts |
get_action_request | Check an approval request | Any |
request_swap | Request a swapneeds your approval | Ask you to approve a swap |
request_transfer | Request a transfer to another userneeds your approval | Ask you to approve a transfer |
request_crypto_withdraw | Request a crypto withdrawalneeds your approval | Ask you to approve a withdrawal |
request_fiat_withdraw | Request a Rial withdrawalneeds your approval | Ask you to approve a withdrawal |
- Full technical docsTools, inputs, statuses and the OAuth flow
- server-card.jsonThe MCP server card, with every tool
- ard.jsonThe Agentic Resource Discovery manifest, so agents find the server on their own
- GlamaThe server’s page on Glama
- API docsSwapWallet’s REST API, to build your own service
Frequently asked questions
What is MCP, and what does an MCP server do?
MCP (Model Context Protocol) is an open standard that AI assistants like Claude and ChatGPT use to connect to other services. A service’s MCP server offers what an assistant can do there as “tools”. SwapWallet’s MCP server does that for your SwapWallet account: with your permission, the assistant reads your balances, profit and loss and transactions, and files swap, transfer or withdrawal requests.
How do I connect Claude to the SwapWallet crypto exchange?
In Claude, go to Settings › Connectors, choose Add custom connector and enter https://swapwallet.app/mcp. When you press Connect, SwapWallet’s sign-in page opens: sign in with your mobile number and the text-message code, then approve the permissions. In Claude Code it takes one command.
Does ChatGPT work with SwapWallet too?
Yes. In ChatGPT, open Apps & Connectors, turn on Developer mode, create a new connector with https://swapwallet.app/mcp as its URL and set Authentication to OAuth. The option is only on ChatGPT plans that allow custom connectors.
Can I buy and sell crypto with AI?
Yes. Write what you want, for example “buy Bitcoin with 100 USDT”. The assistant files a swap request and its message, with the exact rate and amount, arrives in your Telegram. The trade runs only when you approve it there, at SwapWallet’s usual swap fee.
Can an AI assistant move my money without my permission?
No. The swap, transfer and withdrawal tools only file requests. Each request reaches your Telegram with every detail and runs only when you tap Approve; if you don’t answer within 15 minutes, it cancels itself. There is no permission to act directly, and none is ever given to an assistant.
Do I need an API key?
No. Sign-in is OAuth: you sign in on SwapWallet’s page with your mobile number and a text-message code, then approve the permissions. There is nothing to install either, since the server runs on SwapWallet itself. SwapWallet API keys don’t work with this server.
Does SwapWallet see my chat with the assistant?
No. Only the name of the tool the assistant called and its inputs reach SwapWallet’s server, never the chat itself. What the assistant reads from your account, like your balance, does go to that assistant’s provider, so grant only the permissions you need.
How do I limit or revoke an assistant’s access?
When you connect, you see the list of permissions and untick any you don’t want, for example keeping only balances and transactions. The assistant sees only the tools of the permissions you approved. You can revoke access from the SwapWallet app at any time.
Why won’t my assistant file a withdrawal or swap?
Your SwapWallet account must be linked to Telegram to file any request, since that’s where you approve it. With two-factor authentication on, crypto withdrawals and transfers to contacts can’t be filed from an assistant either; make those in the SwapWallet app. Swaps and Toman withdrawals don’t have that limit.
Does the SwapWallet MCP server cost anything?
No. Connecting and reading your data is free. A swap or withdrawal you approve costs SwapWallet’s usual fee.
Connect your assistant to SwapWallet
No account yet? It takes a few minutes. Then give your assistant the server URL and ask your first question.
More questions? Contact support