Iran Mercantile Exchange

io.github.sepehr071Published by GitHub account sepehr071v0.1.0Updated Nov 1, 2026

Read-only Iran Mercantile Exchange (ime.co.ir): physical trades, supply, prices, market totals.

The publisher's own server: Exchange.news — Crypto offers, campaigns and news

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Unofficial read-only MCP server for the Iran Mercantile Exchange, giving an assistant public trade, supply, price and market-statistics data.

What you can do
  • List commodity group ids and find producers by name
  • Query trades, supply offers and daily price history for a date range
  • Get market totals by market and hall, daily totals, the USD rate and rankings by producer, broker or hall
  • Read the options board and contract history, deposit certificates, salaf and commodity funds, plus a bid/ask board
  • Fetch exchange news and links to weekly report PDFs
When to use it
Useful when someone asks what traded on the Iranian commodity exchange, how steel, rebar, hot sheet, polymers or cement prices moved, what is offered in coming sessions, how large trading was, or what gold, silver and fund certificates cost. Not for the Tehran stock market, real estate or car trading.
Requirements
Runs locally over stdio via uvx (or pip install), needing uv and Python 3.10 or newer. No account or API key. The exchange site answers from Iranian networks, so a direct Iranian line or the optional IME_MCP_PROXY HTTP proxy variable (single URL or comma-separated list) may be needed.
Before you install
Read-only and cannot place orders, but it is unofficial and depends on public website endpoints that can change without notice. Data is Persian, prices are in Rial with mixed units, and it is not investment advice. Requests go to ime.co.ir and related exchange hosts; the proxy variable, if set, routes traffic through that proxy.

Installation

In SourceWeft

  1. Open Iran Mercantile Exchange in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ime-mcp: Iran Mercantile Exchange (بورس کالای ایران) MCP server for AI agents

ime-mcp is an unofficial, read-only MCP server that gives AI agents the public trade and supply data of the Iran Mercantile Exchange (IME, ime.co.ir).
Its 14 tools list commodity trades (steel, petrochemicals, cement, oil products, metals, agriculture) with prices and volumes,
upcoming supply offers, daily price series, rankings by producer and broker, market and hall totals, the USD settlement rate,
the options board, gold, silver and other deposit certificates, gold funds and exchange news and weekly reports.
No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

[PyPI] [Python] [CI] [MCP Registry] [License: MIT]

For AI agents · Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

  • What: unofficial MCP server (model context protocol) for ime.co.ir, the Iranian commodity exchange: physical market trades (industrial and mineral, petrochemical and oil products, cement, subsidiary market, Kish export hall), supply offers (including premium and export), price history, rankings by producer or broker, market totals, USD rate, news, weekly report links, the options board, deposit certificates (gold bar, gold coin, silver...), salaf and commodity funds.
  • Install: uvx ime-mcp or claude mcp add ime -- uvx ime-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional IME_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot trade or place orders, so no confirmation is needed before calling any tool.
  • Tools: 14, all prefixed ime_. Typical sequences: ime_categories -> ime_price_history / ime_trades / ime_supply; ime_producers -> ime_trades; ime_options -> ime_options(contract=...); ime_certificates -> ime_certificates(commodity=...).
  • Use when: the user asks what traded on the exchange, the price of steel, rebar, hot sheet, polymers, bitumen or cement, what will be offered next session, how big trading was, the exchange's USD rate, option contracts, or gold bar, gold coin and silver certificate prices.
  • Do not use when: the question is about the stock market (TSETMC), or real estate and car trading: those are not covered here.
  • Output: compact JSON. Dates are Persian (1405/08/09); Gregorian input is accepted. Prices are Rial (per kg for goods counted in tonnes: check unit); value_k_rial is thousand Rial; summary values are million Rial; value_rial (options, certificates, funds) is Rial. Text is Persian.
  • Machine-readable: server.json and the iran-mcp catalog.

Why

The IME site shows trades and supply only through filter forms and paged tables. "How did the hot sheet price move this month?" means picking the group, the subgroup and a date range, then reading the table row by row. With ime-mcp an agent does it in one call:

You: How did hot sheet prices move since the start of Aban?

Agent: calls ime_price_history(search="ورق گرم", date_from="1405/08/01")

