block_trade
Returns block trades, including price, size and the brokerages on both sides.
LABSCO SUMMARY
It saves assembling a Chinese-market data stack out of five separate APIs.
The tools are grouped by the question rather than by the endpoint: one call covers price history across A-shares, Hong Kong, US, FX, futures and crypto, and another covers a company's entire filing set. Desk-level data becomes answerable in the conversation — money flow, margin balances and the dragon-tiger institutional detail usually sit behind a terminal.
What it is
A server over Chinese and international market data: price history and minute bars across A-shares, US and Hong Kong equities, FX, futures, funds, convertible bonds, options and crypto; company fundamentals for three markets; macro series; fund, margin, block-trade and capital-flow data; and financial news. Each answer says which source it came from, and reports the fallback path when the first source could not serve it.
What you get
- Price history across markets from one tool (stock_data), with minute-level bars for A-shares and crypto (stock_data_minutes)
- Fundamentals for three markets — company_performance for A-shares, company_performance_hk and company_performance_us — covering statements, ratios, dividends, revenue breakdown and shareholder changes
- The macro series a note needs: Shibor, LPR, GDP, CPI, PPI, money supply, PMI, aggregate financing, Libor and Hibor (macro_econ)
- Positioning and flow — money_flow for stock, market, sector and northbound money, plus margin_trade, block_trade, dragon_tiger_inst and futures_data
- Funds and convertibles: fund_data for lists, NAV, holdings and managers, fund_manager_by_name for one manager's record, convertible_bond for issuance, redemption and conversion terms
- Indices, including CSI constituent weights and valuation summaries (index_data, csi_index_constituents)
- Financial media searched by keyword (finance_news), a rolling 7x24 feed (hot_news_7x24), and current_timestamp so "yesterday" resolves in China time
- Crypto quotes straight from Binance's public API, which needs no account of its own
- Both transports: stdio locally, or Streamable HTTP with the credentials passed as request headers instead of environment variables
Requirements
Node.js 20 or newer, and a Tushare Pro token in TUSHARE_TOKEN — or the X-Tushare-Token header over HTTP. Tushare gates its interfaces by points, and the market-wide money_flow and the futures position rankings each need 2000, which is also what a verified student account is granted. QVERIS_API_KEY adds Qveris as a second source; leave it out and Qveris is never called and never billed. FINANCE_SOURCE_PRIORITY sets the order the sources are tried in. Crypto goes to Binance's public endpoints, so no exchange account is involved. MIT licensed.
Setup effort
One command plus a key — npx -y finance-mcp, then supply credentials
USE CASES
01
Looking at how a stock has traded
Pull the daily history, then drop to minute bars for the session that moved, without changing tools between markets.
02
Reading a company before writing about it
Statements, ratios, dividends and revenue breakdown come back together — and the Hong Kong and US listings have their own calls.
03
Working out who has been buying
Follow the money flow by stock and sector, check margin balances, and read the institutional detail off the dragon-tiger list.
04
Putting a macro number in context
Pull the series — CPI, PPI, GDP, money supply, LPR or Shibor — and read the news around the print in the same thread.
05
Comparing funds properly
List the funds, read the NAV history and holdings, then look up the manager's record before deciding.
06
Checking an index and what is inside it
Read the index level, then the constituent weights and their valuation summary from the CSI data.
19 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
company_performance
Returns the full picture for an A-share listed company: earnings pre-announcements and flash reports, financial ratios, dividends and bonus issues, revenue breakdown, shareholder and management changes, balance sheet, cash flow and income statement, daily valuation metrics and new-listing data.
company_performance_hk
Returns income statement, balance sheet and cash flow for Hong Kong-listed companies.
company_performance_us
Returns financial statements and financial ratios for US-listed companies.
convertible_bond
Returns convertible bond lifecycle data: issuance, forced redemption, conversion, coupon rates, ratings and top-ten holders.
csi_index_constituents
Returns CSI index range performance, constituent weights, and a valuation and financial summary covering PE TTM, PB, dividend yield, ROE, ROA, net margin, operating cash flow per share, debt ratio, revenue growth, asset turnover, gross margin and cash dividend ratio.
current_timestamp
Returns the current timestamp in China Standard Time (UTC+8), to the second.
dragon_tiger_inst
Returns institutional trade detail from the daily dragon-tiger disclosure board, including buy and sell totals, net amount and the reason a stock was listed.
finance_news
Searches mainstream financial media for news, by a single keyword or several at once.
fund_data
Returns public fund and ETF data: fund lists, managers, NAV, distributions, holdings, fund companies, ETF adjustment factors, sales AUM and listed-fund factors.
fund_manager_by_name
Returns a fund manager's details by name — the funds they run, their background and their track record.
futures_data
Returns futures position rankings by broker seat; this version covers holdings only.
hot_news_7x24
Returns the latest rolling news across finance, politics, technology, sport, entertainment, military, society and international affairs.
index_data
Returns index data: daily, weekly and monthly bars, major international indices, and index profile and valuation figures.
macro_econ
Returns macroeconomic series: Shibor, LPR, GDP, CPI, PPI, money supply, PMI, aggregate financing, Shibor quotes, Libor and Hibor.
margin_trade
Returns margin trading and securities lending data: eligible stocks, daily summaries, per-trade detail and refinancing summaries.
money_flow
Returns capital flow for a stock, the whole market, a sector or northbound money — net inflow and share by order size, plus Stock Connect volumes and holdings.
stock_data
Returns historical price data for A-shares, US and Hong Kong stocks, FX, futures, funds, bond reverse repos, convertible bonds, options and crypto (crypto via Binance).
stock_data_minutes
Returns minute bars for A-shares and crypto at 1, 5, 15, 30 or 60-minute intervals over a start and end datetime.
BEFORE YOU INSTALL
What to know first
Tools you get
19 tools when we connected. Which tools appear depends on credentials: with no token only current_timestamp and finance_news are listed, a Tushare token or Qveris key each adds its own set, and both together show all 19.
Requires
- npx on PATH
- TUSHARE_TOKEN in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 19 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y finance-mcpMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"finance-mcp": {
"command": "npx",
"args": [
"-y",
"finance-mcp"
],
"env": {
"TUSHARE_TOKEN": "<YOUR_TUSHARE_TOKEN>",
"QVERIS_API_KEY": "<YOUR_QVERIS_API_KEY>",
"FINANCE_SOURCE_PRIORITY": "tushare,qveris,binance"
}
}
}
}
