finance-mcp
This server offers 11 MCP tools for real-time and historical financial data from free public sources—no API keys needed (only an email for SEC tools).
Stock Quotes & History: Current quotes and historical OHLCV candlesticks with configurable intervals and ranges, including period returns, for stocks, ETFs, and indices (e.g.,
get_stock_quote,get_price_history).Symbol Search: Resolve company names to ticker symbols (e.g., "Apple" → AAPL) via
search_symbols.Crypto Data: Spot prices, 24h changes, market caps, and top-coin rankings (
get_crypto_price,get_crypto_market).FX Rates: Current exchange rates with daily change using ECB reference rates (
get_fx_rate).SEC Filings: Browse recent EDGAR filings by form type (10-K, 10-Q, etc.) with direct URLs, and extract as‑filed XBRL financials as time series (
get_sec_filings,get_sec_financials).Full‑Text SEC Search: Search all filings since 2001 for specific topics, filterable by form and date (
search_sec_filings).Insider Trading: Analyze Form 4 trades, distinguishing open‑market decisions from mechanical events like vesting (
get_insider_activity).Economic Indicators: Access World Bank data (GDP, inflation, unemployment, etc.) by country (
get_economic_indicator).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@finance-mcp What's Apple trading at?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
finance-mcp
Live financial data for any LLM agent. Stock quotes · crypto · SEC filings · insider trades · XBRL financials · FX · macro
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 @ — GiftSame 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 |
| Current price, day/52-week range, volume — stocks, ETFs, indices |
| OHLCV candles plus period return and high/low summary |
| Resolve a company name to a ticker |
| Currency conversion at ECB reference rates |
| Spot price, 24h change, market cap, volume |
| Top coins ranked by market cap |
| Form 4 insider trades — open-market decisions separated from vesting/tax noise |
| Recent EDGAR filings with direct document URLs, filterable by form |
| As-filed XBRL line items as a time series |
| Full-text search across every EDGAR filing since 2001 |
| 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-mcpgit 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 |
Equities, ETFs, indices, exotic FX | No | |
Cryptocurrency | No | |
Filings, XBRL financials, Form 4 insider trades | No (User-Agent required) | |
Frankfurter / ECB | FX reference rates | No |
Macroeconomic indicators | No |
Configuration
Env var | Required | Purpose |
| For SEC tools | EDGAR requires a User-Agent with a real name and email on every request, and returns 403 without one. Format: |
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 APIsNotes and limitations
Yahoo rate-limits by IP, and it cares what you claim to be. Sending a spoofed desktop-browser
User-Agentgets you throttled hard — measured 0/8 successful requests with a Chrome UA versus 8/8 with an honestfinance-mcp/0.1one, 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_financialslabels each row by the period it covers, not the fiscal year of the filing it came from — EDGAR's ownfyfield describes the filing, so a 10-K restating a prior year would otherwise mislabel it.search_sec_filingsranks 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_activityreads the most recentlimitForm 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 toolsget_crypto_marketGet top crypto by market capARead-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 priceARead-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 indicatorARead-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 rateARead-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 activityARead-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 historyARead-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 filingsARead-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 financialsARead-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 quoteARead-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 filingsARead-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 symbolsARead-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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
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
- AlicenseNot gradedqualityDmaintenanceProvides 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.1MIT
- AlicenseNot gradedqualityBmaintenanceInstitutional financial data for AI agents: credit, private markets, options history, filings.MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmApache 2.0