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
claude mcp add --env TSETMC_MCP_PROXY=<TSETMC_MCP_PROXY> --transport stdio tsetmc-tehran-stock-exchange -- uvx tsetmc-mcpWhat 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-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tsetmc-mcp <command>
Platform CLI
codex mcp add tsetmc-tehran-stock-exchange --env TSETMC_MCP_PROXY=<TSETMC_MCP_PROXY> -- uvx tsetmc-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tsetmc-mcp <command>
Config file
{
"mcpServers": {
"tsetmc-tehran-stock-exchange": {
"command": "uvx",
"args": [
"tsetmc-mcp"
],
"env": {
"TSETMC_MCP_PROXY": "<TSETMC_MCP_PROXY>"
}
}
}
}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>
Config file
{
"servers": {
"tsetmc-tehran-stock-exchange": {
"type": "stdio",
"command": "uvx",
"args": [
"tsetmc-mcp"
],
"env": {
"TSETMC_MCP_PROXY": "<TSETMC_MCP_PROXY>"
}
}
}
}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>
Platform CLI
gemini mcp add -e TSETMC_MCP_PROXY=<TSETMC_MCP_PROXY> tsetmc-tehran-stock-exchange uvx tsetmc-mcpReplace <…> 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.