ibkr-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IBKR_ACCOUNT_ID | No | Default account ID (auto-detected if not provided) | |
| IBKR_TIMEOUT_MS | No | Request timeout in ms | 15000 |
| IBKR_GATEWAY_URL | No | Client Portal Gateway URL (IBeam default: 5000) | https://localhost:5001 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_auth_statusA | Check if the Client Portal Gateway is authenticated. Returns auth state, competing session flag, and connection status. |
| reauthenticateB | Trigger re-authentication of the Client Portal Gateway session. |
| ping_sessionA | Send a tickle/keepalive to the Client Portal Gateway. |
| get_accountsA | List all brokerage accounts with IDs and capabilities. Returns account IDs that can be used with other tools. |
| get_account_summaryA | Get curated account summary: net liquidation, cash, buying power, margin, gross position value, P&L, and cash breakdown by currency. Returns the most important fields only — use get_account_summary_full for all 70+ fields. |
| get_account_summary_fullA | Get the full raw account summary with all 70+ fields including segment-level duplicates (-s suffix). Use get_account_summary for a curated version. |
| get_account_allocationA | Get asset class allocation breakdown showing distribution across stocks, options, futures, cash, bonds, etc. as percentages and values. |
| get_positionsA | Get all open positions for an account. Auto-paginates through all pages. Returns stocks, options, futures, etc. Each position includes: symbol, quantity, avg cost, market value, unrealized P&L, daily P&L. Option positions also include: strike, right (C/P), expiry, multiplier. |
| get_position_by_conidA | Get a specific position by contract ID (conid). Returns position details including quantity, avg cost, market value, unrealized P&L, and daily P&L. |
| get_pnlA | Get account-level profit and loss data: daily P&L (dpl), unrealized P&L (upl), net liquidity (nl), and excess liquidity (el). Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_performanceA | Get historical account performance including NAV and time-weighted returns over a configurable period. |
| get_transaction_historyC | Get transaction history for accounts with optional filters. |
| get_market_snapshotA | Get real-time market data snapshot with human-readable field names. Returns: symbol, lastPrice, bid, ask, volume, open, high, low, close, change, changePercent, week52High, week52Low, sector, industry, avgVolume, revenueGrowthPct, epsGrowthPct, changeFrom52wkHighPct, price bands (10d/30d). Also returns peRatio, eps, dividendYieldPct, marketCap, impliedVolatility when your IB market data subscription includes them. Auto-retries on first-call warmup. |
| get_price_historyA | Get historical OHLCV price bars for a contract. Supports various periods and bar sizes. Requires brokerage session (auto-acquired, auto-releases after idle). |
| search_contractsA | Search for securities by symbol or company name. Returns contract IDs (conids), symbol, exchange, security type, and description. Use the returned conid with other tools. |
| get_contract_detailsA | Get full contract details for a known contract ID (conid). Returns exchange, currency, trading hours, tick size, and other specs. |
| get_stock_contractsA | Look up stock contracts by symbol across all exchanges. Returns available contract variants with exchange and conid. |
| get_futures_contractsA | Look up non-expired futures contracts by underlying symbol. |
| get_option_chainA | Get available option expirations and strikes for an underlying security. Returns the list of strikes for calls and puts. Fast — single API call. To get conids for specific strikes, use get_option_contracts. |
| get_option_contractsA | Get option contract details (conids) for specific strikes. Returns conids you can use with get_market_snapshot for pricing/IV. Fetches up to 10 strikes at a time to stay fast. |
| get_option_strikesA | Get available strike prices for options on an underlying security for a specific expiration month. |
| get_scanner_paramsA | Get available market scanner parameters. Cached for 15 minutes. Requires brokerage session (auto-acquired, auto-releases after idle). |
| run_scannerA | Execute a market scanner to find securities matching specific criteria. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_live_ordersA | List all currently live/working orders. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_order_statusA | Get detailed status of a specific order. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_tradesA | Get trade execution history (current day + 6 previous days). Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_watchlistsA | List saved watchlists. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_watchlistA | Get contracts in a specific watchlist by ID. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_exchange_rateA | Get the current exchange rate between two currencies. Requires brokerage session (auto-acquired, auto-releases after idle). |
| get_news_sourcesA | List available news sources/providers from IB. |
| get_news_briefingA | Get the latest market news briefing from Briefing.com. Returns a full market commentary/analysis article. |
| get_fundamentalsA | Get company metadata for a stock: name, sector, sectorGroup, industry, listing exchange, country, currency, asset type, options availability, CUSIP. IBKR Client Portal API does NOT expose financial statements (balance sheet, income statement, cash flow), valuation ratios (P/E, market cap, EPS), or dividend data — those fields are deprecated by IBKR. For revenue/EPS growth %, 52-week range, sector/industry from market data, use get_market_snapshot. For OHLCV history, use get_price_history. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yigitabi5444/yigit_ibkr_mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server