For AI agents

• What: unofficial MCP server for the public market data of 7 Iranian crypto exchanges (Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex, Exir).
• 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 awesome-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 seven 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 Nobitex and Wallex
• 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

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."
• قیمت بیت‌کوین را در همه صرافی‌های ایرانی به تومان مقایسه کن.
• قیمت تتر الان در کدام صرافی ارزان‌تر است؟
• دفتر سفارش اتریوم در نوبیتکس را نشان بده.

Supported exchanges

• All seven support top movers and 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.
• Nobitex refuses USDT/IRT candles (its CDN answers HTTP 403, browsers included): use Wallex for those.

Quick start

You need uv. No API key or account.

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

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

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

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

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

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

Tools

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

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 7 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

Configuration

فارسی

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

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          # offline unit tests
uv run python -m pytest -m live -q  # calls the real exchange APIs
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.

Related servers

• awesome-iran-mcp: catalog of all Iranian-service MCP servers
• tgju-mcp for dollar, gold, coin and commodity prices from TGJU
• tsetmc-mcp for the Tehran stock exchange
• milligold-mcp for gold prices
• iran-news-mcp for Iranian news

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.

License

MIT