Kavian hot sheet (KAS-HS00000-00) traded at 1,305,425 Rial/kg on 08/02 (3,740 t), 1,296,722 on 08/03 (1,430 t), 1,370,586 on 08/06 (2,310 t) and 1,352,960 on 08/09 (110 t).

Numbers from a live call on 2026-10-31.

What it can do

  • Trades: every trade of a date range in the physical market, the subsidiary market (بازار فرعی) or the Kish export hall, with the weighted closing price, low and high, supply, demand, volume, value, producer, contract type, delivery and broker; filter by commodity group, producer or text
  • Supply offers (اطلاعیه عرضه): what is up for sale in coming sessions with volume, base price, delivery place and date, settlement and broker
  • Price history: daily low, high, volume-weighted average and volume per symbol over up to 45 days
  • Market totals: value and volume by market and hall for a range, plus the USD settlement rate; day-by-day totals of one market
  • Rankings: producers, commodities, brokers or halls ordered by traded value with market share
  • Options: the options board (gold, gold coin, gold funds, saffron futures) with settlement prices and open interest, and the history of one contract
  • Certificates and funds: gold bar, gold coin, silver, copper and steel deposit certificates, saffron certificates, salaf and gold funds, daily and with a bid/ask board
  • Groups and producers: the exchange's commodity group tree and producer ids
  • News and reports: the latest announcements and links to the weekly report PDFs

Example prompts:

  • "What were the biggest trades on the exchange today?"
  • "How did rebar prices move over the last two weeks?"
  • "What is offered on the exchange next week from Mobarakeh Steel?"
  • "How much did the physical market trade this week, by hall?"
  • قیمت ورق گرم در بورس کالا در یک ماه گذشته چطور تغییر کرده؟
  • فردا چه محصولاتی در بورس کالا عرضه می‌شود؟

Quick start

You need uv. No API key or account.

Claude Code
bash
claude mcp add ime -- uvx ime-mcp
Claude Desktop

Settings → Developer → Edit Config, then add:

json
{  "mcpServers": {    "ime": { "command": "uvx", "args": ["ime-mcp"] }  }}
Cursor, VS Code, Codex CLI, Gemini CLI, Windsurf

Use the same command (uvx ime-mcp) in your client's MCP settings, for example codex mcp add ime -- uvx ime-mcp or the Claude Desktop block above in ~/.cursor/mcp.json.

Anything else

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

Tools

Group ids come from ime_categories, producer ids from ime_producers. Dates are 1405/08/09 or 2026-10-31; the default is today (Tehran time). Ranges are limited to 45 days.

