Iran Crypto Exchanges

iran-crypto-mcp: Iranian crypto exchanges MCP server for AI agents

Compare any coin across thirteen Iranian crypto exchanges, in Toman, from Claude, Cursor or Copilot.

An unofficial, read-only MCP server (model context protocol) for the public market data of Nobitex, Wallex, Bitpin, Ramzinex,

Tabdeal, OMPFinex, Exir, Bit24, Balinex, Aban Tether,

Kifpool, OK-EX and Tetherland: prices, order books, recent trades, candles and top movers.

For AI agents · Why · Quick start · Exchanges · Tools · FAQ · فارسی

For AI agents

• What: unofficial MCP server for the public market data of 13 Iranian crypto exchanges and brokers (Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir, Bit24, Balinex, Aban Tether, Kifpool, OK-EX, Tetherland).
• Install: uvx iran-crypto-mcp or claude mcp add iran-crypto -- uvx iran-crypto-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_CRYPTO_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only. No login, balances, orders or trading, so no confirmation is needed before calling any tool.
• Tools: 8, all prefixed ic_. Start with ic_compare_price. Typical sequence: ic_compare_price -> ic_get_orderbook -> ic_candles.
• Use when: comparing a coin's price across Iranian exchanges, checking a spread, reading an order book or recent trades, or listing 24h movers.
• Do not use when: the user wants to buy, sell or transfer, needs account data, or wants non-Iranian exchanges.
• Output: compact JSON. Every IRT price is in Toman (field names say *_toman); USDT markets say *_usdt.
• Machine-readable: server.json and the iran-mcp catalog.

Why

• Rial vs Toman. Nobitex, Ramzinex and OMPFinex publish Rial; Wallex, Bitpin, Tabdeal and Exir publish Toman. The same BTC price differs 10x between them. This server converts everything to Toman, so the numbers compare directly.
• Seven sites to check by hand. Each exchange has its own app, its own symbols and its own API shape. One call to ic_compare_price returns the coin on every exchange, cheapest first, with the spread.
• Persian names. Every exchange row carries name_fa, the exchange's own Persian name, so answers in Persian do not depend on the model spelling it.

What it can do

• Compare one coin's price on all thirteen exchanges, in Toman or USDT, cheapest first, with the spread
• Get a ticker: last price, 24h range and change, volume, and best bid/ask where the exchange publishes them
• Read order books (up to 20 levels per side) and recent public trades
• Pull OHLC candles (15m, 1h, 4h, 1d) from all eight order-book exchanges and Balinex (and Aban Tether for USDT/IRT)
• Rank the biggest 24h gainers and losers on an exchange, with illiquid coins filtered out
• List the coins an exchange trades against Toman or USDT
• Find the best exchange for a buy or sell of a given size, walking each order book for slippage
• Scan all coins for price gaps between exchanges (arbitrage), on real bid/ask prices
• Compare trading fees and each coin's withdrawal networks, fees and minimums across exchanges
• Get a one-call market overview: the Tether rate and major coins, median price and range across exchanges

Example prompts:

• "Compare the BTC price on all Iranian exchanges in Toman. Where is it cheapest?"
• "What is the Tether (USDT) rate in Toman on each exchange right now?"
• "Show the Nobitex ETH order book. Is the spread real?"
• "Top 5 gainers on Wallex in the last 24 hours."
• "Give me 1-hour BTC candles from Wallex for the last two days."
• "Where do I get the most USDT for 50 million Toman?"
• "Which exchange has the cheapest USDT withdrawal on TRC20?"
• "Any arbitrage between Iranian exchanges right now?"
• با ۵۰ میلیون تومان کجا بیشترین تتر را می‌گیرم؟
• قیمت بیت‌کوین را در همه صرافی‌های ایرانی به تومان مقایسه کن.
• قیمت تتر الان در کدام صرافی ارزان‌تر است؟
• دفتر سفارش اتریوم در نوبیتکس را نشان بده.

Supported exchanges

• All thirteen give prices in both quotes: Toman (IRT) and USDT. USDT markets stay in USDT.
• "Full" means last price, bid, ask, 24h high and low, change and volume.
• Bitpin volume comes from a best-effort second call; if it fails, the ticker has no volume.
• Exir publishes base volume only, so quote volume is approximated as volume times last price.
• Use ic_get_orderbook for the best bid and ask where the ticker lacks them (not Balinex: it has no order book here).
• Nobitex refuses USDT/IRT candles (its CDN answers HTTP 403, browsers included): use Wallex for those.
• Balinex is an order-book exchange, but its book is public only over a websocket and its trades not at all, so this server offers neither. Its price list refreshes about once a minute, so its price is a snapshot, not a last trade; ic_best_deal ranks it as an indicative listed price and ic_arbitrage leaves it out unless executable_only is false. Balinex has no USDT/IRT candles (use Wallex).
• ic_fees: every exchange except Balinex (which publishes no fee data) has trading fees; all but Aban Tether and OK-EX also publish withdrawal networks and fees. Ramzinex, OMPFinex, Bit24, Aban Tether and Tetherland publish trading fees only on a web page, so those values are fixed in the server (checked 2026-10-28).

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add iran-crypto -- uvx iran-crypto-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

"mcpServers": { "iran-crypto": { "command": "uvx", "args": ["iran-crypto-mcp"] } } }

</details>

Cursor

Add the Claude Desktop block to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

"servers": { "iran-crypto": { "type": "stdio", "command": "uvx", "args": ["iran-crypto-mcp"] } } }

</details>

Codex CLI

codex mcp add iran-crypto -- uvx iran-crypto-mcp

Or in ~/.codex/config.toml:

[mcp_servers.iran-crypto]

command = "uvx" args = ["iran-crypto-mcp"]

</details>

Gemini CLI

Add the Claude Desktop block to ~/.gemini/settings.json, or run:

gemini mcp add iran-crypto uvx iran-crypto-mcp

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It is a standard stdio MCP server: run uvx iran-crypto-mcp, or pip install iran-crypto-mcp and run iran-crypto-mcp.

Tools

All 8 tools are read-only. Exchange ids: nobitex, wallex, bitpin, ramzinex, tabdeal, ompfinex, exir, abantether, kifpool, okex, tetherland, bit24, balinex. quote is IRT (Toman, default) or USDT.

| ic_market_overview | Tether rate and major coins in one call: median T