io.github.AdityaSBisht/finance-mcp

Ranked table of the largest cryptocurrencies by market cap, with 24h and 7d performance, from CoinGecko. Use this to survey or discover the market — 'what are the biggest coins', 'what moved this week'. When you already know which coins you care about, use get_crypto_price instead: it takes explicit names and avoids pulling a whole ranking. Always returns the top N by market cap starting at rank 1; there is no paging or filtering, so a coin outside the top `limit` will not appear no matter how it performed.

Spot price, 24h change, market cap, and 24h volume for specific cryptocurrencies you name, from CoinGecko. Use this when you know which coins you want; use get_crypto_market instead to rank the market or discover the largest coins. Accepts common tickers ("btc", "eth", "sol") or CoinGecko ids ("bitcoin", "matic-network"); unknown names are reported back rather than failing the whole call, so a typo returns the other coins. Prices are near-real-time but not exchange-official. Stocks and FX are not available here — use get_stock_quote and get_fx_rate.

Macroeconomic time series by country from the World Bank — GDP, GDP growth, inflation, unemployment, population, government debt, trade balance and more — returned newest year first with year-over-year change. Use this for country-level economics; it says nothing about any individual company or security, which is what the market-data and SEC tools cover. Data is **annual only**, so it cannot answer questions about this month or this quarter, and reporting lags: the last one or two years are frequently unreported and are omitted rather than returned as zero. Coverage varies by country and indicator, so a valid pairing can still be empty.

Convert between two currencies at the latest published reference rate, with the change since the prior session. Returns both the rate and, when `amount` is given, the converted total. Major currencies come from the European Central Bank (published once per business day, so the rate is a daily fix rather than a live tick); pairs outside the ECB's ~30 currencies fall back to Yahoo. Use get_crypto_price for crypto — BTC and ETH are not currencies here. These are indicative mid-market rates, not dealable quotes, so they will not match what a bank charges.

Historical OHLCV candles for a stock, ETF, index, or FX pair from Yahoo Finance, plus the period return and a high/low/average summary. Use this for 'how has NVDA done this year?' or any question about change over time; use get_stock_quote when you only need the current price. Does not cover cryptocurrencies. Intraday intervals (1m–1h) are only retained by Yahoo for short ranges — pair them with 1d/5d/1mo, and use 1d or coarser for 1y and beyond, or the response comes back empty. Candles with no trade are omitted, so gaps in the series are expected.

Recent SEC EDGAR filings for one US-listed company, newest first, with direct document URLs you can cite or fetch. Filter by form type (10-K annual report, 10-Q quarterly, 8-K material event, 4 insider trade, S-1 IPO, 13F fund holdings, DEF 14A proxy); an amended form such as 10-K/A is returned when you ask for its base form. Use this to find documents for a company you can already name. Use search_sec_filings instead to search filing text across all companies, and get_sec_financials to read reported numbers rather than locate documents. US SEC registrants only — non-US listings do not file with EDGAR.

Reported financial line items straight from a US company's XBRL filings — revenue, net income, EPS, assets, cash, operating cash flow and more — as an annual or quarterly time series. These are as-filed audited figures, not analyst estimates or forecasts, so prefer this over any market-data tool for fundamentals. Use get_sec_filings instead when you want the documents rather than the numbers. Each row is labelled by the period it covers; where a later filing restated a period, the most recently filed value is returned. Filers tag the same concept differently, so a concept alias is tried against several us-gaap tags and the response names the tag actually used — expect the tag to differ between companies. US SEC registrants only.

Latest price and daily change for one or more stocks, ETFs, or indices, from Yahoo Finance. Use Yahoo-style symbols: AAPL, MSFT, VOO, ^GSPC (S&P 500), ^IXIC (Nasdaq), RELIANCE.NS (India), 7203.T (Japan). Call search_symbols first if you only have a company name. Returns a single point in time — use get_price_history for a series or a period return, and get_crypto_price for cryptocurrencies, which are not on Yahoo symbols. Prices may be delayed up to ~15 minutes and are not exchange-official, so do not treat them as execution prices. Symbols are looked up independently: one bad symbol does not fail the rest.

Search the full text of every SEC filing since 2001 to find which companies discuss a topic — e.g. "AI data center capex" in 10-Ks. Wrap a phrase in double quotes for exact matching; unquoted terms match loosely and return far more noise. Use this for discovery across companies. When you already know the company, get_sec_filings is more direct. Results are ranked by EDGAR's own relevance, which favours companies with your query in their *name* — a search for a common term may surface a company called after it ahead of substantive discussion. Totals above 10,000 are reported as approximate. Filings before 2001 are not indexed.

Resolve a company or fund name to a ticker symbol using Yahoo Finance search. Call this first whenever you have a name rather than a symbol — "Apple" → AAPL — then pass the symbol to get_stock_quote or get_price_history. Covers equities, ETFs, and indices across global exchanges, so the same company may return several listings; prefer the one whose exchange matches the market you want. For US-listed companies you need SEC data on, get_sec_filings accepts a company name directly and needs no symbol lookup.