REFERENCE
Robinhood MCP tools: the complete reference
All 53 tools on the Robinhood MCP surface, categorized — with the behavioral gotchas we measured running an agent against it daily, and a machine-readable JSON your agent can load directly.
Reference · 9 min read · observed August 6, 2026
What this is (and isn't)
Robinhood's MCP server is what lets an AI agent — Claude, most commonly — read and act on a brokerage account with plain tool calls. There is no official public reference for the tool surface, so we wrote the one we wished existed: every tool we observe on the live connector, categorized, with a one-line purpose and, where we've measured one, the gotcha. It is independently observed, not official; Robinhood changes the surface without notice. Setup itself is covered in our Robinhood agentic setup guide, and the error-by-error debugging table lives in the troubleshooting guide.
The count as of August 6, 2026: 53 tools in nine categories. Read tools dominate — 39 of 53 never mutate anything. The 14 that do (orders, watchlist edits, scan edits) are where your guardrails live.
Account & portfolio (6)
| Tool | What it does | Gotcha |
get_accounts | List brokerage accounts with type and number | Never default an account from this — order tools require an explicit account number, and an agent should be locked to exactly one |
get_portfolio | Portfolio value + buying-power snapshot | Accounts on cash-sweep programs can read $0 here; derive value from positions instead |
get_equity_positions | Open positions with quantity and average cost | |
get_equity_tax_lots | Per-lot cost basis for a position | |
get_pnl_trade_history | Trade-by-trade realized P&L feed | The broker's P&L feed is ground truth — internal ledgers drift from it |
get_realized_pnl | Realized gain/loss summary | |
Equity market data (8)
| Tool | What it does | Gotcha |
search | Resolve a name/partial ticker to instruments | |
get_equity_quotes | Real-time quotes, multiple symbols per call | |
get_equity_historicals | OHLCV candles per symbol/interval | Completed bars only. We measured the 5-minute feed ~5 bars behind real time (28% of 25-min momentum reads flipped sign vs the tape) and hourly final-bar closes up to ~3.4% off SIP — rebuild the forming hour from 5m bars |
get_equity_price_book | Order-book depth | Needs the Level-2 entitlement (Gold) |
get_equity_fundamentals | Fundamentals snapshot | |
get_financials | Financial statements | |
get_equity_technical_indicators | Server-computed MAs, MACD, RSI etc. | Completed bars only, one symbol per call, server-side warmup — bulk scanning belongs on a data API, not here |
get_equity_tradability | Session + fractional eligibility per symbol | The pre-flight check before any order; flags like closing-only fractional exist nowhere else — see our probed leveraged-ETF list for how much they vary |
Indexes (3)
| Tool | What it does | Gotcha |
get_indexes | List supported indexes | |
get_index_quotes | Real-time index levels | |
get_index_historicals | Historical index levels | |
Earnings (2)
| Tool | What it does | Gotcha |
get_earnings_calendar | Upcoming earnings dates | |
get_earnings_results | Reported results and surprises | |
Equity orders (4)
| Tool | What it does | Gotcha |
place_equity_order | Place a stock/ETF order (shares or dollars) | Fractional/dollar orders execute in regular hours only, whatever the symbol's overnight flags say |
review_equity_order | Validate + preview an order without placing | The single most under-used safety tool: an agent can show its work and stop here for a human yes |
get_equity_orders | List open/past equity orders | |
cancel_equity_order | Cancel an open order | |
Options market data (6)
| Tool | What it does | Gotcha |
get_option_chains | Expirations and strikes for an underlying | |
get_option_instruments | Resolve specific contracts | |
get_option_quotes | Quotes and greeks for contracts | |
get_option_historicals | Historical contract prices | |
get_option_positions | Open option positions | |
get_option_level_upgrade_info | Account's option level + upgrade requirements | |
Option orders (6)
| Tool | What it does | Gotcha |
place_option_order | Place an option order | Gated by the account's approved option level |
review_option_order | Preview an option order without placing | |
get_option_orders | List open/past option orders | |
cancel_option_order | Cancel an open option order | |
exercise_option | Exercise a held contract | |
cancel_option_exercise | Cancel a pending exercise | |
Watchlists (12)
| Tool | What it does | Gotcha |
get_watchlists | List the account's watchlists | |
get_watchlist_items | Symbols in a watchlist | |
create_watchlist | Create a watchlist | Watchlists double as cheap agent↔human channels — an agent writes candidates, a human reviews on the phone |
update_watchlist | Rename/update a watchlist | |
add_to_watchlist | Add equity symbols | |
remove_from_watchlist | Remove equity symbols | |
follow_watchlist | Follow a shared watchlist | |
unfollow_watchlist | Unfollow one | |
get_popular_watchlists | Robinhood's curated lists | |
get_option_watchlist | Saved option contracts | |
add_option_to_watchlist | Save an option contract | |
remove_option_from_watchlist | Remove a saved contract | |
Scans — server-side screeners (6)
| Tool | What it does | Gotcha |
get_scanner_filter_specs | Supported filter fields and operators | Read this first — anything outside it gets silently dropped |
create_scan | Create a saved screen | |
get_scans | List saved scans | |
run_scan | Execute a scan | Always read filters_applied back — a dropped filter silently widens results |
update_scan_config | Update name/sort/limit | |
update_scan_filters | Replace the filter set | |
The five gotchas that actually bite
- Burst = 429. Parallel tool calls draw throttles. Pace sequentially, back off on 429, batch symbols where a tool accepts lists.
- Dropped filters are silent. The scanner ignores unsupported params without erroring.
filters_applied is the only truth.
- The 5-minute feed lags. ~5 bars behind in our measurement — momentum reads on the freshest bars flip sign 28% of the time vs the consolidated tape. Rebuild the forming hour from 5m; treat the newest bar as provisional.
- Tradability is per-symbol and weird. Closing-only fractional flags and overnight-session exclusions vary fund by fund — pre-flight every order with
get_equity_tradability.
- Review before place, always. The review tools exist so an agent can show its work. Wire your guardrails so the placing tools are unreachable without a reviewed order — the template is in our agent guardrails file.
Agent builders: the whole reference is downloadable as robinhood-mcp-tools.json (CC-BY) — load it into your agent's context instead of letting it guess tool semantics.
Independently observed from live use on a standard individual account enabled for agentic trading; not an official Robinhood document, and not affiliated with Robinhood. Tool names, counts and behavior change without notice. Nothing here is investment advice.
Coil is software you install and run yourself, with your own brokerage credentials and capital. It is long-only and not investment advice, not a managed account, and not a signal service. Not affiliated with Robinhood.