Iran Mercantile Exchange

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

The tools below come from the ime-mcp MCP server. If they are not available, install it with claude mcp add ime -- uvx ime-mcp, or add "ime": {"command": "uvx", "args": ["ime-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

• ime_categories: List the exchange's commodity groups: main groups, then groups, then subgroups, with their ids.
• ime_producers: Find producers and suppliers listed on the exchange by name, to get the producer id for the trade and supply tools.
• ime_trades: List commodity trades (price, volume, supply, demand, buyer broker) for a date range, with totals.
• ime_supply: List supply offers (اطلاعیه عرضه): what is up for sale on which session, volume and base price.
• ime_price_history: Daily price series (low, high, volume-weighted average, volume) per symbol over a date range.
• ime_market_summary: Exchange-wide trade value and volume for a date range: by market, by physical-market hall, plus the USD rate.
• ime_daily_totals: Day-by-day trade value and volume of one market over a date range (the site's market chart).
• ime_news: Latest news and notices from the exchange's news archive: title, lead, date and link.
• ime_trade_stats: Rank producers, commodities, brokers or halls by traded value over a date range, with each one's market share.
• ime_weekly_reports: List the exchange's weekly market reports (گزارش هفتگی), newest first, with the PDF link of each.
• ime_options: Options on gold, gold coin, gold funds and saffron futures (اختیار معامله): one day's board or one contract's history.
• ime_securities: Daily trades of the exchange's financial-market symbols: salaf, commodity deposit certificates and commodity funds.
• ime_certificates: Continuous commodity deposit certificates (گواهی سپرده پیوسته): gold bar, gold coin, silver, copper, steel and more.
• ime_board: Market-view board (cdn.ime.co.ir) with the best bid and ask: use it to see where a fund or certificate trades now.

Rules

• Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
• Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
• Keep request rates low. These are undocumented site APIs that can change or rate-limit.
• On timeouts or HTTP 403 outside Iran, set IME_MCP_PROXY to an HTTP proxy with an Iranian IP.
• Prices are Rial, not Toman (per kg for goods listed in tonnes; check unit). value_k_rial is thousand Rial, market summaries million Rial. Date ranges are limited to 45 days. ime.co.ir answers only Iranian connections; outside Iran the user needs IME_MCP_PROXY.