Skip to content
MCP server

Finance MCP

Read-only brokerage and market data for AI assistants, with human-approved orders

Runs locallyStatus and history
Install
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-mcp

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

How AIPoweredBot checks servers