Finance MCP Server

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

Local serverstdio

What is the Finance MCP Server?

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

Packages and local setup

The published pypi package is hitl-finance-mcp, version 0.3.1. Its declared MCP transport is stdio.

The package declares WEBULL_APP_KEY: Webull OpenAPI app key. Without it prices fall back to Yahoo and the account and order tools are unavailable; everything else still works.; WEBULL_APP_SECRET: Webull OpenAPI app secret. Signs every request; the app key alone cannot authenticate.; WEBULL_REGION_ID: Webull region: us, hk, jp, sg, th, my, uk, au, eu, br, mx, za.; WEBULL_ENVIRONMENT: prod 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_BROKER: Which 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_TOKEN: Only 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_ENVIRONMENT: sim or live. Selects Saxo's simulation gateway or the live one.; IBKR_BASE_URL: Only 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_INSECURE: Set 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_AGENT: A 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_KEY: Optional. 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.3.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related finance & market data MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
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.Optional
WEBULL_APP_SECRETWebull OpenAPI app secret. Signs every request; the app key alone cannot authenticate.Optional
WEBULL_REGION_IDWebull region: us, hk, jp, sg, th, my, uk, au, eu, br, mx, za.Optional
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.Optional
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.Optional
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.Optional
SAXO_ENVIRONMENTsim or live. Selects Saxo's simulation gateway or the live one.Optional
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.Optional
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.Optional
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.Optional
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.Optional