Finance MCP server
io.github.Blahaj-gif/hitl-finance-mcp·v0.3.1·3 starsMarket data, SEC filings and risk tools for Webull, Saxo and IBKR. Only you can send an order.
3 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Finance MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Finance MCP tools (31)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
check_connectionTests the configured price feed and its Yahoo Finance fallback.
compare_symbolsCompares relative strength, price correlation, and return performance between two tickers.
get_company_financialsHeadline financials taken straight from the company's filed XBRL on SEC EDGAR — revenue, net income, diluted EPS, assets, liabilities, cash, equity and shares outstanding. Every figure carries the form and filing date it came from.
get_company_profileEverything worth knowing about a company, in one call. Start here.
get_data_sourcesConfiguration and remaining quota for every external data source, plus how to raise the limits. Use this when a data tool fails or seems rate-limited.
get_earningsNext earnings date, historical EPS estimates vs actuals, and — critically — whether the upcoming date is CONFIRMED or merely Yahoo's ESTIMATE.
get_economic_calendarUpcoming US macroeconomic events with their scheduled date, time and — where the release has already happened — the number that came out.
get_edgar_filingsSEC EDGAR filings, as close to real time as a public feed allows — timestamps carry the second the SEC accepted the document.
get_insider_activityParsed SEC Form 4 insider transactions — who traded, when, at what price, and crucially **whether the sale was made under a Rule 10b5-1 plan**.
get_insider_tradesRecent insider transactions as Yahoo reports them — a quick summary view.
get_institutional_holdingsLatest 13F-HR portfolio for an institutional manager — every reported position, largest first. Accepts a ticker (BRK-B) or a raw CIK (1067983).
get_journal_summaryQueries local Trading Journal DB for win rate, total trades, average confidence, and recent trade logs.
get_macro_dataHistorical macroeconomic series from the BLS with month-over-month and year-over-year changes — the numbers behind the inflation and labour narrative.
get_market_analysisPrice action and 50+ technical indicators for a symbol, reported as measured values with each indicator's own standard reading (oversold / overbought, above / below its signal line, inside / outside its band).
get_multi_timeframePerforms multi-timeframe analysis across Daily (D), 1-Hour (H1), and 15-Min (M15) for a symbol to compute a Confluence Score.
get_newsFetches the most recent news headlines for a given stock using Yahoo Finance. Crucial for analyzing fundamental catalysts or identifying the source of technical momentum breakouts.
get_ohlcvFetches raw OHLCV (Open, High, Low, Close, Volume) candlestick bars for a symbol. Use when you need the price series itself — to eyeball recent action or do your own maths. For indicators use get_technical_indicators; for a verdict use get_market_analysis.
get_options_analyticsOptions analytics beyond a raw chain: implied-volatility rank and percentile against the past year of realised volatility, the ATM straddle's implied move, put/call skew, and Black-Scholes greeks for near-the-money strikes.
get_options_chainOption chain around the money, with IV rank and the market-implied expected move at the top — the two numbers that tell you whether the board is cheap or dear and how far it is priced to travel.
get_sec_filingsFetches the most recent SEC filings (10-K, 10-Q, 8-K) and their URLs. Provides raw access to corporate regulatory documents.
get_sector_heatmapScans the 11 major S&P sector ETFs (Technology, Financials, Energy, Healthcare, Industrial, Consumer, Utilities, Real Estate, Materials) by momentum to identify sector rotation.
get_short_interestFetches short interest metrics (Short % of Float, Days to Cover / Short Ratio, Shares Short) for squeeze or squeeze-fade thesis.
get_technical_indicatorsReturns the latest calculated technical indicator values in markdown table format. Use when you want the raw indicator numbers to reason over yourself. If you want the numbers already interpreted into a BUY/SELL verdict, call get_market_analysis instead.
get_unusual_optionsScans for unusual options activity (Volume > Open Interest or high IV > 50%) to detect smart money positioning.
get_updatesWhat has actually changed since a point in time: new SEC filings, macro releases that have printed, and outsized price moves.
get_volume_profileVolume-by-price for a symbol: point of control, value area, and the high and low volume nodes around the current price.
log_journal_entryLogs a trade, market thesis, or trading theorem to the local Trading Journal database. Includes atomic file writing & de-duplication protection.
read_filingRead a named section out of a company's latest filing, or search its text.
scan_watchlistScans a list of stock tickers, calculates consensus score & regime, and returns a ranked verdict table.
set_alertSets a local price or technical indicator alert for a ticker (e.g. "RSI < 30" or "PRICE > 250").
validate_bls_keyTest a BLS registration key against the live API and report which tier it unlocks.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan34 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 16 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Finance MCP compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 77% of 2,174 E-commerce servers
- Tools
- 31
- the typical E-commerce server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 85% of 1,047 E-commerce servers
- Downloads a week
- 36
- more than 33% of 411 E-commerce servers with a package
What its tools let an agent do: 30 read · 1 change
Install Finance MCP in Claude Code, Cursor or VS Code
claude mcp add hitl-finance-mcp -- uvx hitl-finance-mcp
What the publisher says
From the Finance MCP repository's README, as published. We do not edit it. Read it on GitHub
Finance MCP
An MCP server that gives an AI assistant read access to your real brokerage account and the market around it — and gives you, not the assistant, the only button that sends an order.
38 tools over Webull, Saxo, IBKR, Yahoo Finance, SEC EDGAR, BLS, the Federal Reserve and the BEA, plus a Streamlit dashboard that is the sole path to execution. The list is filtered to what your broker can actually serve, so a given account sees 36 or 37 of them — and 28 with no broker at all, which is a working install, not a broken one.
The assistant can draft an order. It cannot place one. Drafts go to a local queue; sending requires a broker preview and your click in the dashboard. That path does not exist on the tool side, so no prompt can reach it.
Every tool declares this to the client rather than only to the reader: 32 of 36 are annotated read-only, one is destructive (cancel_order, which pulls a resting order). A client that respects MCP annotations can wave through a price lookup and stop on the one call that reaches the market.
What this can and cannot do with your account
Asking an unknown repository for brokerage credentials is the hardest trust ask in software, so the answer is here rather than forty paragraphs down.
absent. draft_order writes to a local queue. Sending needs a broker preview and your click in the dashboard, which no prompt can reach.
- There is no execution path on the tool side. Not gated, not guarded —
indicators, options maths, earnings. With no credentials at all you get those twenty-eight, and that is a working install rather than a degraded one.
- Twenty-eight of the 38 tools never touch a broker. SEC filings, macro,
Brokers are built from published API references and have not been executed against a live or paper account. They say so in every tool output that uses them. Only Webull has been run against a real account.
- Two of the three adapters have never been run. Saxo and Interactive
the broker protocol; that one button does not, yet.
- The dashboard's submit button is Webull-only. The MCP tools route through
dashboard needs write access.
- Use a read-scoped key where your broker offers one. Nothing outside the
1,431 tests across 32 files, and CI runs them on every push.
Those all stub the network, which is correct — a suite that goes red because SEC returned a 503 overnight is a suite nobody reads. It is also why two defects survived every one of them: a euro-area series that had stopped publishing eight months earlier and was reported as current, and a filing watcher that answered 403 to every request and called itself healthy. Both needed the real internet to see. tests/testlivesources.py asks every external source for real and checks that this tool's account of the answer is true — in particular that a series marked fresh actually is. It is opt-in and skipped by default:
FINANCE_LIVE_SOURCES=1 pytest tests/test_live_sources.py -v -sIt also runs weekly in CI, because a check that depends on somebody remembering is a check that eventually stops happening — and discontinued series and broken scrapers are exactly the failures that arrive quietly over weeks. That workflow is inert until FREDAPIKEY and SECUSERAGENT exist as repository secrets, and when they do not it says so in the job summary rather than reporting a green tick that verified nothing.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Finance MCP: common questions
- Is Finance MCP server safe?
- Mostly: it is graded B (83/100). Read the Finance MCP safety report
- How do I install Finance MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Finance MCP need an API key?
- Yes. The registry entry asks for
WEBULL_APP_KEY,WEBULL_APP_SECRET,SAXO_ACCESS_TOKEN,BLS_API_KEY. - Is Finance MCP maintained?
- The last commit was 16 days ago (2026-10-19). The latest release is v0.3.1.
- What can I use instead of Finance MCP?
- Servers from other publishers that do the same job: Polymarket Toolkit MCP server, Konduto MCP server and Longbridge MCP server. Compare all Finance MCP alternatives.
- How does Finance MCP compare with other E-commerce MCP servers?
- safety score 83/100 (higher than 77% of 2,174 E-commerce servers); tools 31 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Finance MCP
Same job from other publishers: the closest match first, then the best rated.
- Polymarket ToolkitRead-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.not reviewedEstablishedB
- KondutoMCP server for Konduto — Brazilian fraud prevention: order risk scoring, device intel, listsnot reviewedGrowingB
LongbridgeUS/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & gridnot reviewedGrowingA- TikTok ShopRead-only TikTok Shop Partner API: orders, finance, products and analytics across shops.not reviewedGrowingA
- Sv NumberPhone numbers for AI agents: order a private number, read the SMS verification code, hand it back.not reviewedEstablishedB