claudeers.
// MCP Servers

iran-crypto-mcp

Unofficial read-only MCP server for Iranian crypto exchanges: Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex and Exir. Compare prices in Toman, order b…

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#ai-agents#bitpin#claude-code#crypto-exchange#cryptocurrency#cursor#exir#mcp-servers◷ MIT$open-sourceupdated 10 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up iran-crypto-mcp (pip project) into my current project.
Found on https://claudeers.com/iran-crypto-mcp
Repo: https://github.com/sepehr071/iran-crypto-mcp
Homepage/docs: https://pypi.org/project/iran-crypto-mcp/
Detected install method: pip → pip install iran-crypto-mcp
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (pip)
pip install iran-crypto-mcp
// or clone
git clone https://github.com/sepehr071/iran-crypto-mcp

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
iran-crypto-mcp: unofficial MCP server for Iranian crypto exchanges, for Claude, Cursor and Copilot

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

ExchangePersian nameSitePublished unitTickerOrder bookTradesCandles
Nobitexنوبیتکسnobitex.irRialfullyesyesyes (not USDT/IRT)
Wallexوالکسwallex.irTomanfullyesyesyes
Bitpinبیت‌پینbitpin.irTomanno bid/askyesyesyes
Ramzinexرمزینکسramzinex.irRialfullyesyesyes
Tabdealتبدیلtabdeal.orgTomanno bid/ask, no volumeyesyesyes
OMPFinexاو ام پی فینکسompfinex.comRialno bid/askyesnoyes
Exirاکسیرexir.ioTomanno bid/askyesyesyes
Bit24بیت ۲۴bit24.cashTomanno bid/askyesyes (no side)yes
Balinexبالینکسbalinex.comTomanno bid/ask; no 24h stats for USDT/IRTnonoyes (not USDT/IRT)
Aban Tether (broker)آبان تترabantether.irTomanbuy/sell price, no high/lownonoUSDT/IRT only (1h+)
Kifpool (broker)کیف پول منkifpool.meTomansell price only; no USDT/IRTnonono
OK-EX (broker)اوکی اکسچنجok-ex.ioTomanbuy/sell price, no high/lownonono
Tetherland (broker)تترلندtetherland.comTomanone price, no high/lownonono
  • 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.

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.

ToolWhat it does
ic_list_exchangesThe supported exchanges, their native price unit and what each can answer
ic_list_marketsCoins an exchange trades against Toman (IRT) or USDT
ic_compare_priceOne coin's price on every exchange in one call, cheapest first, with the spread (an exchange that fails is reported, not fatal)
ic_get_tickerLive price, best bid and ask, 24h range, change and volume of a coin on one exchange
ic_get_orderbookTop bids and asks (1 to 20 levels) with the spread
ic_recent_tradesLatest public trades, newest first (1 to 50; every order-book exchange except OMPFinex)
ic_candlesOHLC candles, 15m / 1h / 4h / 1d, up to 100 (order-book exchanges, Aban Tether for USDT/IRT)
ic_top_moversBiggest 24h gainers or losers on one exchange, illiquid coins filtered out (up to 25)
ic_best_dealRanks exchanges by what a buy or sell of a given size gets, with order-book slippage and fill
ic_arbitrageBiggest cross-exchange price gaps over all coins, buy at the lowest ask and sell at the highest bid
ic_feesTrading fees per exchange and, for one coin, withdrawal networks, fees and minimums, with the cheapest per network
ic_market_overviewTether 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

VariableDefaultMeaning
IRAN_CRYPTO_MCP_PROXYunsetOptional 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          # 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.

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

Sepehr Radmard: open-source MCP servers for the Iranian web. LinkedIn: linkedin.com/in/sepehr-radmard

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

// faq

What is iran-crypto-mcp?

Unofficial read-only MCP server for Iranian crypto exchanges: Nobitex, Wallex, Bitpin, Ramzinex, Tabdeal, OMPFinex and Exir. Compare prices in Toman, order books, trades, candles. For Claude, Cursor and Copilot. صرافی ارز دیجیتال. It is open-source on GitHub.

Is iran-crypto-mcp free to use?

iran-crypto-mcp is open-source under the MIT license, so it is free to use.

What category does iran-crypto-mcp belong to?

iran-crypto-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

4 views
★ 11 stars
unclaimed
updated 10 days ago

// embed badge

iran-crypto-mcp on Claudeers
[![Claudeers](https://claudeers.com/api/badge/iran-crypto-mcp.svg)](https://claudeers.com/iran-crypto-mcp)

// retro hit counter

iran-crypto-mcp hit counter
[![Hits](https://claudeers.com/api/counter/iran-crypto-mcp.svg)](https://claudeers.com/iran-crypto-mcp)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 175,627◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 151,540◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how iran-crypto-mcp connects across the ecosystem