FTShare MCP
A hosted MCP server for financial data: quotes, filings, macro statistics and FTShare's own factors, read-only
- 257 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The API key goes to an external hosted service with every request
- The text of your questions reaches the FTShare server, and there is no server source to inspect
Install
- Works in
Manual install
claude mcp add --transport http --scope user --header "FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY" ftshare https://market.ft.tech/gateway/mcpReplace YOUR_FTSHARE_API_KEY with your key. Verify with /mcp in Claude Code.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The API key goes to an external hosted service with every request
- The text of your questions reaches the FTShare server, and there is no server source to inspect
This is third-party code. Review the repository files before installing.
What it does
FTShare MCP connects Claude Code, Codex and other clients that support Streamable HTTP to the FTShare financial data service. The agent asks in natural language, the client calls a tool and a structured, checkable result comes back. Every tool only reads data. The service covers China's equity market: quotes, candlestick charts, daily limit moves, capital flows and company data. It also has ETFs, indices, funds, futures, bonds, precious metals, Hong Kong and US securities, macroeconomics, announcements, research reports and news. FTShare's own factors include news sentiment, candlestick pattern annotations, top-K correlations and signal snapshots. The repository holds documentation, parameter descriptions and connection examples, and contains no server source. The server is hosted by FTShare and access needs an API key in the FTSHARE_API_KEY header. The exact tool list and schemas come from the server's own tools/list call.
Who it is for. For analysts and developers who ask Claude Code or Codex for China market data and want it structured, with the service's own factors.
Good fit when
- You need a China A-share query inside an agent chat, such as a candlestick chart or capital flow for ticker 000089
- You want a pattern annotation such as a rising flag, with an image and the reasoning: ft_v3_kline_pattern_annotations and ft_v3_kline_pattern_image exist for this
- An analyst collects ETFs, funds, futures, bonds and macro indicators in one client without separate SDKs
- Research needs news with a sentiment factor and top-K correlations across stocks
- You are building your own client and want to walk the initialize, tools/list, tools/call sequence by protocol
Not a fit when
- You need Russian issuers' quotes and filings: the described coverage is built around China, plus Hong Kong and the US
- You want to trade or place orders: the tools only read data
- You need a standalone server without an external service: there is no source code and every request goes to FTShare's server
- You have no API key: without the FTSHARE_API_KEY header the service will not answer
- You need free data with no quotas: the MIT license covers the documentation and gives no access, data rights or request volume
Example request
Use FTShare to find the rising flag annotation for security 000089 on 1 September 2026 and show the reasoning and the imageMCP
- Transport
- http
- Authentication
- API key
Environment variables
FTSHARE_API_KEYrequired, secret- API key from the FTShare account, sent as an HTTP request header
Limitations
- The service is hosted by FTShare. The repository has no server source, only documentation and examples.
- Access uses an API key from an account at ftai.chat. Data rights, request volume and plans depend on the account, and the MIT license does not cover them.
- The number of tools, their names and parameters change, and tools/list shows the current state.
- Error codes are documented: MISSING_PARAMETER, INVALID_TYPE, UNKNOWN_PARAMETER, INVALID_ARGUMENT, UPSTREAM_REJECTED and UPSTREAM_UNAVAILABLE. The last one says whether to retry.
- Documentation and the interface are in Chinese, with an English README.
How to disable. In Claude Code run claude mcp remove ftshare. In Codex delete the mcp_servers.ftshare block from ~/.codex/config.toml and start a new task. The API key can be reissued in the FTShare account.
FAQ
How do I connect FTShare MCP to Claude Code?
Get an API key from your FTShare account and run claude mcp add --transport http --scope user --header "FTSHARE_API_KEY: key" ftshare https://market.ft.tech/gateway/mcp. Then open /mcp and confirm ftshare is connected.
How do I add FTShare to Codex?
Add an mcp_servers.ftshare block with the URL https://market.ft.tech/gateway/mcp and http_headers containing FTSHARE_API_KEY to ~/.codex/config.toml. Verify with codex mcp get ftshare and start a new task so tool definitions reload.
What data does FTShare MCP return?
China equities, ETFs, indices, funds, futures, bonds, precious metals, Hong Kong and US securities, macroeconomics, announcements, research reports and news. Its own factors include news sentiment, candlestick pattern annotations, top-K correlations and signal snapshots.
What are the Python SDK and the skill in the FTShare ecosystem?
Three ways into one service. The Python SDK returns data as pandas DataFrames for code and research, MCP suits agent clients, and the skill routes natural-language requests inside Claude Code, Codex and OpenClaw.
Can I commit the key to a repository?
No. The author asks you not to send the key to Git, Issues, logs or public screenshots, and not to publish a Codex config containing it.
Discussion
No questions or reviews yet.
Related
MCP serversFinancial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
A local database of China A-share and ETF market data with an MCP server for natural-language queries
An akshare-based MCP server with quotes, indicators and news for China, Hong Kong and US stocks, plus cryptocurrency data
MCP server and HTTP API on AKShare: the agent finds Chinese market data interfaces, reads their parameters and fetches tables
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
A server feeds agents quotes for A-shares, Hong Kong and US stocks, indicators, funds, futures and options, plus four skills.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| FTShare MCP (this card) | yes | API key | 257 | |
| FinanceMCP | no | key is optional | 869 | a server with data through Tushare and Binance that runs on your machine, while FTShare is a hosted service with a key |
| Financial Datasets MCP | yes | API key | 2,318 | US company financials, stock and crypto prices, while FTShare focuses on China and its own factors |
README in short
The README explains that the repository holds documentation while the server is hosted by FTShare, and walks through getting a key, configuring Claude Code and Codex and an example request with a result table. It then lists three access routes to the service, the data coverage, a link to live interface documentation, the protocol call order and an error table.