Skip to main content
Glama

finance-mcp

Live financial data for any LLM agent. Stock quotes · crypto · SEC filings · insider trades · XBRL financials · FX · macro

CI npm License: MIT Node MCP API key Tools


Why

Most finance APIs want a signup, a key, and a credit card before your agent can answer "what's Apple trading at?"

finance-mcp wraps five genuinely free public sources behind eleven MCP tools. No key for any of them. The only configuration is an email address, and only because the SEC insists on one.

The one you can't get anywhere else

Company insiders — officers, directors, 10% owners — must report every trade in their own stock to the SEC within two business days. It's public, it's structured, and essentially nobody reads it.

The catch is that most of it means nothing. Options vest. Shares get withheld to pay the tax on that vesting. None of it is a decision, and all of it gets reported as "insider selling."

get_insider_activity separates the two. Real output, Apple, one week in June:

OPEN-MARKET (a deliberate decision to trade)
  Sold:   5 filing(s)   302.92K shares   ≈ $87,566,268.55

MECHANICAL (vesting, option exercises, tax withholding — no decision): 1 filing(s)

  Newstead Jennifer — SVP, GC and Secretary
      2026-06-15  +30.10K @ —         Option exercise / conversion
      2026-06-15  −16.24K @ $296.42   Shares withheld for taxes      ← not a trade

  LEVINSON ARTHUR D — Director
    ★ 2026-05-06  −149.53K @ $284.57  Open-market sale               ← a real decision
    ★ 2026-05-06  −100.47K @ $285.04  Open-market sale
      2026-05-06  −5.00K   @ —        Gift

Same company, same month. One of those is a signal; the other is payroll. Every row links to the filing it came from.

It reports what was disclosed and does not interpret it. Insider buying and selling both have innocent explanations, and neither predicts the share price.

So we measured how often it matters

That claim is testable, so we tested it: every Form 4 filed by an insider at an S&P 100 company over twelve months — 2,969 filings — classified by whether the filing contains an actual decision to trade.

Roughly seven in ten insider filings contain no decision to trade at all. At the median company it's 83%.

A second result surprised us more. Corporations file Form 4s too, as 10% owners — and 53 filings, 1.8% of the sample, accounted for 65% of every disposed share. The largest single "insider" in the data was Honeywell International Inc, disposing of 317M shares of a company it was spinning off. Rank insiders by share count and the top of the list isn't people.

Method, caveats and the raw data are in analysis/. It re-runs from scratch with two commands.

Related MCP server: Wealthnow

Tools

Tool

What it does

get_stock_quote

Current price, day/52-week range, volume — stocks, ETFs, indices

get_price_history

OHLCV candles plus period return and high/low summary

search_symbols

Resolve a company name to a ticker

get_fx_rate

Currency conversion at ECB reference rates

get_crypto_price

Spot price, 24h change, market cap, volume

get_crypto_market

Top coins ranked by market cap

get_insider_activity

Form 4 insider trades — open-market decisions separated from vesting/tax noise

get_sec_filings

Recent EDGAR filings with direct document URLs, filterable by form

get_sec_financials

As-filed XBRL line items as a time series

search_sec_filings

Full-text search across every EDGAR filing since 2001

get_economic_indicator

World Bank macro series — GDP, inflation, unemployment, debt, trade

How it fits together

flowchart LR
    A["Claude Desktop<br/>Claude Code<br/>any MCP client"] -->|MCP over stdio| B["finance-mcp"]
    B --> C["Yahoo Finance<br/><i>equities · ETFs · indices</i>"]
    B --> D["CoinGecko<br/><i>crypto</i>"]
    B --> E["SEC EDGAR<br/><i>filings · XBRL · insider trades</i>"]
    B --> F["ECB / Frankfurter<br/><i>FX</i>"]
    B --> G["World Bank<br/><i>macro</i>"]

The shared HTTP layer paces requests per host, retries 429/403/5xx with exponential backoff, honours Retry-After, and caches responses in memory — 30s for quotes, hours for filings and macro series.

Quickstart

