Skip to main content
Glama
angeliaz

finance-data-mcp

by angeliaz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

finance-data-mcp

A Model Context Protocol (MCP) server that provides unified financial data access across multiple markets and data sources.

Features

  • πŸ‡ΊπŸ‡Έ US / ETF: Alpha Vantage (primary) β†’ yfinance (fallback)

  • πŸ‡¨πŸ‡³ A-share: Tushare (primary) β†’ AKShare (fallback) β†’ yfinance

  • πŸ‡­πŸ‡° HK stocks: AKShare (primary) β†’ yfinance (fallback)

  • πŸ’± FX rates: exchangerate-api β†’ AKShare β†’ Alpha Vantage β†’ yfinance

  • πŸ”„ Automatic fallback across data sources on failure

  • πŸ”‘ Multi-key rotation for Alpha Vantage (extends daily quota)

  • 🌐 Proxy support for AKShare (useful when running overseas)

Related MCP server: Stock Data MCP Server

MCP Tools

Tool

Description

get_stock_price

Real-time stock price with market routing

get_financial_report

Income statement, balance sheet, cash flow

get_financial_summary

PE, PB, ROE, market cap, EPS, etc.

get_fx_rate

Currency exchange rates

Quick Start

1. Install dependencies

pip install -r requirements.txt

Note: Not all data sources are required. Install only what you need:

  • akshare β€” for A-share and HK stocks

  • tushare β€” for A-share (needs token, no IP restriction)

  • yfinance β€” for all markets (fallback, no key needed)

  • requests β€” required for Alpha Vantage

2. Configure environment

cp .env.example .env
# Edit .env with your API keys

3. Run the server

python finance_data_server.py

The server runs in stdio mode (standard MCP transport).

4. Configure in your MCP client

Example configuration for MCP clients:

{
  "mcpServers": {
    "finance-data": {
      "command": "python",
      "args": ["/path/to/finance-data-mcp/finance_data_server.py"],
      "env": {}
    }
  }
}

Environment Variables

Variable

Required

Description

ALPHAVANTAGE_API_KEYS

For US stocks

Comma-separated Alpha Vantage API keys

TUSHARE_TOKEN

For A-share

Tushare Pro API token

AKSHARE_PROXY

Optional

HTTP proxy for AKShare (format: http://user:pass@host:port)

Architecture

finance_data_server.py          # MCP Server entry point + MarketRouter
β”œβ”€β”€ datasources/
β”‚   β”œβ”€β”€ alpha_vantage_adapter.py  # US/ETF stocks (Alpha Vantage API)
β”‚   β”œβ”€β”€ akshare_adapter.py        # A-share / HK stocks (AKShare + East Money)
β”‚   β”œβ”€β”€ tushare_adapter.py        # A-share stocks (Tushare Pro API)
β”‚   └── yfinance_adapter.py       # All markets fallback (Yahoo Finance)
β”œβ”€β”€ alpha_vantage_client.py       # Alpha Vantage HTTP client
└── alpha_vantage_rate_limiter.py # Per-key rate limiting with persistence

Data Flow

MCP Client Request
       β”‚
       β–Ό
  MarketRouter (routes by market type)
       β”‚
       β”œβ”€ US/ETF ──→ AlphaVantage β†’ yfinance
       β”œβ”€ A-share ──→ Tushare β†’ AKShare β†’ yfinance
       └─ HK ──────→ AKShare β†’ yfinance

Standardized Output

All adapters return data in a unified format:

Price Response

{
  "symbol": "AAPL",
  "market": "US",
  "price": 185.50,
  "change": 2.30,
  "change_pct": 1.25,
  "volume": 52340000,
  "high": 186.20,
  "low": 183.10,
  "open": 183.80,
  "previous_close": 183.20,
  "currency": "USD",
  "source": "alpha_vantage"
}

Financial Report Response

{
  "symbol": "AAPL",
  "market": "US",
  "report_type": "income_statement",
  "period": "annual",
  "data": [
    {
      "period": "2024-09-30",
      "revenue": 391035000000,
      "net_income": 93736000000,
      "eps_basic": 6.11
    }
  ],
  "count": 5,
  "source": "alpha_vantage"
}

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Stock Data MCP Server

    wallacetju
    F
    license
    Not graded
    quality
    C
    maintenance
    Provides comprehensive stock market data across US, Hong Kong, and Chinese markets, combining real-time quotes, historical data, fundamentals, and financial statements from multiple sources including Yahoo Finance, Finnhub, Tushare, and Futu OpenAPI.
    -

  • Stock Data MCP Server

    stockmcp
    A
    license
    B
    quality
    C
    maintenance
    Provides comprehensive data for A-shares, Hong Kong, and US stocks alongside cryptocurrency markets, supporting technical indicators, news, and financial statements. It features automatic failover across multiple data sources to ensure reliable access to real-time and historical market information.
    47
    34
    MIT
  • TickDB MCP by TickDB

    TickDB MCPofficial

    TickDB
    A
    license
    Not graded
    quality
    B
    maintenance
    Unified real-time & historical market data API for Forex, stocks (US/HK/A-share), crypto, indices & precious metals. Tick, order book depth & K-line via REST + WebSocket. AI-native: MCP server, Skill & CLI.
    881
    MIT
  • drillr-mcp-server by Little-Grebe-Inc

    drillr-mcp-serverofficial

    Little-Grebe-Inc
    A
    license
    Not graded
    quality
    B
    maintenance
    Financial data and research MCP for AI agents: filings with full-text and fact search, statements as reported, earnings, insider and institutional ownership, corporate events, executives, analyst data, company discovery and research signals for US, China and Japan equities. Every figure traced to its filing. Browser sign-in.
    9
    MIT