SSI Stock

v1.0.0Finance & Fintechstable

VN Stock intraday data MCP server (using SSI FastConnect API)

ssi-stockmcpai-integration
Share:
16
Stars
0
Downloads
0
Weekly
0/5

What is SSI Stock?

SSI Stock is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to vn stock intraday data mcp server (using ssi fastconnect api)

VN Stock intraday data MCP server (using SSI FastConnect API)

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • VN Stock intraday data MCP server (using SSI FastConnect API

Use Cases

Retrieve Vietnamese stock intraday trading data.
Access SSI FastConnect API for market analysis.
archiephan78

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedDec 17, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx ssi-stock

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use SSI Stock

The SSI Stock MCP server provides Vietnamese stock market data by connecting to the SSI FastConnect API, giving AI assistants access to real-time and intraday OHLC data, index components, and live pricing for securities listed on the Ho Chi Minh and Hanoi Stock Exchanges. It exposes eight dedicated tools covering everything from listing available securities to retrieving tick-level trading data, making it useful for analysts and developers building AI-powered tools for the Vietnamese financial market.

Prerequisites

  • Python 3.10 or later installed
  • An SSI FastConnect API account with a Consumer ID and Consumer Secret (register at iboard.ssi.com.vn)
  • uv or pip for Python package management
  • An MCP-compatible client such as Claude Desktop
1

Install via Smithery CLI

The recommended installation method uses the Smithery CLI, which handles configuration automatically for Claude Desktop.

npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude
2

Obtain SSI FastConnect credentials

Log in to your SSI iBoard account and navigate to the FastConnect API section to generate a Consumer ID and Consumer Secret. These are required for all API calls.

3

Configure environment variables

Set your SSI credentials as environment variables. FC_DATA_URL and FC_DATA_AUTH_TYPE have defaults but can be overridden if SSI changes their endpoint.

export FC_DATA_CONSUMER_ID=your_consumer_id
export FC_DATA_CONSUMER_SECRET=your_consumer_secret
# Optional overrides:
# export FC_DATA_URL=https://fc-data.ssi.com.vn/
# export FC_DATA_AUTH_TYPE=Bearer
4

Add to Claude Desktop config manually

If not using Smithery, add the server block to your Claude Desktop configuration file with the required environment variables.

{
  "mcpServers": {
    "ssi-stock": {
      "command": "uvx",
      "args": ["ssi-stock-mcp-server"],
      "env": {
        "FC_DATA_CONSUMER_ID": "your_consumer_id",
        "FC_DATA_CONSUMER_SECRET": "your_consumer_secret"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop and check that the SSI Stock tools appear. Try asking for the list of securities on HOSE to confirm the connection is working.

SSI Stock Examples

Client configuration

Claude Desktop config with SSI FastConnect credentials passed as environment variables.

{
  "mcpServers": {
    "ssi-stock": {
      "command": "uvx",
      "args": ["ssi-stock-mcp-server"],
      "env": {
        "FC_DATA_CONSUMER_ID": "your_consumer_id",
        "FC_DATA_CONSUMER_SECRET": "your_consumer_secret",
        "FC_DATA_URL": "https://fc-data.ssi.com.vn/"
      }
    }
  }
}

Prompts to try

Sample queries for Vietnamese stock market analysis using the eight available tools.

- "List all securities available on the HOSE exchange"
- "Get today's intraday OHLC data for VNM stock"
- "What are the components of the VN30 index?"
- "Show me the daily price history for VIC over the last 30 days"
- "What is the current price of HPG and how does it compare to yesterday's close?"

Troubleshooting SSI Stock

Authentication error or 401 response from SSI API

Double-check that FC_DATA_CONSUMER_ID and FC_DATA_CONSUMER_SECRET are set correctly without extra spaces or quotes. Verify your SSI FastConnect subscription is active and that you are using the correct authentication type (Bearer by default).

Empty results or no data returned for a stock symbol

Ensure the stock ticker symbol is in the correct format for the SSI API (usually uppercase, e.g. 'VNM' not 'vnm'). Also verify the exchange code is correct — HOSE for Ho Chi Minh, HNX for Hanoi.

Server fails to start after Smithery install

Run 'npx -y @smithery/cli list' to confirm the server was registered. If it shows an error, try reinstalling with '--force' flag. Ensure Python 3.10+ is available in your PATH.

Frequently Asked Questions about SSI Stock

What is SSI Stock?

SSI Stock is a Model Context Protocol (MCP) server that vn stock intraday data mcp server (using ssi fastconnect api) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install SSI Stock?

Follow the installation instructions on the SSI Stock GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with SSI Stock?

SSI Stock works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is SSI Stock free to use?

Yes, SSI Stock is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "ssi-stock": { "command": "npx", "args": ["-y", "ssi-stock"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use SSI Stock?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides