Official Financial

Provides access to financial and economic data via MCP from Yahoo Finance and FRED.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "openpharma-org-financials-mcp": {
      "command": "node",
      "args": [
        "/path/to/financial-mcp-server/build/index.js"
      ],
      "env": {
        "FRED_API_KEY": "YOUR_FRED_API_KEY"
      }
    }
  }
}

This MCP server provides programmatic access to financial and economic data through a local, self-hosted MCP endpoint. By running a Node-based server that exposes a rich set of methods for stock analysis, market indicators, and FRED data, you can empower your applications to fetch up-to-date information from Yahoo Finance and FRED in a consistent, programmatic way.

How to use

You connect to this MCP server from an MCP client and call methods by name, providing the required parameters. Use the available stock methods to retrieve company profiles, pricing, earnings, dividends, and technical indicators. Use the market and macro methods to fetch major indices and macro indicators. Use the FRED methods to search and fetch economic data series. Each call returns structured data you can integrate into dashboards, analytics, or decision-support tools.

How to install

1) Ensure you have Node.js installed (version 14+ recommended).
2) Create a configuration file with the MCP server details.
3) Run the MCP server using the exact command and path provided in the config.

Configuration and usage notes

The server requires an API key for FRED data. Include it as an environment variable in your startup configuration.

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

Examples of calls you can make

Get a company profile, fetch price data, or run an economic data query by naming the method and providing required parameters.

Notes on capabilities

Explore stock methods for detailed company metrics, market indicators for overall performance, and a broad set of FRED endpoints for economic analysis. All calls are designed to be integrated into dashboards, alerts, or decision-support tools.

Available tools

stock_profile

Returns company details including industry, employees, and business summary.

stock_summary

Provides key metrics such as market cap, P/E, EPS, beta, and enterprise value.

stock_estimates

Analyst EPS and revenue estimates, plus price targets.

stock_pricing

Real-time pricing data, volume, and daily price ranges.

stock_financials

Cash flow, income highlights, and balance sheet ratios.

stock_revenue_breakdown

Revenue by business segment and geography.

stock_earnings_history

Historical EPS trends and earnings analysis.

stock_recommendations

Analyst rating trends and consensus changes.

stock_esg

Environmental, Social, Governance scores.

stock_dividends

Dividend history, yield, and payout ratios.

stock_technicals

Technical indicators, moving averages, and volatility.

stock_news

stock_peers

Industry peer comparison on key metrics.

stock_screener

Multi-criteria stock discovery.

stock_correlation

Portfolio correlation analysis.

economic_indicators

Macro dashboard with GDP, unemployment, inflation, and rates.

market_indices

Major indices and sector performance.

fred_series_search

Search 800,000+ economic series by terms.

fred_series_data

Fetch observations for a specific series.

fred_categories

Browse data categories.

fred_releases

Economic calendar with release schedules.

fred_vintage_data

Historical data revision analysis.

fred_tags

Tag-based economic concept discovery.

fred_regional_data

Geographic economic analysis by region.

fred_sources

Data source transparency and quality.

fred_series_updates

fred_series_relationships

Series metadata and connections.

fred_maps_data

Geographic economic data for mapping.