ToolWhat it does
ime_categoriesList the exchange's commodity groups: main groups, then groups, then subgroups, with their ids
ime_producersFind producers and suppliers listed on the exchange by name, to get the producer id for the trade and supply tools
ime_tradesList commodity trades (price, volume, supply, demand, buyer broker) for a date range, with totals
ime_supplyList supply offers (اطلاعیه عرضه): what is up for sale on which session, volume and base price (physical, premium or export)
ime_price_historyDaily price series (low, high, volume-weighted average, volume) per symbol over a date range
ime_market_summaryExchange-wide trade value and volume for a date range: by market, by physical-market hall, plus the USD rate
ime_daily_totalsDay-by-day trade value and volume of one market over a date range (the site's market chart)
ime_newsLatest news and notices from the exchange's news archive: title, lead, date and link
ime_trade_statsRank producers, commodities, brokers or halls by traded value over a date range, with each one's market share
ime_weekly_reportsList the exchange's weekly market reports (گزارش هفتگی), newest first, with the PDF link of each
ime_optionsOptions on gold, gold coin, gold funds and saffron futures (اختیار معامله): one day's board or one contract's history
ime_securitiesDaily trades of the exchange's financial-market symbols: salaf, commodity deposit certificates and commodity funds
ime_certificatesContinuous commodity deposit certificates (گواهی سپرده پیوسته): gold bar, gold coin, silver, copper, steel and more
ime_boardMarket-view board (cdn.ime.co.ir) with the best bid and ask for funds, certificates and salaf

All 14 tools are annotated readOnlyHint: true.

How it works

text
  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  ime-mcp  (runs on your machine)      │      │  HTTPS      └──────▶  www.ime.co.ir   imedata.asmx, auction.ashx, export.ashx, news archive

ime-mcp runs locally and calls the same public endpoints the ime.co.ir pages use, with no hosted server in between and no API key. Requests go out through a Chrome-impersonating client. It makes at most 3 requests at a time with a little jitter, keeps answers for 2 minutes, retries a failed request up to twice, and only talks to www.ime.co.ir, dataapi.ime.co.ir (gold and other deposit certificates) and cdn.ime.co.ir (bid/ask board).

Good to know

  • Iranian network. ime.co.ir answers from Iran. From a Turkish exit it timed out in testing; use a direct Iranian line or set IME_MCP_PROXY to a proxy that can reach it.
  • The site mixes up the physical and subsidiary lists. Its trade-list service keeps the first answer per date range and then ignores the market flag. The server asks for a fresh (padded) date range and checks the halls, retrying up to 6 times, so a slow answer is normal.
  • Units. Prices are Rial per kg for goods listed in tonnes. value_k_rial is price x volume in thousand Rial; market summaries are million Rial; options, securities, certificates and boards give value_rial in Rial.
  • Trading days. Saturday to Wednesday and some Thursdays; other days return nothing.
  • Not covered: real estate, car trading and the stock sub-sites are separate ime.co.ir sub-sites. Statistical report archives (market-reports.html) need a form post and are not read; weekly report PDFs are linked, not parsed. The subsidiary market list has no price or value, only base price, supply, demand and volume.
  • Persian data. Names, halls, contracts and news come back in Persian.

FAQ

Is there an official IME API?

IME publishes data through its website only. ime-mcp is a separate, unofficial MCP server that calls the public endpoints behind the website's tables and charts and returns compact JSON.

Does it need an API key or account?

No. Install with uvx ime-mcp and it works from an Iranian network.

Can it show live prices?

It shows trades published on the site, including the current session as the site lists them. It is not a tick feed.

Can it place orders?

No. It only reads public data.

How do I debug what the agent sees?
bash
npx @modelcontextprotocol/inspector uvx ime-mcp

Configuration

VariableDefaultMeaning
IME_MCP_PROXYunsetOptional HTTP proxy URL for the ime.co.ir 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 cannot connect

فارسی: سرور MCP بورس کالای ایران

سرور ime-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای بورس کالای ایران است. با آن دستیار هوش مصنوعی شما همان داده‌های عمومی سایت را می‌بیند: معاملات، قیمت‌ها، عرضه‌های پیش‌رو و آمار بازار.

چه کارهایی می‌کند

  • معاملات بازار فیزیکی، بازار فرعی و تالار صادراتی کیش برای هر بازهٔ تاریخی، با قیمت پایانی (میانگین موزون)، کمترین و بیشترین قیمت، عرضه، تقاضا، حجم، ارزش، تولیدکننده و کارگزار.
  • اطلاعیهٔ عرضه جلسه‌های پیش‌رو با حجم و قیمت پایه.
  • سابقهٔ قیمت هر نماد به‌صورت روزانه تا ۴۵ روز.
  • آمار بازار بر اساس بازار و تالار، و نرخ دلار تسویهٔ بورس.
  • اخبار و گزارش‌های هفتگی بورس کالا.

نکته‌ها: فقط‌خواندنی است و سفارشی ثبت نمی‌کند؛ کلید API نمی‌خواهد؛ سایت بورس کالا فقط از شبکهٔ ایران پاسخ می‌دهد؛ معاملات سکه و گواهی طلا در زیرسایت دیگری هستند و پوشش داده نمی‌شوند.

نصب (اول uv را نصب کنید). در Claude Code:

bash
claude mcp add ime -- uvx ime-mcp

نمونه پرسش‌ها

  • «قیمت ورق گرم در بورس کالا در یک ماه گذشته چطور تغییر کرده؟»
  • «فردا چه محصولاتی در بورس کالا عرضه می‌شود؟»
  • «بزرگ‌ترین معاملات امروز بورس کالا کدام‌اند؟»

Development

bash
git clone https://github.com/sepehr071/ime-mcp && cd ime-mcpuv syncuv run ruff check . && uv run ruff format --check .uv run python -m pytest -q          # offline unit tests on recorded IME answersuv run python -m pytest -m live -q  # calls the real ime.co.ir (needs an Iranian line)uv build

The physical-market tools live in src/ime_mcp/ime.py, the derivatives and securities tools in src/ime_mcp/securities.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions publishes to PyPI.

Related servers

  • iran-mcp: catalog of all Iranian-service MCP servers
  • mcpfarsi.ir: Persian marketplace of MCP servers for Iranian services

Disclaimer

Unofficial and not affiliated with or endorsed by the Iran Mercantile Exchange. It is read-only and uses the public endpoints of the ime.co.ir website, which can change without notice. Not investment advice; check prices on the exchange before acting on them.

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

Source: README.md at commit 1bdac4c

Tools

14

ime_categories

Commodity groups

List the exchange's commodity groups: main groups, then groups, then subgroups, with their ids. Call it with no arguments for the main groups (industrial, agriculture, petrochemical, mineral, oil products, real estate, subsidiary). Pass main_cat for the groups under it (steel, aluminium, copper, gold...), then main_cat plus cat for the subgroups (rebar, hot sheet...). Use the ids as main_cat/cat/sub_cat in ime_trades, ime_supply and ime_price_history.

Parameterscatmain_cat

ime_producers

Find producers

Find producers and suppliers listed on the exchange by name, to get the producer id for the trade and supply tools. Use the returned id as producer in ime_trades, ime_supply or ime_price_history.

Parameterslimitqueryrequired

ime_trades

Trades on the exchange

List commodity trades (price, volume, supply, demand, buyer broker) for a date range, with totals. Use it for "what traded today", "steel prices this week", "who bought what". Dates default to today (Tehran); at most 45 days. Filter with main_cat/cat/sub_cat (ids from ime_categories), producer (ime_producers) or search text. `price` is the volume-weighted closing price (قیمت پایانی میانگین موزون) and low/high the range; prices are per the unit shown (Rial per kg for tonne goods). `volume` is in `unit`. `value_k_rial` is price x volume in thousand Rial. Subsidiary rows carry only base_price, supply, demand and volume (the site publishes no price or value for them). For a price series of one product use ime_price_history; for market-wide totals ime_market_summary.

Parameterscatsortlimitmarketsearchdate_tosub_catmain_catproducerdate_from

ime_supply

Supply offers

List supply offers (اطلاعیه عرضه): what is up for sale on which session, volume and base price. Use it for "what will be offered tomorrow / next week". Dates are offer dates; default today to 7 days ahead; at most 45 days. Each offer has the commodity, symbol, hall, producer, supplier, volume (`unit`), base price, contract type, delivery date and place, settlement type and broker. Filters as in ime_trades; page with offset. market=premium lists premium contracts (`premium_price`), market=export the export hall. After the session, ime_trades shows what actually sold.

Parameterscatlimitmarketoffsetsearchdate_tosub_catmain_catproducerdate_from

ime_price_history

Price history of a commodity

Daily price series (low, high, volume-weighted average, volume) per symbol over a date range. Use it for "how did hot sheet / rebar / PE prices move this month". Dates default to the last 14 days up to today; at most 45 days. Narrow it with sub_cat or search (a wide filter returns only the 8 biggest symbols). Built from the trade list, so only days with trades appear. Prices as in ime_trades.

Parameterscatmarketsearchdate_tosub_catmain_catproducerdate_from

ime_market_summary

Market totals

Exchange-wide trade value and volume for a date range: by market, by physical-market hall, plus the USD rate. Use it for "how big was trading this week" or to see which hall (industrial, petrochemical, subsidiary...) led. Dates default to today (Tehran); the range is free-form but keep it short. Values are million Rial; volumes are tonnes for the physical market. `offer_volume` is what was offered. The USD rate is the exchange's own settlement rate. For a day-by-day series use ime_daily_totals.

Parametersdate_todate_from

ime_daily_totals

Daily trade totals

Day-by-day trade value and volume of one market over a date range (the site's market chart). Use it for trends: "how has physical trading volume moved over the last month". Dates default to the last 14 days; at most 45 days. Value is million Rial. Volume is tonnes for physical, contracts for options, units for financial.

Parametersmarketdate_todate_from

ime_news

Exchange news

Latest news and notices from the exchange's news archive: title, lead, date and link. Use it for announcements, weekly trading reports and new listings. Text is Persian.

Parameterslimit

ime_trade_stats

Trade statistics by group

Rank producers, commodities, brokers or halls by traded value over a date range, with each one's market share. Use it for "which producers sold the most steel this month" or "which brokers were most active". Dates default to today (Tehran); at most 45 days; filters as in ime_trades. Value is thousand Rial. `volume` is given only when all trades of the group share one unit. For single trades use ime_trades; for one product's prices over time ime_price_history.

Parameterscatlimitmarketsearchdate_tosub_catgroup_byrequiredmain_catproducerdate_from

ime_weekly_reports

Weekly reports

List the exchange's weekly market reports (گزارش هفتگی), newest first, with the PDF link of each. Use it to find the official weekly summary of a week (the report is a PDF, Persian; this tool only lists links, it does not read them). For the numbers of a week use ime_market_summary or ime_trades; for announcements ime_news.

Parametersyearlimit

ime_options

Options board

Options on gold, gold coin, gold funds and saffron futures (اختیار معامله): one day's board or one contract's history. Without dates it shows the latest trading day: for each contract the call/put type, underlying, strike (Rial), expiry, first/high/low/last price, settlement price and its change, volume, value (Rial) and open interest. With date_from/date_to (at most 10 days) the rows of every day in the range. Pass contract (a code from the list) to get that one contract's days over up to 45 days. Prices are Rial. For market-wide option totals per day use ime_daily_totals(market="options").

Parameterssortlimitsearchdate_tocontractdate_fromoption_typetraded_only

ime_securities

Commodity securities trades

Daily trades of the exchange's financial-market symbols: salaf, commodity deposit certificates and commodity funds. Use it for "which gold fund traded most yesterday" or "saffron certificate prices this week". Without dates it shows the latest trading day; with dates every day in the range (at most 45 days). Each row has symbol, name, close and last price, change vs the previous close, number of trades, volume, value (Rial), low and high. Prices are Rial per unit. For gold bar / gold coin / silver continuous certificates use ime_certificates; for live bid and ask use ime_board.

Parameterskindsortlimitsearchdate_todate_from

ime_certificates

Gold and other deposit certificates

Continuous commodity deposit certificates (گواهی سپرده پیوسته): gold bar, gold coin, silver, copper, steel and more. These are the exchange's gold bar / gold coin / silver certificates (gold.ime.co.ir). Without `commodity` it lists every certificate with its latest day: first, high, low, last price, settlement price and change, volume, value (Rial), open interest and active customers. With `commodity` it gives that certificate's day-by-day history (dates default to the last 30 days, at most 90). Prices are Rial per certificate unit (about one gram for gold bar, one coin for GoldCoin). For fund and saffron-certificate symbols use ime_securities.

Parametersdate_tocommoditydate_from

ime_board

Live board of funds, certificates and salaf

Market-view board (cdn.ime.co.ir) with the best bid and ask: use it to see where a fund or certificate trades now. During the session it is live; after the close it keeps the last session (see `time` and `date`). Each symbol has last and closing price, change vs yesterday, low, high, volume, value (Rial), number of trades, best bid and best ask with sizes. For daily history over a range use ime_securities.

Parameterskindsortlimitsearch

Version history

1
  1. v0.1.0LatestNov 1, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Exchange integrations

Exchange.news — Crypto offers, campaigns and news

news.exchangeOfficial publisher

A read-only remote catalog that lets an assistant look up crypto signup codes, partner links, campaign dates and Exchange.news stories.

Streamable HTTPWeb executable
Finance5 toolsOct 25, 2026

Microsoft Exchange Online MCP

Published by GitHub account Servosity

Unofficial MCP server that lets an assistant audit and administer Microsoft Exchange Online mailboxes across customer tenants over REST, without PowerShell.

STDIODesktop only
Cloud & InfrastructureNot validated yetNov 7, 2026

Agent Service Exchange

Published by GitHub account PatrickPi1312

Find providers; send authorised installation or cleaning enquiries in Vienna. No customer account.

Streamable HTTPWeb executable
9 toolsNov 7, 2026

Türkiye Central Bank (TCMB) Exchange Rates

Published by GitHub account foster-ops

Unofficial remote MCP server for Central Bank of Türkiye (TCMB) exchange rates: latest bulletin, history since 1996, and currency conversion.

Streamable HTTPWeb executable
Finance4 toolsOct 29, 2026

Exchange Arbitrage Agent

Published by GitHub account LKennedyShare

Remote MCP server for prediction-market data: search markets, get order-book quotes, estimate fills and review odds trends, with paid calls in USDC on Base.

Streamable HTTPWeb executable
Data & Analytics6 toolsOct 29, 2026