Skip to main content
Glama
rajithpr

Financial Data MCP Server

by rajithpr
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Financial Data MCP Server

A production-ready Model Context Protocol (MCP) server that connects AI models to real-time financial market data via the Alpha Vantage API.

Built by Rajith P R as part of a GenAI engineering portfolio, demonstrating hands-on MCP implementation, async Python, and enterprise API integration patterns.

What Is MCP?

Model Context Protocol (MCP) is an open standard by Anthropic that allows AI models (like Claude) to securely connect to external tools, APIs, and data sources. This server implements the MCP specification to expose financial data as callable tools that any compatible AI client can use.

Related MCP server: Alpha Vantage MCP Server

Tools Exposed

Tool

Description

get_stock_quote

Real-time price, change, volume, and trading range for any ticker

get_company_overview

Fundamentals: market cap, P/E ratio, EPS, dividend yield, analyst target

get_daily_prices

OHLCV time series for the last N trading days (max 30)

search_symbol

Search for ticker symbols by company name or keyword

get_market_status

Open/closed status for major global exchanges (NYSE, LSE, NSE, etc.)

Architecture

AI Client (Claude Desktop / any MCP client)
        |
        | MCP Protocol (stdio / SSE)
        v
  financial-mcp-server (FastMCP)
        |
        | HTTPS (httpx async)
        v
  Alpha Vantage Financial Data API

  • Transport: stdio (default) — MCP-standard, works with Claude Desktop out of the box

  • HTTP client: httpx with async/await for non-blocking API calls

  • Error handling: API rate limits, invalid symbols, and network failures all return structured messages

  • LLM-agnostic: No dependency on any specific AI provider — works with Claude, GPT, Gemini, or any MCP client

Quick Start

1. Clone and install

git clone https://github.com/rajithputhurath/financial-mcp-server.git
cd financial-mcp-server
pip install -r requirements.txt

2. Configure API key

cp .env.example .env
# Edit .env and add your Alpha Vantage API key
# Free key: https://www.alphavantage.co/support/#api-key
# 'demo' key works for IBM symbol only

3. Test all tools (no MCP client needed)

python tests/test_tools.py

4. Connect to Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "financial-data": {
      "command": "python",
      "args": ["/absolute/path/to/financial-mcp-server/server.py"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You will see the financial tools available in the tools panel.

Example Interactions (via Claude Desktop)

Once connected, you can ask Claude:

  • "What is Apple's current stock price?"

  • "Give me the fundamentals for Infosys"

  • "Show me Microsoft's daily prices for the last 2 weeks"

  • "Search for HSBC's ticker symbol"

  • "Are the London and New York stock exchanges open right now?"

Claude will automatically select and call the appropriate tool.

Project Structure

financial-mcp-server/
├── server.py                   # MCP server with all 5 tools
├── requirements.txt
├── .env.example                # API key template
├── claude_desktop_config.json  # Claude Desktop connection config
└── tests/
    └── test_tools.py           # CLI test runner (no MCP client needed)

Key Technical Decisions

Why FastMCP? FastMCP is the official high-level Python SDK for building MCP servers. It handles protocol negotiation, tool registration, and transport — letting the code focus on business logic.

Why async/await throughout? Financial API calls are I/O-bound. Async HTTP via httpx keeps the server responsive and avoids blocking the MCP event loop.

Why LLM-agnostic? MCP is an open protocol. This server works with Claude, GPT-4, Gemini, or any future client that implements MCP — maximising reusability.

Why Alpha Vantage? Free tier with no credit card, covers equities globally (US, UK, India, etc.), and returns clean JSON. Suitable for portfolio projects and proof-of-concept implementations.

API Limits (Free Tier)

  • 25 requests/day

  • demo API key: IBM symbol only

  • Free API key (register on Alpha Vantage): all symbols, 25 requests/day

  • Premium key: higher rate limits, real-time data

Author

Rajith P R — Senior Technical Consultant and AI Engineer
LinkedIn | rajithputhurath@gmail.com

Hands-on experience with Model Context Protocol, Python data pipelines, REST API integration, and enterprise automation at LSEG (London Stock Exchange Group).

License

MIT License. Free to use and adapt with attribution.

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

  • AlphavantageA
    io.github.pipeworx-io

    Alpha Vantage MCP — Stock market data, fundamentals, and earnings

    FinanceSearchOpen Data
    2
  • AIsa FinanceAOAuth
    one.aisa

    Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.

    CryptocurrencyFinance
    541
  • AIsa EquitiesAOAuth
    one.aisa

    Your agent needs company financials it can compute on — statements, ratios, earnings, estimates, filings and insider activity as structured data, not a PDF. **What you can ask for** • "Give me 8 quarters of income statement, balance sheet and cash flow for this ticker." • "What do analysts estimate for next quarter, and how did the last four surprise?" • "Find this exact line item across every filing." • "Who bought or sold as an insider in the last 90 days?" • "Screen for profitable companies under this valuation with growing revenue." **How to use it** Point any MCP client at https://mcp.aisa.one/marketpulse/mcp and sign in with OAuth — there is no key to create or paste. 21 tools: prices and snapshots, income statements, balance sheets, cash-flow statements, financial metrics and snapshots, earnings, analyst estimates, company facts, filings and filing items, line-item search, a screener, insider trades, macro interest rates, news, plus EDINET documents and filing digests for Japanese issuers. **Why this rather than the source** Statements as fields you can compute on, and a screener in the same place. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the fundamentals here, then ask the same agent what social is saying about the ticker — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

    FinanceResearch & Data
    261
  • ko-mcpA
    io.github.SharpLu

    Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

    FinanceGovernment Data
    242

Related MCP Servers

  • Alpha Vantage Stock Analysis

    ranveer0323
    A
    license
    D
    quality
    D
    maintenance
    Allows Claude and other MCP clients to access real-time and historical stock market data from Alpha Vantage API, including intraday and daily stock data with customizable intervals.
    3
    7 npm
    6
    MIT

  • Alpha Vantage MCP Server

    calvernaz
    A
    license
    C
    quality
    D
    maintenance
    Provides access to real-time and historical stock market data through the Alpha Vantage API, enabling financial analysis and market data queries through natural language.
    100
    38 PyPI
    74
    Apache 2.0

  • Alpha Vantage MCP

    iferdelja
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables access to stock and financial data from Alpha Vantage, including stocks, forex, cryptocurrencies, commodities, and technical indicators, through natural language queries.
    1
    MIT

  • Yahoo Finance MCP Server

    danishashko
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides real-time stock market data for Claude Desktop and MCP-compatible clients, enabling natural language queries for quotes, historical prices, company profiles, financial statements, analyst ratings, comparisons, news, options, holdings, dividends, estimates, symbol search, and market status.
    204 npm
    19
    MIT