Usage Instructions

You can use our MCP tools built on the SDK for Tiger OpenAPI on any platform that supports MCP. If you haven't opened Tiger OpenAPI yet, please read Preparation to complete the permission application and obtain necessary information such as tiger id, private key, etc.

Install [uv]

If you are using macOS/Linux systems, open "Terminal" and run the following command to complete the installation:

curl -LsSf https://astral.sh/uv/install.sh | sh

Note: [uv] is a Python package and environment management tool, used here to run MCP Server.

Add MCP Server

Find the MCP entry in the tool you are using, select Manual Configuration, and paste the following content.

Please replace your tiger id, your private key, and your account id with your actual values; also, if you want the server to run in read-only mode (disable trading operations), set TIGERMCP_READONLY to true, otherwise set to false.

{
  "mcpServers": {
    "tigermcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "tigermcp"
      ],
      "env": {
        "TIGEROPEN_TIGER_ID": "your tiger id",
        "TIGEROPEN_PRIVATE_KEY": "your private key",
        "TIGEROPEN_ACCOUNT": "your account id",
        "TIGERMCP_READONLY": true
      }
    }
  }
}

macOS 12 or earlier mcp server error and solutions

If the system is macOS 12 or earlier, you may encounter the following error when running mcp server:

/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: realpath: command not found
/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: /Users/tiger/python: No such file or directory
/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: exec: /Users/tiger/python: cannot execute: No such file or directory

This is due to the missing realpath command, which needs to be installed. First, open the terminal and type brew -v to check if the brew command exists. If an error occurs indicating the command doesn't exist, you need to install it first:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Then, use brew to install coreutils:

brew install coreutils

After installation, you can try running the mcp server again.

Disclaimer

TIGER MCP only provides users with a tool to connect AI with TIGER API. The actual output results depend on AI tool characteristics and the capabilities of the connected large language models. Differences in reasoning, classification, and data processing capabilities, as well as platform limitation factors, may all affect the accuracy and completeness of results. Specific risks include but are not limited to: time understanding bias, data analysis errors, information truncation and loss, and tool call failures.
All investment decisions or other operations made through the use of TIGER MCP should be independently evaluated and judged by TIGER API users who should possess relevant knowledge and improve related security and permission management. TIGER API users will bear all related risks and responsibilities themselves. We make no guarantees regarding the accuracy, completeness, reliability, and timeliness of the output results of related AI tools and models, nor do we assume any responsibility for any legal liability, economic losses, or tax issues arising therefrom.