Unofficial Financial MCP Server

A comprehensive Model Context Protocol (MCP) server that provides professional-grade access to financial and economic data through Yahoo Finance and Federal Reserve Economic Data (FRED).

Usage

{
  "mcpServers": {
    "financial-mcp-server": {
      "command": "node",
      "args": ["/path/to/financial-mcp-server/build/index.js"],
      "env": {
        "FRED_API_KEY": "your-fred-api-key-here"
      }
    }
  }
}

Get your free FRED API key: https://fred.stlouisfed.org/docs/api/api_key.html

Available Methods

Stock Analysis (11 methods)

Method	Description	Parameters
`stock_profile`	Company details, industry, employees, business summary	`symbol`: ticker (e.g., "AAPL")
`stock_summary`	Key metrics: market cap, P/E, EPS, beta, enterprise value	`symbol`: ticker
`stock_estimates`	Analyst EPS/revenue estimates, price targets	`symbol`: ticker
`stock_pricing`	Real-time pricing, volume, daily ranges	`symbol`: ticker
`stock_financials`	Cash flow, income highlights, balance sheet ratios	`symbol`: ticker
`stock_revenue_breakdown`	Revenue by business segment & geography	`symbol`: ticker
`stock_earnings_history`	Historical EPS trends & earnings analysis	`symbol`: ticker
`stock_recommendations`	Analyst rating trends & consensus changes	`symbol`: ticker
`stock_esg`	Environmental, Social, Governance scores	`symbol`: ticker
`stock_dividends`	Dividend history, yield, payout ratios	`symbol`: ticker
`stock_technicals`	Technical indicators, moving averages, volatility	`symbol`: ticker

Advanced Analytics (4 methods)

Method	Description	Parameters
`stock_news`	Recent news with sentiment analysis	`symbol`: ticker or search terms, `search_type`: "stock" or "general"
`stock_peers`	Industry peer comparison on key metrics	`symbol`: ticker
`stock_screener`	Multi-criteria stock discovery	`symbol`: JSON criteria (e.g., `{"maxPE":20,"minMarketCap":1000000000}`)
`stock_correlation`	Portfolio correlation analysis	`symbol`: comma-separated tickers (e.g., "AAPL,MSFT,GOOGL")

Market & Economic (2 methods)

Method	Description	Parameters
`economic_indicators`	Comprehensive macro dashboard (GDP, unemployment, inflation, rates)	-
`market_indices`	Major indices (S&P 500, NASDAQ, DOW, VIX) & sector performance	-

FRED Economic Data (12 methods)

Method	Description	Parameters
`fred_series_search`	Search 800,000+ economic series	`symbol`: search terms (e.g., "unemployment")
`fred_series_data`	Fetch specific series observations	`symbol`: series ID (e.g., "UNRATE")
`fred_categories`	Browse economic data categories	`symbol`: category ID
`fred_releases`	Economic calendar with release schedules	-
`fred_vintage_data`	Historical data revision analysis	`symbol`: series ID
`fred_tags`	Tag-based economic concept discovery	`symbol`: tag name
`fred_regional_data`	Geographic economic analysis (state/MSA)	`symbol`: series ID
`fred_sources`	Data source transparency & quality	`symbol`: source ID
`fred_series_updates`	Recently updated indicators	-
`fred_series_relationships`	Series metadata & connections	`symbol`: series ID
`fred_maps_data`	Geographic economic data for mapping	`symbol`: series ID

Example Usage

Get Apple's company profile

method: stock_profile
symbol: AAPL

Search for unemployment data

method: fred_series_search
symbol: unemployment rate

Screen for value stocks

method: stock_screener
symbol: {"maxPE": 15, "minDividendYield": 2, "minMarketCap": 10000000000}

Analyze portfolio correlation

method: stock_correlation
symbol: AAPL,MSFT,GOOGL,AMZN,TSLA

Get financial news with sentiment

method: stock_news
symbol: TSLA
search_type: stock

Rate Limits

Yahoo Finance

Mobile User-Agent for reliable access
Built-in request throttling
Graceful bot detection handling

FRED API

120 requests/minute (automatic compliance)
Efficient batch processing
Yahoo Finance fallback for treasury rates

Data Coverage

Stock Markets: NYSE, NASDAQ, major global exchanges (stocks, ETFs, indices)

Economic Data: GDP, unemployment, inflation, interest rates, regional statistics, historical revisions

Financial Metrics: Valuation (P/E, EV/EBITDA), performance (returns, volatility, beta), fundamentals (revenue, earnings, cash flow)

Disclaimer: Unofficial tool. Data is for informational purposes only and should not be used as the sole basis for investment decisions.

Financial MCP Server