Skip to main content
Glama
ykshah1309

Financial Hub MCP Server

by ykshah1309

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FRED_API_KEYNoFree API key from fred.stlouisfed.org. Required for FRED tools.
FINNHUB_API_KEYNoFree API key from finnhub.io. Required for market data tools.
SEC_USER_AGENT_EMAILYesYour 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
financial_analysisAnalyze a company's financial health using SEC EDGAR data. Retrieves key metrics and guides structured analysis.
peer_comparisonCompare two companies on key financial metrics side by side.
economic_overviewGet a snapshot of current US economic conditions using FRED data.

Resources

Contextual data attached and managed by the client

NameDescription
Apple Inc.SEC filing profile for Apple Inc.
Microsoft CorporationSEC filing profile for Microsoft Corporation
Alphabet Inc.SEC filing profile for Alphabet Inc.
FRED: Gdp Indicators5 economic series — GDP, GDPC1, A191RL1Q225SBEA, INDPRO, CFNAI
FRED: Labor Indicators6 economic series — UNRATE, PAYEMS, ICSA, CIVPART, AWHAETP, CES0500000003
FRED: Inflation Indicators6 economic series — CPIAUCSL, CPILFESL, PCEPI, PCEPILFE, PPIFIS, T5YIE
FRED: Rates Indicators9 economic series — FEDFUNDS, DFF, DGS2, DGS5, DGS10, DGS30, T10Y2Y, T10YFF, SOFR
FRED: Housing Indicators6 economic series — MORTGAGE30US, MORTGAGE15US, CSUSHPINSA, HOUST, PERMIT, EXHOSLUSM495S
FRED: Markets Indicators6 economic series — SP500, VIXCLS, DEXUSEU, DEXJPUS, DCOILWTICO, GOLDAMGBD228NLBM
FRED: Money Indicators3 economic series — M2SL, WALCL, RRPONTSYD
FRED: Trade Indicators2 economic series — BOPGSTB, DTWEXBGS
FRED: Consumer Indicators6 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

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