Skip to main content
MCP server CX Codex

TSETMC Tehran Stock Exchange — Claude Code MCP server

TSETMC Tehran Stock Exchange is an MCP server for Claude Code that reads quotes, movers, order books, history, and indices. It cannot place trades.

no license ★ 10 updated 2026-11-17

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env TSETMC_MCP_PROXY=<TSETMC_MCP_PROXY> --transport stdio tsetmc-tehran-stock-exchange -- uvx tsetmc-mcp
Open on GitHub

What TSETMC Tehran Stock Exchange does

TSETMC Tehran Stock Exchange gives an agent read access to Tehran Stock Exchange and Iran Fara Bourse market data. It can find shares, funds, rights issues, and bonds by ticker or name, then return quotes, market movers, order-book levels, daily history, and index data. Separate tools report trading by individual and legal investors.

This server is for market data, not trading: it does not log in or submit orders. Running it requires uv and Python 3.10+; no API key or account is needed. If TSETMC returns HTTP 403, TSETMC_MCP_PROXY can provide an HTTP proxy. Prices use Rial, volumes use shares, and dates use YYYY-MM-DD.

What it helps with

  • look up an instrument by ticker or name
  • rank Bourse and Fara Bourse market movers
  • inspect the best bid and ask levels
  • retrieve daily trading history for an instrument
  • track individual investor buying and selling

Example prompts for the agent

  • Show today’s strongest gainers on the Tehran Stock Exchange with their latest prices.
  • Get the last 20 trading days for وبملت and check whether individual investors bought or sold during the last 3 days.
  • Read the order book for فولاد, including the best buy and sell levels.

How to install TSETMC Tehran Stock Exchange

Platform CLI

claude mcp add --env TSETMC_MCP_PROXY=<TSETMC_MCP_PROXY> --transport stdio tsetmc-tehran-stock-exchange -- uvx tsetmc-mcp

Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tsetmc-mcp <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about TSETMC Tehran Stock Exchange

How do I install TSETMC Tehran Stock Exchange in Claude Code?

Run claude mcp add tsetmc-mcp -- uvx tsetmc-mcp. The command requires uv.

What does TSETMC Tehran Stock Exchange do?

It gives an agent TSETMC market data, including quotes, movers, order books, daily history, indices, and trading figures for individual and legal investors.

What does TSETMC Tehran Stock Exchange require?

It requires uv and Python 3.10+. No API key or account is needed. If TSETMC responds with HTTP 403, an HTTP proxy can be supplied through TSETMC_MCP_PROXY.

Similar MCP servers

All MCP servers for Finance and business →

Project sponsors

Companies that keep this analytics open