Skip to main content
Glama
mohammad-k13

TSETMC History MCP

by mohammad-k13

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: Financial Analysis MCP Server

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

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    Enables real-time stock market analysis through AKShare API integration. Supports retrieving live stock prices, historical data, technical indicators (MA, MACD, RSI), market sentiment analysis, stock search, and financial news.
    Last updated
    5
  • -
    license
    B
    quality
    -
    maintenance
    Enables LLMs to retrieve, analyze, and visualize stock prices and financial report data for quantitative trading research and investment analysis. Provides real-time and historical stock data, financial statement analysis, key metric calculations, and trading signal visualization.
    Last updated
    13

View all related MCP servers

Related MCP Connectors

  • Provide access to Chinese stock market data including historical prices, real-time data, news, and…

  • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

  • Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mohammad-k13/TESTMC-HISTORY-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server