iran-bourse-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IRAN_BOURSE_PROXY | No | HTTP(S) proxy for all requests. System proxy variables are honoured when unset. | |
| IRAN_BOURSE_CDN_URL | No | Override the TSETMC API base URL. | https://cdn.tsetmc.com/api |
| IRAN_BOURSE_TIMEOUT | No | Request timeout in seconds. | 45 |
| IRAN_BOURSE_CODAL_URL | No | Override the Codal search API URL. | https://search.codal.ir/api/search/v2/q |
| IRAN_BOURSE_WEBGW_URL | No | Override the TSE gateway base URL. | https://webgw.tse.ir |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| market_statusA | Is the Tehran market open right now? Tehran time, session hours, bourse state and totals (وضعیت بازار). |
| market_overviewC | Index value, equal-weight index, total value/volume/trades and market cap for the market (نمای کلی بازار). |
| indicesB | All indices: total, equal-weight, free-float and every industry index with change % (شاخص‌ها و شاخص صنایع). |
| market_watchB | Whole-market screen (دیده‌بان بازار): filter, sort and page through every listed instrument in one call. |
| top_moversB | Ranked lists: top gainers/losers, most traded, buy/sell queues (صف خرید/فروش), real-person money inflow/outflow (ورود/خروج پول حقیقی), buyer power. |
| industry_summaryA | Per-industry breakdown: traded value, average and cap-weighted change, index effect, queue counts (گروه‌های صنعتی). |
| index_contributorsB | Stocks pushing the total index up or down the most, in index points (بیشترین تاثیر بر شاخص). |
| market_snapshotB | End-of-day table for every instrument on a past date (تاریخچه کل بازار در یک روز). |
| market_holder_movesB | Large holders whose positions changed most over the last 5 reported days, market-wide (تغییرات سهامداران عمده). |
| supervisor_messagesB | Exchange supervisor notices (پیام ناظر): trading restrictions, clarifications, halts. |
| search_symbolB | Find instruments by symbol or name fragment; returns symbol, name, market, board, insCode (جستجوی نماد). |
| symbol_overviewA | One-call dossier for a symbol: identity, quote, order book, real/legal flow, top shareholders, latest Codal filings and supervisor notices. Start here. |
| quoteA | Live/last quote with correct change %, volume, value, VWAP, price limits, ranges, P/E and market cap (قیمت لحظه‌ای). |
| order_bookA | Five-level order book (عمق بازار) with order counts, imbalance and buy/sell queue (صف) detection. |
| order_book_historyB | Intraday order-book evolution rebuilt from every event: sampled depth plus buy/sell queue episodes with peak sizes (تاریخچه صف خرید و فروش). |
| tradesA | Raw tick-by-tick trades (ریز معاملات) with time, price, volume, value. Filter by time and size; prefer trade_summary for analysis. |
| trade_summaryA | Aggregate a day's ticks: intraday bars, VWAP, biggest trades, volume by price level, tick-rule pressure estimate, and a completeness check against official totals. |
| price_historyB | Daily OHLCV history since listing, optionally adjusted (تاریخچه قیمت). |
| real_legal_flowB | Real vs legal buying/selling (حقیقی و حقوقی): counts, per-capita, buyer power, net money flow, with daily history. |
| shareholdersA | Major shareholders (سهامداران عمده) with shares, percent and the holder_id for deeper lookups. |
| shareholder_historyB | Dated major-holder snapshots for a symbol with computed changes between snapshots. |
| shareholder_portfolioC | Everything else that major holder owns across the market (پرتفوی سهامدار). |
| corporate_actionsA | Capital increases and price adjustments (افزایش سرمایه، تعدیل قیمت) with dates and factors. |
| symbol_statisticsA | Exchange-computed averages and stats for the symbol (e.g. average traded value over 3 months). |
| etf_navC | Fund/ETF issue and redemption NAV vs market price: premium/discount (صدور و ابطال). |
| codal_filingsA | Search Codal disclosures (کدال): title, publish time, tracing number and links to the page, PDF, Excel and attachments. |
| codal_companyB | Issuer profile from Codal: CEO, ISIC, address, activity description (اطلاعات ناشر). |
| glossaryB | Explain Iranian market terms (صف خرید، سرانه خرید، حقیقی/حقوقی، دامنه نوسان …) so answers use them correctly. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_symbol | Full analyst-style review of one symbol. |
| daily_market_report | End-of-day market report. |
| smart_money_scan | Find symbols where real-person buying power and money inflow stand out. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| glossary_resource | Full Persian/English market glossary. |
TDQS
Scored across 28 tools
Most tools target a clearly distinct resource: quote vs order_book vs trades vs price_history vs real_legal_flow are all separable, and the descriptions actively steer selection (symbol_overview 'start here', trades 'prefer trade_summary'). Residual overlap exists among market_watch / market_snapshot / top_movers (live screen vs historical EOD vs ranked lists) and between quote and symbol_overview, but the wording makes the boundaries workable rather than confusing.
All names are snake_case and follow a coherent noun/resource convention (market_overview, order_book, price_history, codal_filings). A handful use verb_noun or adjectival forms (search_symbol, top_movers, index_contributors, market_holder_moves), which is a minor deviation but not a readability problem.
At 28 tools this sits in the heavy band, and a few could be folded together (e.g. shareholders / shareholder_history / shareholder_portfolio as one tool with a mode parameter, or market_watch / market_snapshot as one with a date). Still, each tool maps to a genuinely different data endpoint in a full exchange terminal, so it is more 'dense' than 'bloated'.
Coverage is broad for a market-data server: quotes, depth, ticks, history, real/legal flow, shareholder lineage, corporate actions, ETF NAV, indices, screening, Codal and a glossary. Gaps remain around historical index/sector time series, symbol-to-symbol comparison, and any derivatives or portfolio/watchlist surface, but agents can work around these.