How do I install SwapWallet?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does SwapWallet need an API key?

No required environment variable is listed on this record.

What transport does SwapWallet use?

SwapWallet is reached over HTTP.

When was SwapWallet last checked?

Last checked 2026-11-07. Crypto wallet: balances, P&L, history. Swaps, transfers and withdrawals need Telegram approval.

SwapWallet MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://swapwallet.app/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http app.swapwallet-mcp https://swapwallet.app/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "app.swapwallet-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://swapwallet.app/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Hosted by SwapWallet: there is nothing to install or run. Add the URL to any MCP client that supports remote servers, sign in once with OAuth, and pick what the assistant may do.

What you can ask
Nothing moves without your approval
Tools
Connect
Authentication and scopes
For agent developers
About this repository

What you can ask

"What's my total SwapWallet balance, and how much of it is USDT?"
"Show my profit and loss on BTC and TON."
"List my last 10 transactions from this week."
"Give me my USDT deposit address on TRON."
"Swap 50 USDT to TON." (creates a request you approve in Telegram)
"Withdraw 2,000,000 toman to my verified bank account." (creates a request you approve in Telegram)

Nothing moves without your approval

Read tools answer directly. Tools that would move money never do it themselves:

The assistant calls request_swap, request_transfer, request_crypto_withdraw or request_fiat_withdraw.
SwapWallet prices the action and sends you a preview in Telegram (the SwapWallet bot) with Approve and Cancel buttons.
Only when you tap Approve is the action re-priced and executed. Unanswered requests expire after 15 minutes.
The assistant checks the outcome with get_action_request.

There is no scope that lets an agent move funds without you: withdraw:execute exists and can never be granted. With two-factor authentication on, crypto withdrawals and transfers can't be requested over MCP at all; make those in the app.

Tools

Tool	What it does	Scope	Annotations
`get_total_balance`	Total portfolio value plus a per-token breakdown	`wallet:read`	read-only
`get_balance`	Balance and value of the given tokens	`wallet:read`	read-only
`get_user_info`	Profile, verification level, limits and settings	`wallet:read`	read-only
`get_deposit_address`	Deposit address for a token on a network (created if needed)	`wallet:read`	idempotent
`get_profit_and_loss`	Realized and unrealized P&L, all assets or chosen tokens	`portfolio:read`	read-only
`get_transactions`	Deposits, withdrawals, transfers and trades, newest first, with filters	`transactions:read`	read-only
`get_contacts`	Saved SwapWallet contacts, 10 per page	`contacts:read`	read-only
`get_ibans`	Verified bank accounts (IBANs) for toman withdrawals	`contacts:read`	read-only
`get_action_request`	Status of a request: `PENDING`, `EXECUTED`, `REJECTED`, `EXPIRED` or `FAILED`	any	read-only
`request_swap`	Prices a swap between two tokens and asks for approval	`swap:request`	needs approval
`request_transfer`	Transfer to one of your saved SwapWallet contacts	`transfer:request`	needs approval
`request_crypto_withdraw`	Crypto withdrawal to an external address	`withdraw:request`	needs approval, open world

Every tool ships MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). No tool is destructive: a request_* tool only adds a request that you approve or cancel. The full definitions, with input schemas, are in the server card at /.well-known/mcp/server-card.json.

Connect

Settings → Connectors → Add custom connector → URL https://swapwallet.app/mcp.

claude mcp add --transport http swapwallet https://swapwallet.app/mcp

Or install it as a plugin from this repository:

/plugin marketplace add SwapWallet/swapwallet-mcp
/plugin install swapwallet@swapwallet

Use the Add to Cursor button above, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "swapwallet": { "url": "https://swapwallet.app/mcp" }
  }
}

Use the Install in VS Code button above, or run:

code --add-mcp '{"name":"swapwallet","type":"http","url":"https://swapwallet.app/mcp"}'

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "swapwallet": { "serverUrl": "https://swapwallet.app/mcp" }
  }
}

gemini mcp add --transport http swapwallet https://swapwallet.app/mcp

Or as an extension, which also loads the agent rules in GEMINI.md:

gemini extensions install https://github.com/SwapWallet/swapwallet-mcp

codex mcp add swapwallet --url https://swapwallet.app/mcp

Add https://swapwallet.app/mcp as a remote Streamable HTTP server. The client discovers OAuth on its own from the 401 response.

Authentication and scopes

OAuth 2.1 with dynamic client registration (RFC 7591) and PKCE (S256); public clients, no secret, no API keys. You sign in on SwapWallet's consent page with your phone number and an SMS code, review the scopes, untick any you don't want, and approve. Revoke access any time from the app.

Scope	Grants
`wallet:read`	balances, account info, deposit addresses
`portfolio:read`	profit and loss
`transactions:read`	transaction history
`contacts:read`	saved contacts and verified IBANs
`swap:request`	request swaps (you approve in Telegram)
`transfer:request`	request transfers to saved contacts (you approve in Telegram)
`withdraw:request`	request crypto and toman withdrawals (you approve in Telegram)

tools/list returns only the tools your granted scopes allow, and scopes are checked again on every call. Access tokens last 1 hour; refresh tokens last until you revoke the grant.

Requirements: a SwapWallet account (sign up at swapwallet.app with a phone number; trading and withdrawals need identity verification), and a linked Telegram account for the request_* tools.

For agent developers

Endpoint https://swapwallet.app/mcp: Streamable HTTP, JSON responses only, stateless (no session, no SSE, no batches). Protocol versions 2025-06-18, 2025-03-26 and 2024-11-05.
Discovery: /.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server, and the server card.
Amounts are decimal strings; token and network are enums listed in each tool's input schema.
Never report a swap, transfer or withdrawal as done until get_action_request says EXECUTED. PENDING means "waiting for the user in Telegram". The full rules are in skills/swapwallet/SKILL.md.

Full reference: swapwallet.app/docs/mcp · REST API: docs.swapwallet.app

About this repository

The server runs inside SwapWallet's backend; this repository holds its public description and client configs, so you can install it from tools that work with repositories:

File	For
`server.json`	Official MCP Registry entry (`app.swapwallet/mcp`)
`.mcp.json`	Claude Code and other clients that read a project MCP config
`llms-install.md`	Step-by-step setup for agents that install servers themselves (Cline)
`.claude-plugin/`	Claude Code plugin and marketplace
`.codex-plugin/`	Codex plugin (same MCP server and skill)
`skills/swapwallet/`	Claude skill: how an agent should use the tools safely (ships with the plugin)
`gemini-extension.json`, `GEMINI.md`	Gemini CLI extension and its context file
`SECURITY.md`	How to report a vulnerability

Found an issue with the docs or a client config? Open an issue or a pull request.

About SwapWallet

SwapWallet (سواپ‌ولت) is an Iranian crypto exchange with a wallet-style app: buy, sell, swap, hold and send crypto, and deposit and withdraw toman. It is custodial, and is operated by Zanjireh Tabdil Soba. Web app, Android apps and a Telegram mini app.

Support: [email protected] · live chat
Privacy policy · Terms of service · Fees

Security

Please report vulnerabilities in the MCP server or the OAuth flow privately, as described in the security policy (security.txt), not in a public issue.

License

The contents of this repository are released under the MIT license.

SwapWallet

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install SwapWallet?

Does SwapWallet need an API key?

What transport does SwapWallet use?

When was SwapWallet last checked?

Documentation

Contents

What you can ask

Nothing moves without your approval

Tools

Connect

Authentication and scopes

For agent developers

About this repository

About SwapWallet

Security

License