Finance Data MCP Server

Real-time financial data for AI agents — 10 tools, 2 markets, 0 API keys.

---

What It Does

A 10-tool financial data server designed for MCP/AI agent consumption. Get stock quotes, financials, analysis, macro data, crypto prices, forex rates, SEC filings, earnings calendars, and news sentiment — all with structured output and intelligent caching.

Covers US (NYSE/NASDAQ) and India (NSE/BSE) markets. No API keys needed for core functionality.

---

Tools Overview

#	Tool	What It Returns	PPE Event
1	stock_quote	Real-time/delayed prices, volume, change	financial_data_retrieved ($0.05)
2	stock_financials	Income statement, balance sheet, cash flow	financial_data_retrieved ($0.05)
3	stock_analysis	Analyst recommendations, price targets, key stats	stock_analysis_completed ($0.10)
4	market_overview	Major indices, sector performance, market status	financial_data_retrieved ($0.05)
5	economic_indicators	GDP, inflation, interest rates, unemployment	financial_data_retrieved ($0.05)
6	crypto_prices	BTC, ETH, 15+ altcoins with 24h stats	financial_data_retrieved ($0.05)
7	currency_rates	15+ forex pairs with change tracking	financial_data_retrieved ($0.05)
8	sec_filings	Search SEC EDGAR filings by ticker & type	financial_data_retrieved ($0.05)
9	earnings_calendar	Upcoming earnings dates, EPS estimates	financial_data_retrieved ($0.05)
10	news_sentiment	Financial news with keyword sentiment scoring	financial_data_retrieved ($0.05)

---

Use Cases

• AI agent integration — structured data for Claude, GPT, or any LLM agent via MCP
• Portfolio monitoring — check quotes, financials, and analyst ratings
• Market research — macro indicators, sector performance, earnings dates
• India stock analysis — NSE/BSE data with .NS / .BO suffix support
• Crypto & forex — real-time prices for 15+ coins and currency pairs
• SEC research — pull 10-K, 10-Q, 8-K filings for any US company

---

Input

{
  "tool": "stock_quote",
  "tickers": ["NVDA", "RELIANCE.NS", "AAPL"]
}

Parameter	Type	Required	Description
tool	string	✅	Which financial data tool to invoke
tickers	string[]	✅	Stock/crypto/forex symbols
financial_type	string	❌	income_statement, balance_sheet, or cash_flow (stock_financials only)
period	string	❌	annual or quarterly (default: annual)
indicators	string[]	❌	Which macro indicators (economic_indicators only)
filing_type	string	❌	10-K, 10-Q, 8-K, DEF 14A, 13-F, or ALL
query	string	❌	Free-text search (sec_filings, news_sentiment)
limit	integer	❌	Max results (1–100, default 20)

---

Tool Examples

Stock Quote

{ "tool": "stock_quote", "tickers": ["NVDA", "RELIANCE.NS", "AAPL"] }

Stock Financials

{ "tool": "stock_financials", "tickers": ["AAPL"], "financial_type": "income_statement", "period": "annual" }

Stock Analysis

{ "tool": "stock_analysis", "tickers": ["TCS.NS", "MSFT"], "period": "quarterly" }

Market Overview

{ "tool": "market_overview" }

Economic Indicators

{ "tool": "economic_indicators", "indicators": ["GDP", "INFLATION", "INTEREST_RATE", "UNEMPLOYMENT"] }

Crypto Prices

{ "tool": "crypto_prices", "tickers": ["BTC-USD", "ETH-USD", "SOL-USD"] }

Currency Rates

{ "tool": "currency_rates", "tickers": ["EURUSD=X", "USDINR=X"] }

SEC Filings

{ "tool": "sec_filings", "tickers": ["AAPL"], "filing_type": "10-K", "limit": 5 }

Earnings Calendar

{ "tool": "earnings_calendar", "tickers": ["NVDA", "TSLA"] }

News Sentiment

{ "tool": "news_sentiment", "tickers": ["AAPL"], "limit": 10 }

---

Output

Each result includes structured data with metadata:

{
  "tool": "stock_quote",
  "ticker": "NVDA",
  "data": {
    "current_price": 875.42,
    "previous_close": 862.10,
    "change_pct": 1.55,
    "volume": 45200000,
    "market_cap": 2150000000000
  },
  "source": "yfinance",
  "fetched_at": "2026-04-22T10:30:00Z",
  "cache_ttl": 60
}

---

India Market Support

Exchange	Suffix	Example
NSE India	.NS	RELIANCE.NS, TCS.NS, INFY.NS
BSE India	.BO	RELIANCE.BO
Crypto	-USD	BTC-USD, ETH-USD, SOL-USD
Forex	=X	EURUSD=X, USDINR=X

---

Data Sources

Source	Tools	Notes
Yahoo Finance (yfinance)	Most tools	Free, no API key needed
SEC EDGAR	sec_filings	Free, public data
FRED (optional)	economic_indicators	Set FRED_API_KEY env var for live data

---

Intelligent Caching

Each tool has a built-in TTL cache:

• Stock quotes: 60 seconds
• Crypto: 30 seconds
• Forex: 5 minutes
• Financials: 1 hour
• SEC filings: 24 hours

Repeated requests within the TTL window return cached data instantly — no redundant API calls.

---

MCP Integration

This actor is designed for MCP (Model Context Protocol) consumption. AI agents can call it as a tool with structured input/output, making it ideal for:

• Claude Code MCP integrations
• Cursor IDE data lookups
• ChatGPT custom GPTs
• Any AI agent that needs financial data

---

Pricing

Event	Price
financial_data_retrieved	$0.05 per data point
stock_analysis_completed	$0.10 per analysis (additional, on top of base)

---

Architecture

src/
├── main.py              # Entry point, tool routing, PPE charging
├── cache.py             # TTL cache layer
├── validators.py        # Input validation
└── tools/
    ├── stock_quote.py
    ├── stock_financials.py
    ├── stock_analysis.py
    ├── market_overview.py
    ├── economic_indicators.py
    ├── crypto_prices.py
    ├── currency_rates.py
    ├── sec_filings.py
    ├── earnings_calendar.py
    └── news_sentiment.py

---

Built By

Satyam Das — amicable_grid on Apify