Finance Data MCP ๏ฟฝ Stocks, Crypto, Forex & Macro Data
DeprecatedPricing
Pay per event
Finance Data MCP ๏ฟฝ Stocks, Crypto, Forex & Macro Data
Deprecated10-tool financial data server for AI agents: stock quotes, financials, analysis, market overview, macro indicators, crypto, forex, SEC filings, earnings, news sentiment. US + India markets. Structured output, intelligent caching, no API keys needed.
Pricing
Pay per event
Rating
0.0
(0)
Developer
Actor stats
0
Bookmarked
1
Total users
0
Monthly active users
2 months ago
Last modified
Categories
Share
Finance Data MCP Server
Real-time financial data for AI agents โ 10 tools, 2 markets, 0 API keys.
๐ Try on Apify
๐ 10 tools
๐ NSE India
๐ No API key
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.025) |
| 2 | stock_financials | Income statement, balance sheet, cash flow | financial_data_retrieved ($0.025) |
| 3 | stock_analysis | Analyst recommendations, price targets, key stats | financial_data_retrieved ($0.025) + stock_analysis_completed ($0.05) |
| 4 | market_overview | Major indices, sector performance, market status | financial_data_retrieved ($0.025) |
| 5 | economic_indicators | GDP, inflation, interest rates, unemployment | financial_data_retrieved ($0.025) |
| 6 | crypto_prices | BTC, ETH, 15+ altcoins with 24h stats | financial_data_retrieved ($0.025) |
| 7 | currency_rates | 15+ forex pairs with change tracking | financial_data_retrieved ($0.025) |
| 8 | sec_filings | Search SEC EDGAR filings by ticker & type | financial_data_retrieved ($0.025) |
| 9 | earnings_calendar | Upcoming earnings dates, EPS estimates | financial_data_retrieved ($0.025) |
| 10 | news_sentiment | Financial news with keyword sentiment scoring | financial_data_retrieved ($0.025) |
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/.BOsuffix 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.
Setup for Claude Code, Cursor, Windsurf
Add to your MCP client config:
{"mcpServers":{"apify-finance":{"url":"https://mcp.apify.com/amicable_grid/finance-data-mcp/sse"}}}
Or use the Apify MCP gateway with tool filtering:
{"mcpServers":{"apify-finance":{"url":"https://mcp.apify.com?tools=amicable_grid/finance-data-mcp"}}}
Supported MCP Clients
- Claude Code โ MCP integrations
- Cursor IDE โ data lookups during coding
- Windsurf โ real-time financial context
- ChatGPT โ custom GPTs
- Any AI agent that needs financial data
Related Actors
| Actor | What It Does |
|---|---|
| SEC 13F Holdings Tracker | Hedge fund positions, new buys/exits, quarterly changes |
| Earnings Transcript Extractor | Earnings call transcripts with sentiment scoring |
| Options Chain & Greeks | Options chains, IV, Black-Scholes Greeks |
| NeuralQuant Stock Analyzer | Multi-factor stock analysis (Piotroski, momentum, value) |
| India Market Screener | NSE/BSE stock screening by fundamentals |
Pricing
| Event | Price | When Charged |
|---|---|---|
financial_data_retrieved | $0.025 per data point | Every successful tool call |
stock_analysis_completed | $0.05 per analysis | Additional premium for stock_analysis tool |
No charge on errors โ you only pay for successful data retrievals.
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
