MCP-Server-Financial-Analyzer
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Server-Financial-Analyzer What is the current P/E ratio of AAPL?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Current price, volume, 52-week range, market cap |
| OHLCV history with configurable period and interval |
| Company profile, sector, employees, ownership |
Fundamentals
Tool | Description |
| Revenue, gross profit, EBITDA, net income, EPS |
| Assets, liabilities, equity, debt |
| Operating, investing, financing, free cash flow |
| EPS estimates vs actuals and surprise % |
SEC Filings
Tool | Description |
| List 10-K, 10-Q, 8-K, and other filings |
| Retrieve full text of specific sections (business, risk_factors, mda) |
| EDGAR CIK, registered tickers, TTM financials from XBRL |
Analysis
Tool | Description |
| P/E, P/B, EV/EBITDA, ROE, ROA, margins, leverage ratios |
| YoY growth trends for any financial line item |
| Side-by-side comparison of multiple tickers on any metric |
| Simplified DCF intrinsic value with margin of safety |
Related MCP server: Financial Modeling Prep MCP Server
Resources
URI | Description |
| Major US indices (S&P 500, NASDAQ, Dow, VIX, 10Y Treasury) |
| 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-analyzerClaude 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.
Push to GitHub
Go to render.com → New → Blueprint → connect your repo
Set
EDGAR_IDENTITYto your real name and email in the Render dashboardDeploy — 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 |
| Yes | — |
|
| No |
|
|
| No |
| Bind address (HTTP mode only) |
| No |
| Port (HTTP mode only) |
| 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 toolsanalyze_trendsA
Analyse YoY / period-over-period growth trends for a financial metric.
Args: ticker: Stock ticker symbol, e.g. 'AAPL' metric: Line item to analyse. Common values: 'Total Revenue', 'Gross Profit', 'Net Income', 'Operating Income', 'EBITDA', 'Free Cash Flow', 'Total Assets', 'Total Debt' periods: Number of annual periods to include (1-8)
Inputs: ticker (required), metric, periods. Returns: result
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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Provide AI assistants with real-time access to official SEC EDGAR filings and financial data. Enab…
SEC filings and financial data for AI agents: 59 tools for statements, valuation and supply chains.
Market data, filings, fundamentals, macro, news and research runs for AI assistants.
SEC-filed company financials with filing citations, plus market data, for AI agents
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmApache 2.0