Skip to main content
Glama
MCP-Server-Financial-Analyzer

MCP-Server-Financial-Analyzer

by HonglingLei

MCP Server – Financial Analyzer

An MCP (Model Context Protocol) server that gives AI assistants access to real-time stock prices, financial statements, SEC filings, and analytical tools.

Built with FastMCP, powered by yfinance and edgartools.


Tools

Stock Prices

Tool

Description

get_stock_price

Current price, volume, 52-week range, market cap

get_price_history

OHLCV history with configurable period and interval

get_stock_info

Company profile, sector, employees, ownership

Fundamentals

Tool

Description

get_income_statement

Revenue, gross profit, EBITDA, net income, EPS

get_balance_sheet

Assets, liabilities, equity, debt

get_cash_flow

Operating, investing, financing, free cash flow

get_earnings_history

EPS estimates vs actuals and surprise %

SEC Filings

Tool

Description

search_sec_filings

List 10-K, 10-Q, 8-K, and other filings

get_filing_sections

Retrieve full text of specific sections (business, risk_factors, mda)

get_company_facts

EDGAR CIK, registered tickers, TTM financials from XBRL

Analysis

Tool

Description

calculate_financial_ratios

P/E, P/B, EV/EBITDA, ROE, ROA, margins, leverage ratios

analyze_trends

YoY growth trends for any financial line item

compare_stocks

Side-by-side comparison of multiple tickers on any metric

dcf_estimate

Simplified DCF intrinsic value with margin of safety

Related MCP server: Financial Modeling Prep MCP Server

Resources

URI

Description

market://overview

Major US indices (S&P 500, NASDAQ, Dow, VIX, 10Y Treasury)

market://sectors

Daily performance of 11 GICS sectors via SPDR ETFs


Quickstart (local / stdio)

# 1. Clone and install
git clone https://github.com/YOUR_USERNAME/MCP-Server-Financial-Analyzer.git
cd MCP-Server-Financial-Analyzer
pip install uv
uv sync

# 2. Configure environment
cp .env.example .env
# Edit .env — set EDGAR_IDENTITY to "Your Name your@email.com"

# 3. Run (stdio mode for local use)
uv run financial-analyzer

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "financial-analyzer": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/MCP-Server-Financial-Analyzer", "financial-analyzer"],
      "env": {
        "EDGAR_IDENTITY": "Your Name your@email.com"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json or user settings:

{
  "servers": {
    "financial-analyzer": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/MCP-Server-Financial-Analyzer", "financial-analyzer"],
      "env": {
        "EDGAR_IDENTITY": "Your Name your@email.com"
      }
    }
  }
}

Deploy to Render

This repo includes a render.yaml for one-click deployment.

  1. Push to GitHub

  2. Go to render.com → New → Blueprint → connect your repo

  3. Set EDGAR_IDENTITY to your real name and email in the Render dashboard

  4. Deploy — your MCP endpoint will be at https://<service-name>.onrender.com/mcp

Connect remote clients to the deployed server

{
  "mcpServers": {
    "financial-analyzer": {
      "type": "http",
      "url": "https://<service-name>.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer <MCP_AUTH_TOKEN>"
      }
    }
  }
}

The MCP_AUTH_TOKEN is auto-generated by Render and visible in your service's environment variables.


Environment Variables

Variable

Required

Default

Description

EDGAR_IDENTITY

Yes

—

"Name email" per SEC fair-use policy

TRANSPORT

No

stdio

stdio for local, streamable-http for cloud

HOST

No

0.0.0.0

Bind address (HTTP mode only)

PORT

No

8000

Port (HTTP mode only)

MCP_AUTH_TOKEN

No

—

Bearer token to protect the HTTP endpoint


Disclaimer

This server provides financial data for informational and educational purposes only. It is not financial advice. Always verify data from authoritative sources before making investment decisions.

Available Tools

14 tools
calculate_financial_ratiosA

Calculate key financial ratios for a stock.

Returns valuation ratios (P/E, P/B, P/S, EV/EBITDA), profitability (ROE, ROA, profit margin, EBITDA margin), and leverage (debt/equity, current ratio, quick ratio).

Args: ticker: Stock ticker symbol, e.g. 'AAPL'

Inputs: ticker (required). Returns: result

compare_stocksA

Compare multiple stocks side-by-side on a single metric.

Args: tickers: List of ticker symbols, e.g. ['AAPL', 'MSFT', 'GOOGL'] metric: Metric to compare. Options include: 'pe_ratio_ttm', 'pe_ratio_forward', 'price_to_book', 'price_to_sales_ttm', 'ev_to_ebitda', 'profit_margin', 'roe', 'roa', 'debt_to_equity', 'current_ratio', 'revenue_growth_yoy', 'earnings_growth_yoy', 'market_cap', 'current_price', 'dividend_yield'

Inputs: tickers (required), metric. Returns: result

