Iran Mercantile Exchange
PYPI · IME-MCP
Read-only Iran Mercantile Exchange (ime.co.ir): physical trades, supply, prices, market totals.
Available components
Last scanned (7 hours ago)
Scores higher than 59% of PyPI servers
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 1 of 35 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to sepehr071/ime-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability61
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 3858 tokens (~275/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 5 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 1 Nov 26 78
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed pypi/ime-mcp@0.1.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | sepehr071/ime-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/sepehr071/ime-mcp/.github/workflows/publish.yml@refs/tags/v0.1.0 |
| Rekor log index | 3624078718 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:409cbb2633e459847ee7aa98030b8fa7026a2c40646c85558c685f951d54f468 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 35 packages
| Packages resolved | 35 |
|---|---|
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ime_board Live board of funds, certificates and salaf ~189
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.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | – | fund (commodity ETFs, mostly gold), certificate (saffron etc.) or salaf (standard forward). |
| limit | integer | – | Max symbols to return (1-60). |
| search | – | – | Keep rows whose symbol, code or name contains this text. |
| sort | string | – | value or volume (largest first) or change (biggest move first). |
No output schema declared.
No examples provided.
ime_categories Commodity groups ~154
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cat | integer | – | Group id (with main_cat) to list its subgroups. |
| main_cat | integer | – | Main group id to list its groups (0 = list the main groups). |
No output schema declared.
No examples provided.
ime_certificates Gold and other deposit certificates ~273
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.
| Name | Type | Req | Description |
|---|---|---|---|
| commodity | – | – | Certificate id, code or name part: GoldBar, GoldCoin, SilverBar, CopperCthd, Bitumen, ZincIngot, SteelRebar... or طلا, سکه, نقره. Empty = all. |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
No output schema declared.
No examples provided.
ime_daily_totals Daily trade totals ~162
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| market | string | – | physical, options (اختیار معامله) or financial (مالی). |
No output schema declared.
No examples provided.
ime_market_summary Market totals ~186
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
No output schema declared.
No examples provided.
ime_news Exchange news ~57
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max news items (1-30). |
No output schema declared.
No examples provided.
ime_options Options board ~340
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").
| Name | Type | Req | Description |
|---|---|---|---|
| contract | – | – | One contract code (from an earlier answer): returns its day-by-day history instead. |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| limit | integer | – | Max contracts or days to return (1-100). |
| option_type | string | – | call (خرید), put (فروش) or all. |
| search | – | – | Keep contracts whose code or description contains this text, e.g. GCES (gold coin) or صندوق طلا. |
| sort | string | – | Order of the list, largest first (settlement_change by size of the move). |
| traded_only | boolean | – | Only contracts that traded (volume above 0). |
No output schema declared.
No examples provided.
ime_price_history Price history of a commodity ~297
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cat | integer | – | Category id from ime_categories (0 = all). |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| main_cat | integer | – | Category id from ime_categories (0 = all). |
| market | string | – | physical (main physical market halls), subsidiary (بازار فرعی, secondary market), export (Kish export hall) or premium (پریمیوم contracts; no producer filter). |
| producer | integer | – | Category id from ime_categories (0 = all). |
| search | – | – | Commodity, symbol or producer text, e.g. ورق گرم or میلگرد. |
| sub_cat | integer | – | Category id from ime_categories (0 = all). |
No output schema declared.
No examples provided.
ime_producers Find producers ~87
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max producers (1-50). |
| query | string | yes | Part of a producer name, Persian or English, e.g. فولاد مبارکه. |
No output schema declared.
No examples provided.
ime_securities Commodity securities trades ~301
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.
| Name | Type | Req | Description |
|---|---|---|---|
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| kind | string | – | salaf (standard forward, سلف استاندارد), certificate (گواهی سپرده کالایی such as saffron), fund (commodity ETFs, mostly gold) or all. |
| limit | integer | – | Max rows to return (1-100). |
| search | – | – | Keep rows whose symbol, code or name contains this text. |
| sort | string | – | value or volume (largest first), change (biggest move first) or date (newest first). |
No output schema declared.
No examples provided.
ime_supply Supply offers ~343
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cat | integer | – | Category id from ime_categories (0 = all). |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| limit | integer | – | Max offers to return (1-50). |
| main_cat | integer | – | Category id from ime_categories (0 = all). |
| market | string | – | physical (default), premium (اطلاعیه عرضه پریمیوم) or export (Kish export hall, priced in $). |
| offset | integer | – | Skip this many offers (paging). |
| producer | integer | – | Category id from ime_categories (0 = all). |
| search | – | – | Keep offers whose commodity, symbol, producer or supplier contains this text. |
| sub_cat | integer | – | Category id from ime_categories (0 = all). |
No output schema declared.
No examples provided.
ime_trade_stats Trade statistics by group ~338
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cat | integer | – | Category id from ime_categories (0 = all). |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| group_by | string | yes | Rank trades by producer, commodity, buyer broker, hall or contract type. |
| limit | integer | – | Max groups to return (1-50). |
| main_cat | integer | – | Category id from ime_categories (0 = all). |
| market | string | – | physical (main physical market halls), subsidiary (بازار فرعی, secondary market), export (Kish export hall) or premium (پریمیوم contracts; no producer filter). |
| producer | integer | – | Category id from ime_categories (0 = all). |
| search | – | – | Keep trades whose commodity, symbol or producer contains this text. |
| sub_cat | integer | – | Category id from ime_categories (0 = all). |
No output schema declared.
No examples provided.
ime_trades Trades on the exchange ~426
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cat | integer | – | Category id from ime_categories (0 = all). |
| date_from | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| date_to | – | – | Persian date 1405/08/09 or Gregorian 2026-10-31 (Persian digits are fine). |
| limit | integer | – | Max trades to return (1-100). |
| main_cat | integer | – | Category id from ime_categories (0 = all). |
| market | string | – | physical (main physical market halls), subsidiary (بازار فرعی, secondary market), export (Kish export hall) or premium (پریمیوم contracts; no producer filter). |
| producer | integer | – | Category id from ime_categories (0 = all). |
| search | – | – | Keep trades whose commodity, symbol or producer contains this text. |
| sort | string | – | value (largest first), volume (largest first) or date (newest first). |
| sub_cat | integer | – | Category id from ime_categories (0 = all). |
No output schema declared.
No examples provided.
ime_weekly_reports Weekly reports ~128
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max reports (1-60), newest first. |
| year | – | – | Persian year, e.g. 1405 (default: all years on the page). |
No output schema declared.
No examples provided.
How do I install the Iran Mercantile Exchange MCP server?
Iran Mercantile Exchange runs locally as a PyPI package, launched with uvx ime-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · ime-mcp
claude mcp add sepehr071-ime-mcp -- uvx ime-mcp
What is the Iran Mercantile Exchange MCP server?
Iran Mercantile Exchange is an MCP server listed in the public MCP registry as io.github.sepehr071/ime-mcp. Read-only Iran Mercantile Exchange (ime.co.ir): physical trades, supply, prices, market totals. This page covers its PyPI package (ime-mcp).
Is the Iran Mercantile Exchange MCP server safe to use?
Iran Mercantile Exchange scores 63 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Iran Mercantile Exchange MCP server expose?
Iran Mercantile Exchange exposes 14 tools: ime_categories, ime_producers, ime_trades, ime_supply, ime_price_history, and 9 more. Their descriptions and schemas cost roughly 3,281 tokens of context every time the server is loaded.
Is the Iran Mercantile Exchange MCP server still maintained?
Iran Mercantile Exchange is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Iran Mercantile Exchange MCP server under?
Iran Mercantile Exchange declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.