home / mcp / ssi stock data mcp server

SSI Stock Data MCP Server

Provides access to Vietnamese stock intraday and daily data via an MCP server for querying securities, indices, and price data.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "archiephan78-ssi-stock-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "full-path",
        "run",
        "ssi-stock-mcp-server"
      ],
      "env": {
        "FC_DATA_URL": "https://fc-data.ssi.com.vn/",
        "FC_DATA_AUTH_TYPE": "Bearer",
        "FC_DATA_CONSUMER_ID": "your_consumer_id",
        "FC_DATA_CONSUMER_SECRET": "your_consumer_secret"
      }
    }
  }
}

You can query Vietnam stock intraday data programmatically using the SSI Stock Data MCP Server. It exposes a set of data retrieval actions via a Model Context Protocol interface, enabling AI assistants and tools to fetch securities, indices, and intraday daily OHLCV data securely and at scale.

How to use

You connect to the SSI Stock Data MCP Server through an MCP client. The server offers actions to list securities, get security details, retrieve index components, and fetch both intraday and daily OHLCV data. Use natural language prompts or your client’s API to request the data you need, such as current day volume, intraday price ranges, or daily index values. Ensure your client is configured with the correct consumer credentials from SSI FastConnect and points to the MCP server you are using (local or containerized). The server supports both local execution and Docker-based deployment, so you can run it directly on your machine or inside a container for isolation and easy sharing.

How to install

Prerequisites: You should have Python 3.12 or newer and uvx for dependency management. Docker is optional if you plan to run the MCP server inside a container.

Install and run the MCP server locally using the uv-based workflow described here. Follow the steps to clone the repository, set up environment variables, and run the server with the local command.

Configuration and usage notes

Set up your SSI FastConnect consumer credentials and optional data URL and authentication type in environment variables for your MCP client. Required variables include your consumer ID and secret. Optional variables can configure data URL and auth type if you are connecting to a specific data gateway.

Two practical ways to run the server are shown below. Use the method that fits your workflow best: a local uv-based run or a Docker-based run.

Additional content

Local run configuration example for Claude Desktop or similar MCP clients: you start the server with uv and point to the server directory, while passing the necessary environment variables to enable access to the SSI FastConnect data.

Docker run configuration example lets you run the MCP server in a container and pass credentials through the environment. This is convenient for isolated environments or sharing across teammates.

Troubleshooting and notes

If you encounter authentication errors, verify that FC_DATA_CONSUMER_ID and FC_DATA_CONSUMER_SECRET are correct and that FC_DATA_URL and FC_DATA_AUTH_TYPE (when used) are properly configured. Ensure the MCP client reloads configuration after you start or restart the server.

Available tools

get_securities_list

Retrieve the list of stock codes by exchange.

get_securities_details

Retrieve detailed information for a specific stock code.

get_index_components

Get the list of securities in a given index.

get_index_list

Retrieve the list of index codes.

get_daily_ohlc

Get daily open-high-low-close and volume data for a stock code.

get_intraday_ohlc

Get intraday open-high-low-close and volume data for a stock code.

get_daily_index

Retrieve daily trading information for a composite index.

get_stock_price

Get current stock price data.