Finance MCP
Read-only brokerage and market data for AI assistants, with human-approved orders
- Pricing
- Open source
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- today
Similar MCP servers
About Finance MCP
Finance MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
The assistant can read your account and draft an order, but it has no way to send one. Drafts go to a local queue, and sending needs a broker preview plus your click in a separate Streamlit dashboard. The README says no prompt can reach that path.
The server exposes 38 tools over Webull, Saxo, IBKR, Yahoo Finance, SEC EDGAR, BLS, the Federal Reserve and the BEA. Only the tools your configured broker can serve are registered, so a given account sees 36 or 37, and 28 work with no broker at all. Most tools carry read-only annotations; cancel_order is the one marked destructive.
Filings are parsed rather than forwarded: Form 4 with transaction codes and 10b5-1 status, 8-K by item code, 13F, 13D/G and inline XBRL. Analysis covers 96 technical indicators, Black-Scholes greeks, backtesting and ATR-based position sizing. Only the Webull adapter has been run against a live account; the Saxo and IBKR adapters are built from published docs and flag that in their output.
Install
Run in a terminal
claude mcp add hitl-finance-mcp --env WEBULL_APP_KEY='<WEBULL_APP_KEY>' --env WEBULL_APP_SECRET='<WEBULL_APP_SECRET>' --env SAXO_ACCESS_TOKEN='<SAXO_ACCESS_TOKEN>' --env BLS_API_KEY='<BLS_API_KEY>' -- uvx hitl-finance-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hitl-finance-mcp": {
"command": "uvx",
"args": [
"hitl-finance-mcp"
],
"env": {
"WEBULL_APP_KEY": "<WEBULL_APP_KEY>",
"WEBULL_APP_SECRET": "<WEBULL_APP_SECRET>",
"SAXO_ACCESS_TOKEN": "<SAXO_ACCESS_TOKEN>",
"BLS_API_KEY": "<BLS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hitl-finance-mcp": {
"command": "uvx",
"args": [
"hitl-finance-mcp"
],
"env": {
"WEBULL_APP_KEY": "<WEBULL_APP_KEY>",
"WEBULL_APP_SECRET": "<WEBULL_APP_SECRET>",
"SAXO_ACCESS_TOKEN": "<SAXO_ACCESS_TOKEN>",
"BLS_API_KEY": "<BLS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hitl-finance-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"hitl-finance-mcp"
],
"env": {
"WEBULL_APP_KEY": "<WEBULL_APP_KEY>",
"WEBULL_APP_SECRET": "<WEBULL_APP_SECRET>",
"SAXO_ACCESS_TOKEN": "<SAXO_ACCESS_TOKEN>",
"BLS_API_KEY": "<BLS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hitl-finance-mcp": {
"command": "uvx",
"args": [
"hitl-finance-mcp"
],
"env": {
"WEBULL_APP_KEY": "<WEBULL_APP_KEY>",
"WEBULL_APP_SECRET": "<WEBULL_APP_SECRET>",
"SAXO_ACCESS_TOKEN": "<SAXO_ACCESS_TOKEN>",
"BLS_API_KEY": "<BLS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hitl-finance-mcp": {
"command": "uvx",
"args": [
"hitl-finance-mcp"
],
"env": {
"WEBULL_APP_KEY": "<WEBULL_APP_KEY>",
"WEBULL_APP_SECRET": "<WEBULL_APP_SECRET>",
"SAXO_ACCESS_TOKEN": "<SAXO_ACCESS_TOKEN>",
"BLS_API_KEY": "<BLS_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WEBULL_APP_KEYWebull OpenAPI app key. Without it prices fall back to Yahoo and the account and order tools are unavailable; everything else still works.WEBULL_APP_SECRETWebull OpenAPI app secret. Signs every request; the app key alone cannot authenticate.WEBULL_REGION_IDWebull region: us, hk, jp, sg, th, my, uk, au, eu, br, mx, za.WEBULL_ENVIRONMENTprod trades the real account. paper repoints the ENTIRE client at Webull's sandbox, quotes included, and needs separate sandbox credentials — production keys return 401 there.FINANCE_BROKERWhich broker adapter the account and order tools use, and where prices come from: webull, saxo or ibkr. Only the tools the configured broker can serve are registered, so the tool list never advertises one that would refuse. Webull is the only adapter that has been run against a live account; saxo and ibkr are written from published documentation and say so in every result they produce.SAXO_ACCESS_TOKENOnly for FINANCE_BROKER=saxo. A 24-hour simulation token comes from Saxo's Developer Portal with no approval process and no live money; live access needs the OAuth2 code flow. UNVERIFIED ADAPTER.SAXO_ENVIRONMENTsim or live. Selects Saxo's simulation gateway or the live one.IBKR_BASE_URLOnly for FINANCE_BROKER=ibkr. This is the Client Portal Web API, not the TWS socket API: run IBKR's Client Portal Gateway and log in at https://localhost:5000 in a browser first. A paper account works and is the better choice. UNVERIFIED ADAPTER.IBKR_TLS_INSECURESet to 1 to accept the Client Portal Gateway's self-signed certificate unverified, or point IBKR_CACERT at it instead. This is a decision about the connection carrying your orders, so it is never made for you.SEC_USER_AGENTA descriptive User-Agent with a real contact address, e.g. 'Jane Doe (jane@example.com)'. The SEC's fair-access policy requires it and the filings tools refuse to send requests without one rather than risk an IP ban.BLS_API_KEYOptional. BLS allows 25 macro queries a day without a key; a free key raises it to 500 and extends history from 10 to 20 years.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- draft_order
- Writes an order draft to a local queue for later broker preview.
- preview_order
- Previews a drafted order with the broker.
- cancel_order
- Cancels a resting order; the one tool marked destructive.
- get_account_info
- Reads account details.
- get_open_positions
- Lists open positions.
- get_open_orders
- Lists open orders.
- calculate_position_size
- Sizes a position from an ATR-aware stop.
- get_portfolio_risk
- Reports portfolio concentration and correlation.
What it does
- Draft-only order flow
- The assistant drafts orders to a local queue; sending requires a broker preview and approval in the dashboard.
- Parsed SEC filings
- Form 4, 8-K, 13F, 13D/G, 144, NPORT and inline XBRL come back as answers instead of raw XML.
- Integrity-checked prices
- Webull bars with a Yahoo fallback are checked for ordering, staleness and OHLC sanity.
- Macro calendar
- BLS, FOMC and BEA events, each row showing the print or the prior one, never a forecast.
- Technical and options analysis
- 96 indicators, volume profile, greeks, implied volatility and backtesting.
- Pre-trade checks
- Blocks naked shorts and verifies per-currency buying power before an order is drafted for preview.
- Broker-aware tool list
- Only tools the configured broker can serve are registered.
Good for
- Ask an assistant to summarise recent insider Form 4 filings for a ticker
- Check open positions and portfolio concentration before sizing a trade
- Pull the upcoming economic calendar around FOMC and PCE dates
- Draft an order for review, then approve it yourself in the dashboard
- Run an options greeks or implied volatility calculation in chat
Pricing
Open source
Open source; broker and data-provider terms apply
Finance MCP FAQ
Can the assistant place trades?
No. It can draft an order into a local queue, and only you can send it from the dashboard after a broker preview.
Do I need a broker account?
No. Without broker credentials 28 of the 38 tools still work, with prices from Yahoo.
Which brokers are supported?
Webull, Saxo and Interactive Brokers, chosen with FINANCE_BROKER. Only Webull has been run against a live account.
What keys does it need?
SEC filings need SEC_USER_AGENT with a contact address. A free BLS key is optional and raises the daily query limit from 25 to 500.
How do I install it?
Install the hitl-finance-mcp package from PyPI, for example with uv, and point your MCP client at the finance-mcp command.
Is Finance MCP free?
Yes. Finance MCP is open source, so you can use and self-host it for free.
How do I add Finance MCP to Claude Code?
Run this command in your terminal: claude mcp add hitl-finance-mcp --env WEBULL_APP_KEY='<WEBULL_APP_KEY>' --env WEBULL_APP_SECRET='<WEBULL_APP_SECRET>' --env SAXO_ACCESS_TOKEN='<SAXO_ACCESS_TOKEN>' --env BLS_API_KEY='<BLS_API_KEY>' -- uvx hitl-finance-mcp
What are the best alternatives to Finance MCP?
The closest alternatives to Finance MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

