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
| Exchange | Persian name | Site | Published unit | Ticker | Order book | Trades | Candles |
|---|
| Nobitex | نوبیتکس | nobitex.ir | Rial | full | yes | yes | yes (not USDT/IRT) |
| Wallex | والکس | wallex.ir | Toman | full | yes | yes | yes |
| Bitpin | بیتپین | bitpin.ir | Toman | no bid/ask | yes | yes | yes |
| Ramzinex | رمزینکس | ramzinex.ir | Rial | full | yes | yes | yes |
| Tabdeal | تبدیل | tabdeal.org | Toman | no bid/ask, no volume | yes | yes | yes |
| OMPFinex | او ام پی فینکس | ompfinex.com | Rial | no bid/ask | yes | no | yes |
| Exir | اکسیر | exir.io | Toman | no bid/ask | yes | yes | yes |
| Bit24 | بیت ۲۴ | bit24.cash | Toman | no bid/ask | yes | yes (no side) | yes |
| Balinex | بالینکس | balinex.com | Toman | no bid/ask; no 24h stats for USDT/IRT | no | no | yes (not USDT/IRT) |
| Aban Tether (broker) | آبان تتر | abantether.ir | Toman | buy/sell price, no high/low | no | no | USDT/IRT only (1h+) |
| Kifpool (broker) | کیف پول من | kifpool.me | Toman | sell price only; no USDT/IRT | no | no | no |
| OK-EX (broker) | اوکی اکسچنج | ok-ex.io | Toman | buy/sell price, no high/low | no | no | no |
| Tetherland (broker) | تترلند | tetherland.com | Toman | one price, no high/low | no | no | no |
- 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"] }
}
}
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"] }
}
}
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"]
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.
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.
| Tool | What it does |
|---|
ic_list_exchanges | The supported exchanges, their native price unit and what each can answer |
ic_list_markets | Coins an exchange trades against Toman (IRT) or USDT |
ic_compare_price | One coin's price on every exchange in one call, cheapest first, with the spread (an exchange that fails is reported, not fatal) |
ic_get_ticker | Live price, best bid and ask, 24h range, change and volume of a coin on one exchange |
ic_get_orderbook | Top bids and asks (1 to 20 levels) with the spread |
ic_recent_trades | Latest public trades, newest first (1 to 50; every order-book exchange except OMPFinex) |
ic_candles | OHLC candles, 15m / 1h / 4h / 1d, up to 100 (order-book exchanges, Aban Tether for USDT/IRT) |
ic_top_movers | Biggest 24h gainers or losers on one exchange, illiquid coins filtered out (up to 25) |
ic_best_deal | Ranks exchanges by what a buy or sell of a given size gets, with order-book slippage and fill |
ic_arbitrage | Biggest cross-exchange price gaps over all coins, buy at the lowest ask and sell at the highest bid |
ic_fees | Trading fees per exchange and, for one coin, withdrawal networks, fees and minimums, with the cheapest per network |
ic_market_overview | Tether rate and major coins in one call: median Toman price, cheapest and dearest exchange, median change |
How it works
AI agent (Claude, Cursor, Copilot, ...)
│
│ MCP over stdio
▼
iran-crypto-mcp (runs on your machine)
│
│ HTTPS
└──────▶ public market-data endpoints of the 13 exchanges
- Runs locally and calls the public endpoints the exchanges' own websites use. No hosted server in between, no API key.
- Uses a Chrome-like HTTP client and sends each exchange's own Origin and Referer, like its website does.
- Answers are cached for 15 seconds and at most 2 requests run at once. Failed GET requests are retried.
- Read-only: it never calls account, order or trading endpoints.
Good to know
- Units are normalized. IRT prices are Toman (Rial exchanges are divided by 10); USDT prices are unchanged. The unit is in the field name:
price_toman, price_usdt.
name_fa on every exchange row is the exchange's own Persian name.
- One exchange can fail alone.
ic_compare_price reports a failing exchange under errors and still compares the rest. HTTP 403 means that exchange's CDN refuses your network. Set IRAN_CRYPTO_MCP_PROXY to an Iranian HTTP proxy and try again.
- A spread is not always real. Quotes differ for real reasons (fees, liquidity, a stale last trade). Check the order book on both exchanges before acting on it.
- Reply sizes are capped to stay under about 15 KB: order books 20 levels, trades 50, candles 100, movers 25.
- Top movers skip coins below a 24h volume floor (default 100,000,000 Toman or 10,000 USDT; set
min_volume to change it). Tabdeal publishes no volume, so its coins are not filtered.
- Prices are informational. They are live-ish (15 s cache), not a quote you can trade at.
FAQ
Is there an API or MCP server for Iranian crypto exchanges?
iran-crypto-mcp is an unofficial MCP server with 8 read-only tools over the public endpoints of Nobitex, Wallex,
Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir, Bit24, Balinex, Aban Tether, Kifpool, OK-EX and Tetherland. It needs no API key.
How do I compare crypto prices in Toman with Claude, Cursor or Copilot?
Add the server (see Quick start) and ask, for example, "compare BTC on all Iranian exchanges in Toman".
The agent calls ic_compare_price, which returns every exchange's price in Toman, cheapest first, with the spread.
Why are some prices 10x different between exchanges?
Some exchanges publish Rial and others Toman (1 Toman = 10 Rial). This server converts everything to Toman. If you still
see a big gap, it is a real difference or a stale quote: check the order book.
Can it trade, or see my balance?
No. It has no login or keys and never calls account, order or trading endpoints. It only reads public market data.
An exchange shows an error with HTTP 403. What now?
That exchange's CDN refuses requests from your network. The other exchanges still work. Set IRAN_CRYPTO_MCP_PROXY to
an HTTP proxy with an Iranian exit and retry. System proxy variables are ignored on purpose.
Why does a ticker have no bid/ask or volume?
Bitpin, Tabdeal, OMPFinex, Exir, Bit24, Balinex and Tetherland publish no bid/ask in their ticker feeds, and Tabdeal publishes no volume. Call
ic_get_orderbook for the best bid and ask. The brokers (Aban Tether, Kifpool, OK-EX, Tetherland) and Balinex have no order book here.
Why are there no candles for the brokers?
Instant-swap brokers publish no price history of their own (Aban Tether only for USDT/IRT). Every order-book exchange has candles, and so does Balinex. Nobitex and Balinex have no USDT/IRT candles; use Wallex for those.
Claude Desktop says uvx is not found
Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.
Configuration
| Variable | Default | Meaning |
|---|
IRAN_CRYPTO_MCP_PROXY | unset | Optional HTTP proxy URL for exchange requests; system proxy settings are ignored. A comma-separated list is used one at a time: the next proxy takes over when one is blocked or fails to connect |
فارسی
iran-crypto-mcp یک سرور MCP غیررسمی و فقطخواندنی برای دادههای عمومی بازار صرافیهای ارز دیجیتال ایرانی است: نوبیتکس، والکس، بیتپین، رمزینکس، تبدیل، او ام پی فینکس و اکسیر. به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه میدهد قیمت یک ارز را در همه صرافیها به تومان مقایسه کند.
چه کارهایی میکند
- مقایسه قیمت صرافیها: قیمت بیتکوین، تتر و بقیه ارزها در هر هفت صرافی با یک درخواست، از ارزان به گران، همراه با اختلاف قیمت.
- قیمت تتر و بیتکوین به تومان: قیمت صرافیهایی که ریال میدهند تقسیم بر ۱۰ میشود، پس همه عددها قابل مقایسهاند.
- دفتر سفارش (تا ۲۰ سطح)، معاملات اخیر و کندلها (۱۵ دقیقه، ۱ ساعت، ۴ ساعت، روزانه؛ فقط نوبیتکس و والکس).
- بیشترین رشد و افت ۲۴ ساعته هر صرافی، بدون ارزهای کمحجم.
نکتهها
- فقط داده عمومی بازار؛ بدون ورود به حساب، کلید API، خرید و فروش.
- اگر یک صرافی خطای ۴۰۳ بدهد، یعنی شبکه شما را نمیپذیرد؛ بقیه صرافیها کار میکنند. متغیر
IRAN_CRYPTO_MCP_PROXY را روی یک پروکسی HTTP ایرانی بگذارید.
- اختلاف قیمت همیشه فرصت واقعی نیست؛ قبل از هر تصمیم دفتر سفارش را ببینید.
- قیمتها ۱۵ ثانیه نگه داشته میشوند و توصیه مالی نیستند.
نصب (اول uv را نصب کنید). در Claude Code:
claude mcp add iran-crypto -- uvx iran-crypto-mcp
در Claude Desktop، Cursor و بقیه برنامهها همان تنظیم بخش Quick start را بگذارید.
نمونه پرسشها
- «قیمت بیتکوین را در همه صرافیها به تومان مقایسه کن.»
- «تتر در کدام صرافی ارزانتر است؟»
- «دفتر سفارش اتریوم در نوبیتکس را نشان بده.»
- «بیشترین رشد ۲۴ ساعته در والکس چیست؟»
Development
git clone https://github.com/sepehr071/iran-crypto-mcp && cd iran-crypto-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q
uv run python -m pytest -m live -q
uv build
Tools live in src/iran_crypto_mcp/markets.py, the per-exchange adapters in exchanges.py. Issues and PRs are welcome.
Releases: bump the version in pyproject.toml and server.json, then push a v* tag.
Disclaimer
Unofficial and not affiliated with or endorsed by any exchange. It reads public market data only: no keys, no account
access, no trading. Prices are informational, not financial advice, and the endpoints can change without notice.
Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.
License
MIT