Financial Hub MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FRED_API_KEY | No | Free API key from fred.stlouisfed.org. Required for FRED tools. | |
| FINNHUB_API_KEY | No | Free API key from finnhub.io. Required for market data tools. | |
| SEC_USER_AGENT_EMAIL | Yes | Your email address for SEC EDGAR API compliance. The server will exit immediately if this is not set. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_companiesA | Search for SEC-registered companies by name or ticker symbol. Returns matching company names, tickers, and CIK numbers. Use the CIK for subsequent filing and financial data lookups. |
| get_company_filingsA | Get recent SEC filings for a company by CIK number. Returns filing metadata including form type, filing date, and document links. Optionally filter by form type (e.g. 10-K, 10-Q, 8-K, DEF 14A). |
| get_financial_metricA | Get deduplicated historical values of a financial metric for a company. Automatically resolves concept aliases — you can use friendly names like 'revenue', 'net_income', 'eps', 'cash', 'total_assets' or raw XBRL tags. Returns clean, one-per-period values with trend analysis. Available concepts: revenue, net_income, gross_profit, operating_income, eps, total_assets, total_liabilities, stockholders_equity, cash, long_term_debt, operating_cash_flow, capex, shares_outstanding. |
| get_financial_summaryA | Get a comprehensive financial snapshot with computed ratios. Returns latest revenue, net income, assets, liabilities, equity, cash, debt, EPS — plus profit margin, debt-to-equity, current ratio, and ROE. All values are deduplicated and from the most recent annual filing. |
| get_company_facts_summaryA | Get a compact index of all available XBRL financial data for a company. Returns concept names, latest values, and data point counts — NOT the full time series. Use this to discover what data is available, then use get_financial_metric for details. |
| analyze_financialsA | Deep financial analysis with computed ratios, growth metrics, and health scoring. Returns profit margins, ROE, ROA, debt-to-equity, current ratio, revenue/income/EPS growth with CAGR, trend detection, and a composite health grade (A-F). This goes beyond raw data — it interprets the numbers. |
| compare_companiesA | Side-by-side financial comparison of 2-5 companies with normalized metrics. Compares revenue, income, assets, cash, ratios, and health scores. Identifies the winner in each category. All data is deduplicated and from annual filings. |
| search_filingsA | Full-text search across all SEC EDGAR filings. Search for keywords in filing documents, optionally filtered by form type and date range. Supports pagination — use offset to fetch subsequent pages. |
| screen_stocksA | Discover SEC-registered companies by exchange, industry, name, or financial health score. Fast filters (exchange, name) search 10,000+ companies instantly. Deep filters (industry, health score) require per-company API calls and are slower. Available industries: agriculture, mining, construction, manufacturing, transportation, wholesale, retail, finance, services, public_admin. |
| get_corporate_eventsA | Get recent 8-K corporate events for a company, classified by event type and significance. Covers M&A, earnings announcements, leadership changes, material agreements, cybersecurity incidents, delisting notices, auditor changes, shareholder votes, and more. Each event includes the SEC item number, human-readable label, category, and significance level (high/medium/low). |
| search_economic_dataA | Search the FRED database for economic data series. FRED contains over 800,000 time series from 100+ sources — GDP, inflation, unemployment, interest rates, housing, and more. Returns series IDs that can be used with get_economic_data. |
| get_economic_dataA | Get time series observations for a FRED economic data series. Returns recent data points with dates and values. Common series: GDP (Gross Domestic Product), CPIAUCSL (CPI), UNRATE (Unemployment Rate), FEDFUNDS (Fed Funds Rate), DGS10 (10-Year Treasury), SP500 (S&P 500), MORTGAGE30US (30-Year Mortgage Rate). |
| get_stock_quoteA | Get a real-time stock price quote. Returns current price, daily change, percent change, day high/low, open price, and previous close. Data is live (not cached) from Finnhub. Requires FINNHUB_API_KEY environment variable. |
| get_market_newsA | Get latest financial news headlines. By default returns general market news. Provide a symbol to get company-specific news instead. Categories for general news: general, forex, crypto, merger. Requires FINNHUB_API_KEY environment variable. |
| get_insider_transactionsA | Get recent insider trading activity for a company. Returns insider names, share counts, transaction dates, prices, and buy/sell codes. Transaction codes: P = Purchase, S = Sale, M = Option Exercise, A = Grant/Award, G = Gift, F = Tax withholding. Requires FINNHUB_API_KEY environment variable. |
| get_company_overviewA | Get a comprehensive company overview combining profile, market metrics, and peer companies. Returns name, exchange, industry, market cap, PE ratio, beta, 52-week range, EPS, dividend yield, and peer tickers. This is the 'market overlay' that complements SEC fundamental data. Requires FINNHUB_API_KEY environment variable. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| financial_analysis | Analyze a company's financial health using SEC EDGAR data. Retrieves key metrics and guides structured analysis. |
| peer_comparison | Compare two companies on key financial metrics side by side. |
| economic_overview | Get a snapshot of current US economic conditions using FRED data. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Apple Inc. | SEC filing profile for Apple Inc. |
| Microsoft Corporation | SEC filing profile for Microsoft Corporation |
| Alphabet Inc. | SEC filing profile for Alphabet Inc. |
| FRED: Gdp Indicators | 5 economic series — GDP, GDPC1, A191RL1Q225SBEA, INDPRO, CFNAI |
| FRED: Labor Indicators | 6 economic series — UNRATE, PAYEMS, ICSA, CIVPART, AWHAETP, CES0500000003 |
| FRED: Inflation Indicators | 6 economic series — CPIAUCSL, CPILFESL, PCEPI, PCEPILFE, PPIFIS, T5YIE |
| FRED: Rates Indicators | 9 economic series — FEDFUNDS, DFF, DGS2, DGS5, DGS10, DGS30, T10Y2Y, T10YFF, SOFR |
| FRED: Housing Indicators | 6 economic series — MORTGAGE30US, MORTGAGE15US, CSUSHPINSA, HOUST, PERMIT, EXHOSLUSM495S |
| FRED: Markets Indicators | 6 economic series — SP500, VIXCLS, DEXUSEU, DEXJPUS, DCOILWTICO, GOLDAMGBD228NLBM |
| FRED: Money Indicators | 3 economic series — M2SL, WALCL, RRPONTSYD |
| FRED: Trade Indicators | 2 economic series — BOPGSTB, DTWEXBGS |
| FRED: Consumer Indicators | 6 economic series — RSAFS, UMCSENT, PCE, PSAVERT, DSPIC96, TOTALSA |
| Gross Domestic Product | [gdp] Total value of goods and services produced in the US (Quarterly, Billions of $) |
| Real GDP | [gdp] Inflation-adjusted GDP (Quarterly, Billions of Chained 2017 $) |
| Real GDP Growth Rate | [gdp] Quarter-over-quarter annualized real GDP growth (Quarterly, Percent Change) |
| Industrial Production Index | [gdp] Output of manufacturing, mining, and utilities sectors (Monthly, Index 2017=100) |
| Chicago Fed National Activity Index | [gdp] Weighted average of 85 economic indicators (Monthly, Index) |
| Unemployment Rate | [labor] Percentage of labor force that is unemployed (Monthly, Percent) |
| Total Nonfarm Payrolls | [labor] Total number of paid US workers excluding farm employees (Monthly, Thousands of Persons) |
| Initial Jobless Claims | [labor] New filings for unemployment insurance (Weekly, Number) |
| Labor Force Participation Rate | [labor] Percentage of working-age population in the labor force (Monthly, Percent) |
| Average Weekly Hours | [labor] Average weekly hours of production and nonsupervisory employees (Monthly, Hours) |
| Average Hourly Earnings | [labor] Average hourly earnings of all private employees (Monthly, $/Hour) |
| Consumer Price Index (CPI) | [inflation] Broad measure of consumer price inflation (Monthly, Index 1982-84=100) |
| Core CPI (Ex Food & Energy) | [inflation] CPI excluding volatile food and energy prices (Monthly, Index 1982-84=100) |
| PCE Price Index | [inflation] Fed's preferred inflation measure (Monthly, Index 2017=100) |
| Core PCE Price Index | [inflation] PCE excluding food and energy — Fed's primary target (Monthly, Index 2017=100) |
| Producer Price Index | [inflation] Wholesale/producer-level price changes (Monthly, Index) |
| 5-Year Breakeven Inflation Rate | [inflation] Market-implied 5-year inflation expectation (Daily, Percent) |
| Federal Funds Rate | [rates] Rate at which banks lend reserves to each other overnight (Monthly, Percent) |
| Federal Funds Effective Rate (Daily) | [rates] Daily effective federal funds rate (Daily, Percent) |
| 2-Year Treasury Yield | [rates] Constant maturity 2-year Treasury yield (Daily, Percent) |
| 5-Year Treasury Yield | [rates] Constant maturity 5-year Treasury yield (Daily, Percent) |
| 10-Year Treasury Yield | [rates] Benchmark long-term interest rate (Daily, Percent) |
| 30-Year Treasury Yield | [rates] Constant maturity 30-year Treasury yield (Daily, Percent) |
| 10Y-2Y Treasury Spread | [rates] Yield curve slope — inverts before recessions (Daily, Percent) |
| 10Y Treasury - Fed Funds Spread | [rates] Measures monetary policy tightness (Daily, Percent) |
| Secured Overnight Financing Rate | [rates] Benchmark rate for dollar-denominated derivatives and loans (Daily, Percent) |
| 30-Year Fixed Mortgage Rate | [housing] Average 30-year fixed-rate mortgage rate (Weekly, Percent) |
| 15-Year Fixed Mortgage Rate | [housing] Average 15-year fixed-rate mortgage rate (Weekly, Percent) |
| Case-Shiller Home Price Index | [housing] National home price index (Monthly, Index Jan 2000=100) |
| Housing Starts | [housing] New residential construction starts (Monthly, Thousands of Units) |
| Building Permits | [housing] New privately-owned housing units authorized (Monthly, Thousands of Units) |
| Existing Home Sales | [housing] Completed transactions of existing single-family homes and condos (Monthly, Number of Units) |
| S&P 500 Index | [markets] Broad US equity market benchmark (Daily, Index) |
| CBOE Volatility Index (VIX) | [markets] Market fear gauge — implied volatility of S&P 500 options (Daily, Index) |
| USD/EUR Exchange Rate | [markets] US dollar to Euro exchange rate (Daily, USD per EUR) |
| JPY/USD Exchange Rate | [markets] Japanese yen to US dollar exchange rate (Daily, JPY per USD) |
| Crude Oil Price (WTI) | [markets] West Texas Intermediate crude oil spot price (Daily, $/Barrel) |
| Gold Price | [markets] London Bullion Market gold fixing price (Daily, $/Troy Ounce) |
| M2 Money Supply | [money] Broad money supply including savings, small time deposits, money market funds (Monthly, Billions of $) |
| Fed Total Assets | [money] Total assets on the Federal Reserve balance sheet (Weekly, Millions of $) |
| Overnight Reverse Repo | [money] Fed overnight reverse repurchase agreements (Daily, Billions of $) |
| Trade Balance | [trade] Goods and services trade balance (exports minus imports) (Monthly, Millions of $) |
| Trade Weighted US Dollar Index | [trade] Broad trade-weighted value of the US dollar (Daily, Index Jan 2006=100) |
| Retail Sales | [consumer] Total retail and food services sales (Monthly, Millions of $) |
| Consumer Sentiment (UMich) | [consumer] University of Michigan consumer sentiment survey (Monthly, Index 1966:Q1=100) |
| Personal Consumption Expenditures | [consumer] Total consumer spending (Monthly, Billions of $) |
| Personal Saving Rate | [consumer] Personal savings as a percentage of disposable income (Monthly, Percent) |
| Real Disposable Personal Income | [consumer] Income available after taxes, adjusted for inflation (Monthly, Billions of Chained 2017 $) |
| Total Vehicle Sales | [consumer] Total new light vehicle sales (Monthly, Millions of Units) |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ykshah1309/financial-hub-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server