ykshah1309 avatar

Financial Hub Mcp

ykshah1309/financial-hub-mcp

Pulls SEC EDGAR filings, FRED economic series, and Finnhub market data into a single MCP interface. You get XBRL normalization across 20+ financial concepts, so querying revenue works whether a company tags it as Revenues or RevenueFromContractWithCustomerExcludingAssessedTax. The compare_companies and analyze_financials tools compute ratios, growth rates, and health scores across multiple filings. Stock screening filters 10,000+ companies by exchange, SIC industry, and computed health metrics. FRED access covers 800,000+ time series with a curated catalog of essential indicators. Rate limiting and LRU caching handle SEC's 10 req/s and Finnhub's 30 req/s limits. Reach for this when you need cross-company financial analysis or want to correlate market data with macro indicators without juggling three different APIs.

GitHub stars
1
tools
16
auth
Secret needed
transport
STDIO
env vars
3
last updated
Apr 17, 2026

Tools

16 tools

Public tool metadata for what this MCP can expose to an agent.

search_companiesSearch SEC-registered companies by name or ticker

Search SEC-registered companies by name or ticker

No parameter schema in public metadata yet.

get_company_filingsGet recent SEC filings for a company

Get recent SEC filings for a company

No parameter schema in public metadata yet.

get_financial_metricGet deduplicated historical values of a financial metric with trend analysis

Get deduplicated historical values of a financial metric with trend analysis

No parameter schema in public metadata yet.

get_financial_summaryGet a comprehensive financial snapshot with computed ratios

Get a comprehensive financial snapshot with computed ratios

No parameter schema in public metadata yet.

get_company_facts_summaryGet a compact index of all available XBRL data for a company

Get a compact index of all available XBRL data for a company

No parameter schema in public metadata yet.

analyze_financialsDeep financial analysis with computed ratios, growth metrics, and health scoring

Deep financial analysis with computed ratios, growth metrics, and health scoring

No parameter schema in public metadata yet.

compare_companiesSide-by-side financial comparison of 2-5 companies

Side-by-side financial comparison of 2-5 companies

No parameter schema in public metadata yet.

search_filingsFull-text search across all SEC EDGAR filings with pagination

Full-text search across all SEC EDGAR filings with pagination

No parameter schema in public metadata yet.

screen_stocksScreen SEC-registered companies by exchange, industry, name, and financial health

Screen SEC-registered companies by exchange, industry, name, and financial health

No parameter schema in public metadata yet.

get_corporate_eventsGet recent 8-K corporate events with significance classification

Get recent 8-K corporate events with significance classification

No parameter schema in public metadata yet.

search_economic_dataSearch the FRED database for economic data series

Search the FRED database for economic data series

No parameter schema in public metadata yet.

get_economic_dataGet time series observations for a FRED economic data series

Get time series observations for a FRED economic data series

No parameter schema in public metadata yet.

get_stock_quoteGet a real-time stock price quote from Finnhub

Get a real-time stock price quote from Finnhub

No parameter schema in public metadata yet.

get_market_newsGet latest financial news headlines

Get latest financial news headlines

No parameter schema in public metadata yet.

get_insider_transactionsGet recent insider trading activity for a company

Get recent insider trading activity for a company

No parameter schema in public metadata yet.

get_company_overviewGet a comprehensive company overview combining profile, market metrics, and peers

Get a comprehensive company overview combining profile, market metrics, and peers

No parameter schema in public metadata yet.

Sponsors

Configuration

FRED_API_KEY*secret

Free API key from FRED (Federal Reserve Economic Data) — required for economic data tools

SEC_USER_AGENT_EMAIL

Your email address for SEC EDGAR API compliance (User-Agent header)

FINNHUB_API_KEYsecret

Free API key from Finnhub — required for stock quotes, market news, insider transactions, and company overviews

Readme

Financial Hub MCP Server

A TypeScript MCP server for financial data aggregation. Connects any MCP-compatible AI assistant to SEC EDGAR filings, XBRL financial statements, FRED economic indicators, and real-time market data — with built-in XBRL normalization, fact deduplication, computed analytics, stock screening, and rate-limit protection.

Core Concepts

SEC EDGAR

All SEC EDGAR data comes directly from the SEC's free public APIs at data.sec.gov. No API key is required. The server automatically handles:

  • XBRL concept resolution — Different companies use different XBRL tags for the same metric. The server normalizes across 20+ financial concepts (e.g., revenue resolves to Revenues, RevenueFromContractWithCustomerExcludingAssessedTax, SalesRevenueNet, and 11 other variants).
  • Fact deduplication — Raw XBRL data contains duplicate values from overlapping 10-K/10-Q filings and amendments. The server collapses these to one clean value per fiscal period.
  • Rate limiting — SEC enforces 10 requests/second. A token-bucket rate limiter with bounded queuing (max 50 pending, 30s timeout) prevents IP bans.

FRED


View the full README on GitHub

Details

Repository
github.com/ykshah1309/financial-hub-mcp
Category
Data & Analytics
Package
financial-hub-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from ykshah1309

Related Data & Analytics MCP servers

View all
1171county avatarModWrench171county/modwrenchOne MCP server for mod platforms and local modding diagnostics. No data kept.0stars
27mza avatarGeolocation Mcp7mza/geolocation-mcpAn MCP server that provides fast and up-to-date IP geolocation data.0stars
3abgeo avatarGeorgia MCPabgeo/georgia-mcpAn MCP server for Georgian public data, read from the organizations that publish it.0stars
4ad0750 avatarRegintel Mcpad0750/regintel-mcpMCP server for the RegIntel API: regulatory data across 41 jurisdictions, 212 regulations.0stars
5capaxelabs avatarBeeficapaxelabs/beefi-ai-mcpUS public company data from SEC EDGAR: financials, insider trades, 13F holdings, filings and macro.0stars
6bringyour avatarBring Your AIai.bringyour/bringyourNo-data MCP handoff for local Claude Code to Codex harness moves. $49 lifetime.0stars