fin-data-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EIA_API_KEY | No | Free API key for EIA energy data. | |
| FRED_API_KEY | No | Free API key for FRED macro/news data. | |
| EMBER_API_KEY | No | Free API key for Ember energy series. | |
| OPENSKY_SECRET | No | Secret for OpenSky authentication (used with OPENSKY_CLIENT_ID). | |
| QUIVER_API_KEY | No | Free API key for Quiver congressional trading, lobbying, contracts. | |
| SEC_USER_AGENT | No | A descriptive User-Agent with a contact email for SEC EDGAR (required for SEC tools). | |
| TIINGO_API_KEY | No | Free API key for Tiingo premium stock data. | |
| FINNHUB_API_KEY | No | Free API key for Finnhub real-time stock data and fundamentals. | |
| OPENSKY_CLIENT_ID | No | Client ID for higher OpenSky flight tracking limits (anonymous default ~400 credits/day). | |
| ALPHAVANTAGE_API_KEY | No | Free API key for Alpha Vantage commodities, stocks, FX, macro data. | |
| HOUSE_STOCK_WATCHER_URL | No | Custom URL for House Stock Watcher data. | |
| SENATE_STOCK_WATCHER_URL | No | Custom URL for Senate Stock Watcher data. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| yahoo_chartA | OHLCV price history + metadata for any Yahoo symbol. Works for equities (AAPL), indices (^GSPC, ^DJI, ^IXIC, ^VIX), ETFs (SPY), FX (EURUSD=X) and crypto (BTC-USD). Use this for both stock and index data. |
| yahoo_quoteA | Latest price snapshot for a symbol derived from the chart endpoint (regular market price, previous close, day range, exchange, currency). Avoids the crumb-gated quote endpoint. |
| yahoo_searchA | Search Yahoo Finance for tickers/companies by name or symbol. Returns matching quotes and related news. Use to resolve a company name to a symbol. |
| yahoo_quote_summaryA | Rich per-symbol fundamentals via the crumb-gated quoteSummary endpoint. Pass a comma-separated |
| yahoo_recommendationsA | Symbols Yahoo considers similar to the given one, each with a similarity score. Use for peer/comparable discovery. Does not require a crumb. Example: { symbol: "AAPL" } |
| yahoo_sparkA | Compact close-price series for one or more symbols in a single call — handy for sparklines or side-by-side comparisons. Example: { symbols: "AAPL,MSFT,SPY", range: "1mo", interval: "1d" } |
| yahoo_options_chainA | Options chain for a symbol: available expirations plus calls/puts (strikes, bid/ask, IV, OI, volume). Pass a Unix epoch-seconds |
| cboe_quoteA | Delayed (~15 min) quote snapshot for an equity, ETF, or index from Cboe — a no-key backend independent of Yahoo. Returns last/bid/ask, day open/high/low/close, previous close, volume, and security metadata. Symbols: tickers as-is (AAPL, SPY); indices with an underscore prefix (_SPX, _VIX, _DJI, _NDX). Example: { symbol: 'AAPL' } or { symbol: '_SPX' }. |
| cboe_historyA | Daily OHLCV price history for an equity/ETF/index from Cboe (history can extend back ~20 years). No key required. Use as a Yahoo-independent source for charts/backtests. Symbols: tickers as-is; indices with an underscore prefix (_SPX). Example: { symbol: 'SPY' }. |
| cboe_options_chainA | Full options chain for an underlying from Cboe (no key, no crumb) — a robust alternative to yahoo_options_chain. Returns every listed option (all expirations/strikes) with bid/ask, last, volume, open interest, IV, and greeks, plus the underlying quote. Note: the response can be large; filter client-side by expiration/strike. Example: { symbol: 'AAPL' }. |
| fx_latest_ratesB | Latest foreign-exchange reference rates from the European Central Bank. Returns rates for |
| fx_historical_rateA | FX reference rates for a specific past date (YYYY-MM-DD). Falls back to the most recent prior working day if the date is a weekend/holiday. |
| fx_timeseriesA | Daily FX rates across a date range. Use for currency charts and backtests. |
| fx_list_currenciesA | Map of supported currency codes to full names. |
| fx_open_ratesA | All exchange rates for a base currency from the ExchangeRate-API open endpoint (no key). Independent second source to cross-check Frankfurter. |
| worldbank_indicatorA | Time series for a World Bank indicator and country. Example indicators: NY.GDP.MKTP.CD (GDP, current US$), FP.CPI.TOTL.ZG (inflation %), SP.POP.TOTL (population). Country as ISO code (US, CN) or 'all'/'WLD' for world. |
| worldbank_search_indicatorsA | List World Bank indicators (paginated). Use to discover indicator codes before calling worldbank_indicator. There is no full-text search; page through. |
| worldbank_list_countriesB | Country metadata: ISO codes, region, income level, capital. |
| worldbank_sourcesA | List the data sources (databases) behind World Bank indicators, e.g. World Development Indicators, Doing Business. Use to discover a source id for filtering. Example: { perPage: 100 } |
| worldbank_topicsA | List the thematic topics (e.g. Agriculture, Economy & Growth, Health) used to categorize World Bank indicators. Example: { perPage: 100 } |
| worldbank_indicator_metadataA | Metadata for a single indicator: name, source, topics, and a definition/notes string. Use to confirm what an indicator code measures. Example: { code: "NY.GDP.MKTP.CD" } |
| worldbank_countryA | Metadata for a single country/region: ISO codes, region, income level, lending type, capital, coordinates. Example: { code: "US" } |
| crypto_candlesA | OHLCV candlesticks for a crypto instrument. Use spot ids like 'BTC-USDT' or perpetual-swap ids like 'BTC-USDT-SWAP'. Rows: [ts, open, high, low, close, vol, volCcy, volCcyQuote, confirm]. |
| crypto_tickerA | Latest ticker for one instrument: last price, 24h high/low/volume, bid/ask. Works for spot and swap ids. |
| crypto_orderbookA | Current bids/asks for an instrument. |
| crypto_funding_rateA | Current funding rate + next funding time for a perpetual swap. Set |
| crypto_open_interestA | Open interest for a swap/futures instrument (or all of an instType). |
| crypto_mark_priceB | Mark price for a swap/futures instrument (or all of an instType). |
| crypto_recent_tradesA | Most recent public trades for an instrument: price, size, side, trade id, timestamp. Works for spot and swap ids. Example: { instId: "BTC-USDT", limit: 50 } |
| crypto_all_tickersA | Latest tickers for every instrument of an instType in one call — last price, 24h high/low/volume, bid/ask. Use for market-wide scans. Example: { instType: "SPOT" } |
| crypto_index_candlesA | OHLC candlesticks for an OKX index (not a tradable instrument). Use index ids of the form 'BTC-USD' or 'ETH-USD'. Rows: [ts, open, high, low, close, confirm]. Example: { instId: "BTC-USD", bar: "1H", limit: 100 } |
| crypto_price_limitA | Highest buy and lowest sell limit prices currently allowed for a swap/futures instrument. Example: { instId: "BTC-USDT-SWAP" } |
| crypto_long_short_ratioA | Time series of the long/short account ratio for a currency's contracts (market sentiment). Rows: [ts, longShortRatio]. Example: { ccy: "BTC", period: "5m" } |
| crypto_list_instrumentsA | List tradable instruments for an instType (SPOT, SWAP, FUTURES, OPTION). Use to discover valid instId values. |
| polymarket_list_marketsA | List markets with metadata (question, outcomes, prices, volume, liquidity, clobTokenIds). Filter by active/closed. Use clobTokenIds with the price history / order book tools below. |
| polymarket_list_eventsA | List events (groups of related markets), e.g. an election with many candidate markets. Filter by active/closed/tag/slug. |
| polymarket_get_marketA | Full detail for a single market. Pass |
| polymarket_get_eventA | Full detail for a single event (a group of related markets). Pass |
| polymarket_price_historyA | Time series of an outcome's price. |
| polymarket_order_bookA | Live order book (bids/asks) for an outcome token. |
| polymarket_midpointA | Current midpoint (mid of best bid/ask) for an outcome token. |
| polymarket_last_trade_priceA | Most recent trade price and side for an outcome token. |
| polymarket_spreadA | Current bid-ask spread for an outcome token. |
| kalshi_list_marketsA | List regulated event markets (politics, macro, financials). Filterable by status and parent event/series. Returns yes/no prices, volume, expirations. |
| kalshi_get_marketA | Full detail for a single market by ticker. |
| kalshi_orderbookA | Current yes/no order book for a market ticker. |
| kalshi_list_eventsC | List events (groups of related markets). Optionally include nested markets. |
| kalshi_get_eventA | Full detail for a single event by event ticker. Set |
| kalshi_get_seriesA | Full detail for a single market series by series ticker (rules, category, frequency, contract terms). Example: { series_ticker: "KXELONMARS" } |
| kalshi_tradesA | Public trade history (executed prints) across the exchange or for one market. Filter by |
| kalshi_exchange_statusA | Current exchange and trading availability flags. Example: {} |
| kalshi_exchange_scheduleA | Standard trading hours and any maintenance windows for the exchange. Example: {} |
| kalshi_list_seriesA | List market series, optionally filtered by category (e.g. Economics). |
| kalshi_candlesticksA | Historical price candlesticks for a market within a series. Provide Unix epoch-seconds start/end and a period interval in minutes (1, 60, or 1440). |
| manifold_search_marketsB | Full-text search Manifold markets by term. Returns probability forecasts for crowd-sourced predictions across politics, economics, tech, etc. |
| manifold_get_marketA | Full detail for a single market including current probability, pool, and resolution status. Provide either the market id or its URL slug. |
| manifold_list_marketsB | List markets in reverse-chronological order (newest first). |
| manifold_get_userA | Public profile for a Manifold user: balance, profit, market/trade counts, bio and creation date. Identify by username or by user id. Example: { username: 'DZC' } |
| manifold_market_positionsA | Per-user positions (holdings, shares, profit) for a single market. Reveals who is on each side and how concentrated the order book is. Example: { id: 'ZtAEnyhO29' } |
| manifold_betsA | Recent bets (trades), newest first. Filter by a single market via |
| manifold_groupsA | List Manifold groups (topics/categories) markets are organized under, with member and market counts. Example: { limit: 50 } |
| manifold_commentsA | Comments on a single market — useful for crowd reasoning and sentiment behind a forecast. Example: { contractId: 'ZtAEnyhO29' } |
| sec_company_filingsA | Recent filings metadata for a company (10-K, 10-Q, 8-K, Form 4 insider, etc.) including accession numbers, form types and dates. Identify by ticker or CIK. |
| sec_company_factsA | All standardized XBRL financial facts for a company (revenue, assets, EPS, etc.) across all filings. Large payload. Identify by ticker or CIK. |
| sec_company_conceptA | Time series for one XBRL concept for a company, e.g. taxonomy 'us-gaap' + tag 'Revenues' or 'NetIncomeLoss'. Lighter than company_facts. |
| sec_full_text_searchA | Search the full text of EDGAR filings (last ~10 years). Filter by form type and date. Great for corporate-action and disclosure monitoring. |
| sec_ticker_to_cikA | Look up the SEC Central Index Key (CIK) for a ticker symbol. |
| sec_xbrl_framesA | Aggregates one XBRL fact, for one period, across ALL reporting companies — the cross-sectional complement to company_concept. Period is a calendar frame: annual durations 'CYyyyy' (e.g. CY2023), quarterly durations 'CYyyyyQn' (e.g. CY2023Q1), or instantaneous 'CYyyyyQnI' (e.g. CY2023Q1I, balance-sheet items). Example: { taxonomy: 'us-gaap', tag: 'AccountsPayableCurrent', unit: 'USD', period: 'CY2023Q1I' } |
| oecd_dataA | Query OECD data via SDMX. |
| oecd_dataflowsA | List available OECD dataflows (datasets) as SDMX structure JSON. Use to discover the dataflow id + agency needed for oecd_data. |
| oecd_data_structureA | Discover a dataflow's full structure — its dimensions, the order they appear in the |
| dbnomics_searchA | Full-text search across all DBnomics providers/datasets. Use to discover the provider_code / dataset_code needed for dbnomics_series. |
| dbnomics_seriesA | Fetch one or more series with their observations. Identify a series by provider/dataset/series codes (e.g. provider=IMF, dataset=WEO:latest, series='USA.NGDPD.us_dollars'). Returns periods + values. |
| dbnomics_providersB | List all source providers aggregated by DBnomics. |
| dbnomics_provider_datasetsA | List the datasets published by one provider, with their codes and names. Use to discover a dataset_code (paired with the provider) for dbnomics_dataset or dbnomics_series. Example: { provider: "IMF" } |
| dbnomics_datasetA | Fetch metadata for one dataset: its name, dimensions, and the codes/labels for each dimension. Use to learn how to build a series mask for dbnomics_series. Example: { provider: "IMF", dataset: "AFRREO" } |
| crypto_fear_greed_indexA | Crypto market sentiment index (0 = extreme fear, 100 = extreme greed). Returns the latest value plus history for the requested number of days. |
| congress_house_tradesA | US House of Representatives stock transactions (Stock Watcher). Filter by ticker, representative name, and/or transaction-date range; returns the most recent matches. Example: { ticker: 'NVDA', startDate: '2024-01-01' } |
| congress_senate_tradesA | US Senate stock transactions (Stock Watcher). Filter by ticker, senator name, and/or transaction-date range; returns the most recent matches. Example: { person: 'Tuberville', startDate: '2023-01-01', endDate: '2023-12-31' } |
| flights_live_statesA | Live state vectors (position, altitude, velocity, callsign) for aircraft. Optionally bound to a lat/lon box. Useful for tracking corporate-jet and supply-chain air activity. |
| flights_by_aircraftA | Flights flown by a specific aircraft (ICAO24) within a time window. Time window must be <= 30 days. Unix epoch seconds. |
| flights_by_airportA | Flights arriving at or departing from an airport (ICAO code) within a time window (<= 7 days). Unix epoch seconds. |
| flights_trackA | Trajectory (waypoints: time, lat, lon, baro altitude, heading, on-ground) for a single aircraft. Use time=0 for the live/most-recent track, or a Unix epoch-seconds value within a flight to fetch that historical track (OpenSky only retains historical tracks for a limited window). Verified to work anonymously, but may require OpenSky credentials under heavy load. Example: { icao24: '39de4f', time: 0 } |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| catalog | Inventory of every data provider, the category it serves, whether it needs a key, and the tools it exposes. |
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/CohenD/fin-data-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server