feat: add ibkr-reader skill (read-only)#78
Open
himself65 wants to merge 1 commit into
Open
Conversation
Add a read-only Interactive Brokers account reader to the finance-data-providers plugin group, built on IBKR's official Agentic MCP connector. Confirmed against a live authenticated connection (June 2026). Unlike the Robinhood agentic MCP (which exposed no option market data), the IBKR MCP genuinely reads option details: - get_price_snapshot returns implied volatility (underlying via implied_vol_underlying + per option contract via implied_vol / option_midpoint_iv), IV percentile, historical vol, and put/call open interest + volume (verified live: SNDK underlying IV ~98.98% annualized). - get_price_history supports OPT/FOP historical bars. Read allowlist: get_account_summary/balances/positions/orders/trades, get_order_instructions, get_price_snapshot, get_price_history, search_contracts, get_company_themes/connections, get_theme_details, search_investment_topics. Write denylist (never called): create_order_instruction, delete_order_instruction, provide_customer_feedback. Honestly documents the real limitations: the MCP has no option-chain enumeration tool (search_contracts resolves the underlying only, no strikes/expiries/IDs) and no greeks (IV only; greeks live in IBKR's Client Portal Web API, not this connector). So a full multi-strike IV skew must come from tradingview-reader / funda-data; IBKR covers the underlying IV regime, IV percentile, put/call skew, and per-contract IV of held options. The skill enumerates the live tool list at runtime and treats unknown tools as forbidden. Wires the skill into the root README, plugins/data-providers/plugin.json (description + keywords), and the marketplace manifest.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a read-only Interactive Brokers reader (
ibkr-reader) to thefinance-data-providersplugin group, built on IBKR's official Agentic MCP connector. Verified against a live authenticated connection (June 2026).This is the pivot from the closed Robinhood reader (#77): Robinhood's agentic MCP exposed no option market data, whereas IBKR genuinely reads option details.
Verified option-detail support (the gate)
Live SNDK snapshot returned real data:
is_valid: true)get_price_snapshotreturns IV per option contract (implied_vol,option_midpoint_iv);get_price_historysupportsOPT/FOPbars.Read allowlist / write denylist
Reads:
get_account_summary·get_account_balances·get_account_positions·get_account_orders·get_account_trades·get_order_instructions·get_price_snapshot·get_price_history·search_contracts·get_company_themes·get_company_connections·get_theme_details·search_investment_topicsNever called (denylist):
create_order_instruction·delete_order_instruction·provide_customer_feedbackRead-only is self-imposed (the MCP is trade-capable, no server-side read-only mode); the skill enumerates the live tool list at runtime and treats unknown tools as forbidden. Matches the repo rule: no AI trade execution.
Honest limitations (documented in the skill)
search_contractsresolves the underlying only (no strikes/expiries/IDs). Per-contract option IDs come fromget_account_positions(held contracts).tradingview-reader/funda-data; IBKR covers the underlying IV regime, IV percentile, put/call skew, and per-contract IV of held options.Changes
plugins/data-providers/skills/ibkr-reader/—SKILL.md,README.md,references/tools.mdREADME.mdtable,plugins/data-providers/plugin.json(description + keywords),.claude-plugin/marketplace.jsonVerification
description970 chars (under the 1024 skill-lint cap), no angle bracketsmarketplace.json/plugin.jsonvalidate as JSON🤖 Generated with Claude Code