← Back to directory
F

FinanceMCP

Community
A professional financial data MCP server based on the MCP protocol, integrating Tushare API to provide real-time financial data and technical indicator analysis for AI assistants like Claude.
GitHub source repository ↗
★ 652 Stars Category · Other Very popular Source revision ee06b92d8f81
50FMRS · D
Reliability
5/20
Security and permissions
9/20
Maintenance
10/20
Documentation
13/20
Setup experience
13/20

Overall, FinanceMCP is a powerful and comprehensive financial data MCP server, offering a wide range of tools and flexible data source integration. However, it is limited by Tushare API permissions and third-party data sources; users should be aware of credit limits and stability. It is a non-official project, suitable for individuals and investment enthusiasts; production environments require careful evaluation.

Read the FMRS scoring method →

FinanceMCP (Synapse) is a professional financial data MCP server built on the MCP protocol, integrating Tushare API and Binance API to provide comprehensive real-time financial data access for language models like Claude. It supports multi-dimensional financial data analysis including stocks, funds, bonds, macro economics, stablecoins, cryptocurrencies, and more. It includes tools for financial data queries, financial news, national statistics data, etc. The project is linked with MarkiNote to form the FinNote intelligent financial document system, aggregating over 100 financial data interfaces and organizing them into 18 MCP tools.

Tools

current_timestamp
Returns the current timestamp, supports UTC+8 timezone, multiple output formats.
finance_news
Searches financial news via Baidu News crawler, supports space-separated multi-keyword OR filtering.
stock_data
Retrieves stock/crypto data and technical indicators, covering 10 major markets and Binance crypto, supporting 5 technical indicators (MACD, RSI, KDJ, BOLL, MA).
stock_data_minutes
Retrieves minute-level K-lines for A-shares (Tushare) and crypto (Binance), supporting multiple frequencies.
index_data
Retrieves historical data for major market indices.
csi_index_constituents
Retrieves CSI index constituents and weight summaries, including interval quotes, constituent weights, valuation/financial metrics.
macro_econ
Retrieves 11 macro economic indicators including GDP, CPI, PPI, PMI, Shibor, etc.
company_performance
A-share company financial analysis, including financial statements, management, shareholder structure, and more (13 data types).
company_performance_hk
HK stock company financial analysis, providing income statement, balance sheet, and cash flow statement.
company_performance_us
US stock company financial analysis, including 4 major financial statements and comprehensive financial metrics.
fund_data
Retrieves fund NAV, holdings, dividends, etc., with 85% performance improvement.
fund_manager_by_name
Queries fund manager background and managed fund list.
convertible_bond
Retrieves convertible bond basic information, issuance data, and conversion terms.
block_trade
Retrieves block trade details and counterparty information.
money_flow
Queries capital flow for individual stocks, market, and sectors, including main force, super large, large order analysis.
margin_trade
Retrieves margin trading data, including underlying stocks, summaries, details, and refinancing.
dragon_tiger_inst
Queries Dragon-Tiger List institutional details for a specified trading day and code.
hot_news_7x24
Retrieves 7x24 hot news based on the latest Tushare batch, deduplicated and separated by separators.

Setup

  1. Ensure Node.js >= 18. 2. Register on tushare.pro and obtain TUSHARE_TOKEN. 3. Install globally or locally via npm (npm install -g finance-mcp or npm install finance-mcp). 4. Add the MCP server configuration to Claude Desktop's config file (stdio or streamableHttp). 5. Restart Claude Desktop and verify.
claude_desktop_config.json
{
  "mcpServers": {
    "finance-mcp": {
      "type": "stdio",
      "command": "finance-mcp",
      "args": [],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_token_here"
      }
    }
  }
}

Fit and risk

Best for

  • Financial professionals and investment analysts needing real-time financial data and analysis
  • AI application developers seeking to integrate financial data capabilities
  • Researchers needing multi-market data for stocks, funds, bonds, crypto, etc.
  • Users who want intelligent Q&A via MCP clients like Claude Desktop

Not for

  • Non-financial MCP needs that do not require financial data services
  • Production environments requiring official support or enterprise-grade service guarantees
  • Users with strict data source permission requirements (need to apply for Tushare credits)

Required permissions

  • Requires a Tushare API token for access
  • Crypto data uses Binance public market endpoints, no API key required
  • stdio mode does not require network ports, but HTTP mode requires port opening and network access

Risks and side effects

  • Dependency on Tushare API; some premium data require credits, free tokens may be limited
  • Public cloud services (e.g., finvestai.top) are hosted on personal servers, risk of abuse and instability
  • Data accuracy depends on third-party sources, may have latency or errors
  • Self-hosting requires protecting sensitive keys like TUSHARE_TOKEN

Troubleshooting

  1. Ensure Node.js version >= 18
  2. Check that TUSHARE_TOKEN is correctly set
  3. Windows users may need to change command from npx to npx.cmd
  4. Check Claude Desktop logs: Windows at %APPDATA%\Claude\logs, macOS at ~/Library/Logs/Claude
  5. If using public cloud service, note rate limits; consider self-hosting

Use cases

Stock technical analysis: compute MACD, RSI, KDJ, BOLL, MA indicators.
Comprehensive analysis: combine financials, technical, capital flow, and news for investment evaluation.
CSI index constituent analysis: get constituent weights, valuation, and financial metrics.
Capital flow analysis: track capital dynamics of individual stocks, sectors, and the market.
Fund and bond queries: retrieve fund NAV, holdings, and convertible bond information.
HK and US stock financial analysis: deep dive into listed company financial statements.
Crypto analysis: view trends and technical indicators for Bitcoin and other cryptocurrencies.
Financial news and macro data: search latest news and obtain macro economic indicators.
Dragon-Tiger List queries: understand institutional buying/selling and market hotspots.

Supported clients

Claude DesktopFull support