dcf_estimateA

Estimate intrinsic value using a simplified Discounted Cash Flow (DCF) model.

Uses trailing free cash flow from Yahoo Finance as the base, projects it forward, and discounts back to present value.

Args: ticker: Stock ticker symbol, e.g. 'AAPL' growth_rate: Annual FCF growth rate for the projection period (e.g. 0.10 = 10%) discount_rate: Weighted average cost of capital / required return (e.g. 0.10 = 10%) terminal_growth_rate: Perpetual growth rate after projection period (e.g. 0.03 = 3%) projection_years: Number of years to project (1-10)

Inputs: ticker (required), growth_rate, discount_rate, projection_years, +1 more. Returns: result

get_balance_sheetA

Get balance sheet data (assets, liabilities, equity, debt).

Args: ticker: Stock ticker symbol, e.g. 'AAPL' period: 'annual' or 'quarterly'

Inputs: ticker (required), period. Returns: result

get_cash_flowA

Get cash flow statement (operating, investing, financing, free cash flow).

Args: ticker: Stock ticker symbol, e.g. 'AAPL' period: 'annual' or 'quarterly'

Inputs: ticker (required), period. Returns: result

get_company_factsA

Get basic company facts from SEC EDGAR (CIK, name, registered tickers).

Also retrieves TTM (trailing twelve months) revenue and net income from the company's XBRL filings when available.

Args: ticker: Stock ticker symbol, e.g. 'AAPL'

Inputs: ticker (required). Returns: result

get_earnings_historyA

Get earnings history showing EPS estimates vs actuals and surprise percentages.

Args: ticker: Stock ticker symbol, e.g. 'AAPL'

Inputs: ticker (required). Returns: result

get_filing_sectionsA

Retrieve key sections from an SEC filing as markdown text.

For 10-K filings the important sections are: business, risk_factors, mda (Management Discussion & Analysis), financials.

Args: ticker: Stock ticker symbol, e.g. 'AAPL' form_type: Filing type - '10-K' or '10-Q' filing_date: Exact filing date YYYY-MM-DD; leave empty for most recent sections: Comma-separated section names to retrieve, or 'all' for a summary. Common values: 'business', 'risk_factors', 'mda'

Inputs: ticker (required), sections, form_type, filing_date. Returns: result

get_income_statementA

Get income statement data (revenue, gross profit, EBITDA, net income, EPS).

Args: ticker: Stock ticker symbol, e.g. 'AAPL' period: 'annual' or 'quarterly'

Inputs: ticker (required), period. Returns: result

get_price_historyA

Get historical OHLCV price data for a stock.

Args: ticker: Stock ticker symbol, e.g. 'AAPL' period: Time period - '1d','5d','1mo','3mo','6mo','1y','2y','5y','10y','ytd','max' interval: Data interval - '1m','2m','5m','15m','30m','60m','90m','1h','1d','5d','1wk','1mo','3mo'

Inputs: ticker (required), period, interval. Returns: result

get_stock_infoA

Get company profile and descriptive information for a stock.

Args: ticker: Stock ticker symbol, e.g. 'AAPL'

Inputs: ticker (required). Returns: result

get_stock_priceA

Get the current price and key market data for a stock.

Args: ticker: Stock ticker symbol, e.g. 'AAPL', 'MSFT', 'TSLA'

Inputs: ticker (required). Returns: result

search_sec_filingsA

Search for SEC filings for a company.

Args: ticker: Stock ticker symbol, e.g. 'AAPL' form_type: Filing type - '10-K', '10-Q', '8-K', 'DEF 14A', 'S-1', etc. limit: Maximum number of filings to return (1-20)

Inputs: ticker (required), limit, form_type. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, such as the three financial statements and the price data tools. However, get_company_facts and get_stock_info both provide company information, and get_stock_price overlaps somewhat with get_stock_info in terms of market data, which could cause some confusion.

    Naming Consistency3/5

    The majority of tools use a consistent get_ prefix, but several break this pattern with action verbs like calculate_financial_ratios, analyze_trends, and compare_stocks, and dcf_estimate does not follow the verb_noun structure. This mixing of conventions is readable but not fully predictable.

    Tool Count5/5

    With 14 tools, the server is well-scoped for a financial analyzer, covering fundamental data, SEC filings, ratios, trends, comparisons, and valuation. Each tool serves a distinct analytical purpose without feeling excessive.

    Completeness4/5

    The tool set covers the main workflows of financial analysis: retrieving financial statements, calculating ratios, analyzing trends, comparing stocks, and performing DCF valuation. Minor gaps exist, such as no direct access to analyst estimates or news, but these are not critical for the core domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with access to comprehensive financial data including real-time stock quotes, company fundamentals, financial statements, market analysis, SEC filings, and economic indicators through 253+ tools across 24 categories.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, economics, and more.
      558 npm
      Apache 2.0