# Finance MCP

> Finance MCP is an open-source MCP server for finance and payments. Read-only brokerage and market data for AI assistants, with human-approved orders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, self-hosted
- **Repository:** https://github.com/blahaj-gif/finance-mcp
- **MCP Registry name:** io.github.Blahaj-gif/hitl-finance-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/finance-mcp-2