claude mcp add finance -e SEC_USER_AGENT="Your Name your@email.com" -- npx -y finance-data-mcp
git clone https://github.com/adididitagain/finance-mcp.git
cd finance-mcp
npm install
npm run build
claude mcp add finance -e SEC_USER_AGENT="Your Name your@email.com" -- node "$(pwd)/dist/index.js"

Add to claude_desktop_config.json — on macOS, ~/Library/Application Support/Claude/claude_desktop_config.json — then restart the app:

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "finance-data-mcp"],
      "env": {
        "SEC_USER_AGENT": "Your Name your@email.com"
      }
    }
  }
}

To run from a local clone instead, use "command": "node" with "args": ["/absolute/path/to/finance-mcp/dist/index.js"].

The server speaks MCP over stdio. Run node dist/index.js and point your client at it.

Try it

What's Apple trading at?

Compare BTC and ETH over the last 24 hours.

Show me Microsoft's revenue for the last 5 years from their filings.

What 8-Ks has Tesla filed recently?

Which companies mention "quantum computing" in their 10-Ks?

What's India's GDP growth been over the past decade?

Convert 5000 USD to JPY.

Are Apple insiders actually selling, or is that just vesting?

Data sources

Source

Used for

Key required

Yahoo Finance

Equities, ETFs, indices, exotic FX

No

CoinGecko

Cryptocurrency

No

SEC EDGAR

Filings, XBRL financials, Form 4 insider trades

No (User-Agent required)

Frankfurter / ECB

FX reference rates

No

World Bank

Macroeconomic indicators

No

Configuration

Env var

Required

Purpose

SEC_USER_AGENT

For SEC tools

EDGAR requires a User-Agent with a real name and email on every request, and returns 403 without one. Format: "Your Name your@email.com".

IMPORTANT

MCP clients donot pass your shell environment to the server. Set SEC_USER_AGENT in the client config shown above, not in .zshrc.

Development

npm run dev      # tsc --watch
npm test         # 66 offline tests, stubbed fetch + real EDGAR fixtures, no network
npm run smoke    # drives all 11 tools against the live APIs

Notes and limitations

  • Yahoo rate-limits by IP, and it cares what you claim to be. Sending a spoofed desktop-browser User-Agent gets you throttled hard — measured 0/8 successful requests with a Chrome UA versus 8/8 with an honest finance-mcp/0.1 one, alternating back to back. This server identifies itself honestly for that reason; don't "fix" it by pretending to be a browser. FX is served from the ECB instead, which has no rate limit.

  • Quotes may be delayed up to ~15 minutes and are not exchange-official.

  • SEC XBRL figures are as-filed. get_sec_financials labels each row by the period it covers, not the fiscal year of the filing it came from — EDGAR's own fy field describes the filing, so a 10-K restating a prior year would otherwise mislabel it.

  • search_sec_filings ranks by EDGAR's relevance, which favours companies with your query in their name.

  • World Bank data is annual and typically lags one to two years.

  • Insider data is only as complete as the window you read. get_insider_activity reads the most recent limit Form 4s and reports how many it skipped — a large company files hundreds a year, so a small limit shows a recent slice, not a full picture. Form 4s are due within two business days of the trade, so there is a short reporting lag.

Disclaimer

An informational data tool. Nothing it returns is investment advice, and the data carries no accuracy or availability guarantee. Verify anything you intend to act on against an official source.

License

MIT © Aditya Bisht

Available Tools

11 tools
get_crypto_marketGet top crypto by market capA
Read-only

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.

Inputs: limit, vs_currency.

get_crypto_priceGet crypto priceA
Read-only

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.

Inputs: coins (required), vs_currency.

get_economic_indicatorGet economic indicatorA
Read-only

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.

Inputs: limit, country, indicator.

get_fx_rateGet FX rateA
Read-only

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.

Inputs: to (required), from (required), amount.

get_insider_activityGet insider trading activityA
Read-only

