Skip to main content
Glama
Sign In
TSETMC History MCP

TSETMC History MCP

by mohammad-k13
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

TSETMC History MCP

Streamable HTTP MCP server for TSETMC historical market data via BrsApi. Built with TypeScript + Bun.

Twin of Codal-MCP: same transport, packaging, and test style.

Supports:

  1. Price & trade daily history (History.php type=0)

  2. Retail / institutional daily history (type=1)

  3. Field documentation as MCP resources

  4. Analysis prompts (trend + money flow + full pipeline)

Transport: Streamable HTTP only (no stdio / legacy SSE server).

For a full onboarding walkthrough of the API and this repo, read History_API_Guide.md.

Setup

bun install
cp .env.example .env
# set BRS_API_KEY=...
bun run start

Health: GET http://127.0.0.1:3000/health
MCP endpoint: http://127.0.0.1:3000/mcp

Related MCP server: tsetmc-mcp

Tools

Tool

Upstream

Purpose

get_price_history

type=0

Daily price/trade bars (date, tvol, pc, …)

get_client_type_history

type=1

Daily حقیقی/حقوقی counts, volumes, values

list_history_fields

local

Catalog of both modes and field names

Both history tools accept l18 plus optional date_start / date_end (client-side filter).

Prompts

Prompt

Purpose

analyze_price_trend

Analyze price/trade JSON

analyze_money_flow

Analyze retail vs institutional JSON

history_agent_pipeline

End-to-end fetch + analyze checklist

Resources

URI

Content

history://fields

Index of modes

history://fields/price

Type 0 field black doc

history://fields/client-type

Type 1 field black doc

Markdown sources live in src/resources/docs/.

Cursor / client config example

{
  "mcpServers": {
    "tsetmc-history": {
      "url": "http://127.0.0.1:3000/mcp"
    }
  }
}

Tests

bun test

Tests cover every tool, field resource, and prompt via an in-process Streamable HTTP client (handler.fetch). No live API key required.

Env

Variable

Required

Description

BRS_API_KEY

yes (live API)

BrsApi key (HISTORY_API_KEY alias also accepted)

PORT

no

Default 3000

HOST

no

Default 127.0.0.1

MCP_PATH

no

Default /mcp

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • bource

    a-saeedia
    A
    license
    A
    quality
    B
    maintenance
    Read-only MCP server for Tehran Stock Exchange (TSETMC) live market data and authenticated TSE portal pages, enabling quotes, order books, market watch, and session-safe page reads via natural language.
    11
    1
    MIT

  • tsetmc-mcp

    sepehr071
    A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to read Tehran Stock Exchange and Iran Fara Bourse market data—quotes, top movers, order books, price history, sector indices, and real vs legal trading—through read-only tools. Requires no API key, returning compact JSON in Rial directly to Claude, Cursor, or Copilot.
    8
    79 PyPI
    3
    MIT

  • codal-mcp

    sepehr071
    A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to search and read Iranian listed companies’ Codal disclosures, including financial statements, EPS and monthly activity reports as tables, meeting decisions, and PDF/Excel links, plus company and fiscal-year lookups.
    5
    7
    MIT

  • fipiran-mcp

    sepehr071
    A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to search, rank, and compare Iranian mutual funds and ETFs; inspect NAV, returns, size, flows, investors, and managers; and retrieve Tehran and Farabourse market overviews, indices, stock quotes, and industry data read-only without an API key.
    11
    MIT