Shioaji MCP Server

Shioaji MCP Server is an MCP server that connects AI assistants to the SinoPac Securities Shioaji trading API. Built for retail traders, quantitative developers, and financial analysts using SinoPac Securities in Taiwan, the server exposes standardized tools for market analysis and portfolio management directly within MCP-compatible environments. Users can search for financial contracts across markets, retrieve real-time market snapshots, and download historical k-bar candlestick data to conduct technical evaluations. Beyond market intelligence, the server allows clients to inspect account balances, monitor open stock and futures positions, review existing orders, and verify terms-of-service compliance. For active trading operations, users can explicitly enable order placement and cancellation capabilities through a dedicated configuration flag. By default, the server operates in a read-only state to prevent unauthorized transactions while letting conversational models analyze live financial metrics. Deployment is managed through prebuilt Docker containers requiring valid SinoPac API keys, delivering a contained environment compatible with Linux and macOS setups.

Category: Finance, Crypto & Payments

Tags: financial-data, securities, sinopac, stocks, trading

Visit Shioaji MCP Server

How to install and configure Shioaji MCP Server

1. Ensure you have an active SinoPac Securities account, API credentials, and have completed terms of service compliance testing. 2. Pull the official Docker image: bash docker pull ghcr.io/musingfox/shioaji-mcp:latest 3. Add the server configuration to your MCP client config file (such as Claude Desktop): json { "mcpServers": { "shioaji": { "command": "docker", "args": [ "run", "--rm", "-i", "--platform=linux/amd64", "-e", "SHIOAJI_API_KEY=your_api_key", "-e", "SHIOAJI_SECRET_KEY=your_secret_key", "-e", "SHIOAJI_TRADING_ENABLED=false", "ghcr.io/musingfox/shioaji-mcp:latest" ] } } } 4. Set SHIOAJI_TRADING_ENABLED to "true" if you intend to execute orders, or leave it as "false" for read-only access. 5. Restart your MCP client to establish the connection.

What you can do with Shioaji MCP Server

• Query real-time market snapshots and contract details for Taiwanese stocks and futures to inform investment discussions. - Download historical k-bar candlestick data over specified intervals to perform technical chart and trend analysis. - Inspect current account balances, margins, and portfolio positions across stock and futures accounts in read-only mode. - Execute buy or sell orders and cancel active trades using conversational commands when trading permissions are enabled. - Validate account connection status and check terms of service compliance before initiating automated trading workflows.

Key facts

• Paid
• https://github.com/offbeat-studio/shioaji-mcp
• Finance, Crypto & Payments
• financial-data, securities, sinopac, stocks, trading

Part of MCP Servers

What can Shioaji MCP Server do?

Shioaji MCP Server allows language models to interface with SinoPac Securities. It provides tools to search contracts, pull real-time market snapshots, retrieve historical candlestick data, check account balances, and view open positions. When trading features are explicitly enabled via configuration, it also supports submitting and cancelling trade orders.

How do I install Shioaji MCP Server?

The recommended method is running the official Docker container from the GitHub Container Registry. Pull ghcr.io/musingfox/shioaji-mcp:latest and add a docker run command to your MCP client configuration, supplying your SinoPac API key, secret key, and platform flags in the environment variables.

Is trading enabled by default in Shioaji MCP Server?

No, trading operations are disabled by default for safety. Tools such as place_order and cancel_order will not function unless you explicitly configure SHIOAJI_TRADING_ENABLED to true in your server environment variables. In the default configuration, the server operates exclusively in read-only mode.

Is Shioaji MCP Server open source?

Yes, Shioaji MCP Server is an open-source project released under the permissive MIT license. You can inspect the source code, report issues, contribute modifications, or build custom Docker images directly from the official GitHub repository maintained by offbeat-studio.

What prerequisites are needed before using Shioaji MCP Server?

You need an active SinoPac Securities account in Taiwan, along with approved API credentials consisting of an API Key and Secret Key. Additionally, users must review and sign the required service terms and complete SinoPac API compliance testing before connecting to live services.