SSI Stock Data MCP
About
Query Vietnam stock intraday data using the SSI FastConnect API.
Details
- Author
- archiephan78
- Categories
- Database, Finance, Other, API
Jump to
Setup
Install SSI Stock Data MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/archiephan78/ssi-stock-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
Query Vietnam stock intraday data using the SSI FastConnect API.
- Table of Contents
- 1. Introduction
- 2. Features
- 3. Quickstart
- 3.1. Prerequisites
- 3.2. Local Run
- 3.3. Docker Run
SSI Stock Data MCP is aModel Context Protocol(MCP) server for get VietNam stock intraday data. It enables AI assistants and tools to query intraday data usingSSI FastConnect APIprogrammatically and securely.
- List of stock codes by exchange
- Retrieve detailed information of a stock code
- Retrieve the list of stock codes in an index basket
- Retrieve the list of index codes
- Retrieve the open, high, low, close, volume, and value information of a stock code by each tick data
- Retrieve the open, high, low, close, volume, and value information of a stock code by day
- Retrieve the daily trading results of the composite index
- Retrieve the daily trading information of a stock code
- Docker containerization support
- Support get realtime data via streaming adapter (planning)
- Support order management and trading via MCP (future consideration)
- Python 3.12+
- uv(for fast dependency management).
- Docker (optional, for containerized deployment).
- Ensure you register for SSI FastConnect service before running this MCP server. You can register atSSI FastConnectto get your consumer ID and secret.
To install SSI Stock MCP Server for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude
# Clone the repository $ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git
# Set environment variables (see .env.sample) FC_DATA_URL=https://fc-data.ssi.com.vn/ #optional FC_DATA_AUTH_TYPE=Bearer #optional FC_DATA_CONSUMER_ID=your_consumer_id FC_DATA_CONSUMER_SECRET=your_consumer_secret
- Add the server configuration to your client configuration file. For example, for Claude Desktop:
{ "mcpServers": { "SSIStockMCPServer": { "command": "uv", "args": ["--directory", "full-path", "run", "ssi-stock-mcp-server"], "env": { "FC_DATA_CONSUMER_ID": "id", "FC_DATA_CONSUMER_SECRET": "id", "FC_DATA_URL": "https://fc-data.ssi.com.vn/", "FC_DATA_AUTH_TYPE": "Bearer" } } } }
- Restart Claude Desktop to load new configuration.
- You can now ask Claude to interact with data using natual language:
- "chỉ số VN30 hôm nay có gì hot không"
- "get volume room ngoại đã bán của SSI hôm nay"
- "so sánh vol của SSI với VND trong ngày hôm nay"
- "total matchvol của SSI trong 1 tuần trở lại đây"
- Run it with pre-built image (or you can build it yourself):
$ docker run -p 8000:8000 -e FC_DATA_CONSUMER_ID=id -e FC_DATA_CONSUMER_SECRET=id ghcr.io/archiephan78/ssi-stock-mcp-server
{ "mcpServers": { "SSIStockMCPServer": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "FC_DATA_CONSUMER_ID", "-e", "FC_DATA_CONSUMER_SECRET", "ghcr.io/archiephan78/ssi-stock-mcp-server:latest" ], "env": { "FC_DATA_CONSUMER_ID": "your_username", "FC_DATA_CONSUMER_SECRET": "your_password" } } } }
This configuration passes the environment variables from Claude Desktop to the Docker container by using the-eflag with just the variable name, and providing the actual values in theenvobject.
- Get securities list:get_securities_list()
- Get securities detail:get_securities_details()
- Get index:get_index_components()
- Get list index:get_index_list()
- Get daily open,high,low,close:get_daily_ohlc()
- Get intraday open,high,low,close:get_intraday_ohlc()
- Get daily index:get_daily_index()
- Get stock price:get_stock_price()
Seesrc/ssi_stock_mcp_server/server.pyfor full API details.
Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.
This project usesuvto manage dependencies. Install uv following the instructions for your platform.
# Clone the repository $ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git $ uv venv $ source .venv/bin/activate # On Unix/macOS $ .venv\Scripts\activate # On Windows $ uv pip install -e . # run test $ pytest
- Please open an issue on GitHub if you encounter any problems or need support.
- Email: n/a
Provides real-time financial market data using the Alpha Vantage API.
A stock market data service for querying A-share market data from Sina and Tencent Finance.
Perform financial analysis using the DART API and Claude.
Funding rounds, acquisitions & exec moves — deduped, enriched, typed. Query over REST, stream over webhooks, or hand to your agent over MCP. 50 free credits.
Access financial datasets from the Federal Reserve Economic Data (FRED) API.
Provides real-time financial data using the Tushare API.
Provides real-time financial data from Yahoo Finance.
Access US Treasury data via the Fiscal Data API to fetch statements, historical data, and generate reports.
Real-time forex macroeconomic API for all major currency pairs sourced from central bank announcements.
Retrieve and process economic data from the International Monetary Fund (IMF) API, including datasets, time series, indicators, and countries.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
