MCP.Market

Finance MCP server

by Blahaj-gif·io.github.Blahaj-gif/hitl-finance-mcp·v0.3.1·3 stars

Market data, SEC filings and risk tools for Webull, Saxo and IBKR. Only you can send an order.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

3 stars36 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • check_connection

    Tests the configured price feed and its Yahoo Finance fallback.

  • compare_symbols

    Compares relative strength, price correlation, and return performance between two tickers.

  • get_company_financials

    Headline 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_profile

    Everything worth knowing about a company, in one call. Start here.

  • get_data_sources

    Configuration 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_earnings

    Next earnings date, historical EPS estimates vs actuals, and — critically — whether the upcoming date is CONFIRMED or merely Yahoo's ESTIMATE.

  • get_economic_calendar

    Upcoming US macroeconomic events with their scheduled date, time and — where the release has already happened — the number that came out.

  • get_edgar_filings

    SEC EDGAR filings, as close to real time as a public feed allows — timestamps carry the second the SEC accepted the document.

  • get_insider_activity

    Parsed 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_trades

    Recent insider transactions as Yahoo reports them — a quick summary view.

  • get_institutional_holdings

    Latest 13F-HR portfolio for an institutional manager — every reported position, largest first. Accepts a ticker (BRK-B) or a raw CIK (1067983).

  • get_journal_summary

    Queries local Trading Journal DB for win rate, total trades, average confidence, and recent trade logs.

  • get_macro_data

    Historical macroeconomic series from the BLS with month-over-month and year-over-year changes — the numbers behind the inflation and labour narrative.

  • get_market_analysis

    Price 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_timeframe

    Performs multi-timeframe analysis across Daily (D), 1-Hour (H1), and 15-Min (M15) for a symbol to compute a Confluence Score.

  • get_news

    Fetches 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_ohlcv

    Fetches 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_analytics

    Options 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_chain

    Option 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_filings

    Fetches the most recent SEC filings (10-K, 10-Q, 8-K) and their URLs. Provides raw access to corporate regulatory documents.

  • get_sector_heatmap

    Scans 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_interest

    Fetches short interest metrics (Short % of Float, Days to Cover / Short Ratio, Shares Short) for squeeze or squeeze-fade thesis.

  • get_technical_indicators

    Returns 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_options

    Scans for unusual options activity (Volume > Open Interest or high IV > 50%) to detect smart money positioning.

  • get_updates

    What has actually changed since a point in time: new SEC filings, macro releases that have printed, and outsized price moves.

  • get_volume_profile

    Volume-by-price for a symbol: point of control, value area, and the high and low volume nodes around the current price.

  • log_journal_entry

    Logs a trade, market thesis, or trading theorem to the local Trading Journal database. Includes atomic file writing & de-duplication protection.

  • read_filing

    Read a named section out of a company's latest filing, or search its text.

  • scan_watchlist

    Scans a list of stock tickers, calculates consensus score & regime, and returns a ranked verdict table.

  • set_alert

    Sets a local price or technical indicator alert for a ticker (e.g. "RSI < 30" or "PRICE > 250").

  • validate_bls_key

    Test 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

no findings
  • 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
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 -s

It 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.

All Finance MCP alternatives →
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Konduto
    MCP server for Konduto — Brazilian fraud prevention: order risk scoring, device intel, lists
    B
  • Longbridge
    US/HK markets — 163 tools: quotes, options, orders, fundamentals, screener, IPO, alerts, DCA & grid
    A
  • TikTok Shop
    Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.
    A
  • Sv Number
    Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.
    B