What a company's own officers, directors and 10% owners have been buying and selling in its stock, from their SEC Form 4 filings. Insiders must report within two business days, so this is the freshest disclosed signal about a company available anywhere. Crucially, it separates open-market trades — where someone actively chose to buy or sell — from mechanical activity like options vesting and shares withheld to pay the tax on that vesting. Most reported 'insider selling' is mechanical and means nothing; headlines routinely conflate the two. Read the open-market numbers, and treat the mechanical count as noise. US SEC registrants only. This reports what was disclosed and does not interpret it — insider buying and selling both have innocent explanations, and neither predicts the share price.

Inputs: company (required), limit, since.

get_price_historyGet price historyA
Read-only

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.

Inputs: symbol (required), range, interval, max_rows.

get_sec_filingsGet SEC filingsA
Read-only

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.

Inputs: company (required), forms, limit.

get_sec_financialsGet SEC XBRL financialsA
Read-only

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.

Inputs: company (required), limit, period, concept.

get_stock_quoteGet stock quoteA
Read-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.

Inputs: symbols (required).

search_sec_filingsFull-text search SEC filingsA
Read-only

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.

Inputs: query (required), forms, limit, date_to, +1 more.

search_symbolsSearch ticker symbolsA
Read-only

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.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct financial domain or action: quotes vs. history vs. symbol lookup, currencies vs. crypto, SEC documents vs. financials vs. text search, and macro indicators. Even similar tools like get_stock_quote and get_price_history are clearly separated by point-in-time vs. time series, and get_sec_filings vs. get_sec_financials by documents vs. numbers.

    Naming Consistency5/5

    All tool names follow a consistent lowercase snake_case pattern with a leading verb: 'get_' for retrievals and 'search_' for searches. The object nouns are descriptive and hierarchical (e.g., crypto_price vs. crypto_market, sec_filings vs. sec_financials), making the pattern predictable and easy to navigate.

    Tool Count5/5

    With 11 tools, the server strikes a balanced scope for a finance data provider. It covers equities, FX, crypto, SEC filings, insider activity, and macroeconomic indicators without unnecessary granularity or padding. Each tool addresses a distinct need, and the count is within the ideal 3–15 range.

    Completeness5/5

    The tool surface is remarkably complete for a read-only finance data API. It includes current prices, historical data, symbol resolution, FX conversion, crypto spot and market rankings, SEC document retrieval, full-text search, financial statement line items, insider trades, and World Bank macro indicators. There are no obvious gaps that would dead-end an agent for common finance workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.

      https://mcp.ko.io/mcp
    • Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.

    • Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.

    • Your agent needs company financials it can compute on — statements, ratios, earnings, estimates, filings and insider activity as structured data, not a PDF. **What you can ask for** • "Give me 8 quarters of income statement, balance sheet and cash flow for this ticker." • "What do analysts estimate for next quarter, and how did the last four surprise?" • "Find this exact line item across every filing." • "Who bought or sold as an insider in the last 90 days?" • "Screen for profitable companies under this valuation with growing revenue." **How to use it** Point any MCP client at https://mcp.aisa.one/marketpulse/mcp and sign in with OAuth — there is no key to create or paste. 21 tools: prices and snapshots, income statements, balance sheets, cash-flow statements, financial metrics and snapshots, earnings, analyst estimates, company facts, filings and filing items, line-item search, a screener, insider trades, macro interest rates, news, plus EDINET documents and filing digests for Japanese issuers. **Why this rather than the source** Statements as fields you can compute on, and a screener in the same place. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the fundamentals here, then ask the same agent what social is saying about the ticker — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 10 financial data tools (market data, economic indicators, news, insider trades, and calendars) via a single MCP layer, enabling any MCP-compatible LLM to access diverse financial data through a unified interface.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Institutional financial data for AI agents: credit, private markets, options history, filings.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to retrieve US stock market OHLCV data, company fundamentals and financial statements, FRED macroeconomic indicators, market news, Reddit/StockTwits sentiment, and Polymarket prediction market probabilities via simple tools.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through a standardized MCP interface. It provides 250+ tools across categories such as financial statements, quotes, technical indicators, ETFs, crypto, forex, commodities, economics, and SEC filings.
      558 npm
      Apache 2.0