← Coil home
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)

ToolWhat it doesGotcha
get_accountsList brokerage accounts with type and numberNever default an account from this — order tools require an explicit account number, and an agent should be locked to exactly one
get_portfolioPortfolio value + buying-power snapshotAccounts on cash-sweep programs can read $0 here; derive value from positions instead
get_equity_positionsOpen positions with quantity and average cost
get_equity_tax_lotsPer-lot cost basis for a position
get_pnl_trade_historyTrade-by-trade realized P&L feedThe broker's P&L feed is ground truth — internal ledgers drift from it
get_realized_pnlRealized gain/loss summary

Equity market data (8)

ToolWhat it doesGotcha
searchResolve a name/partial ticker to instruments
get_equity_quotesReal-time quotes, multiple symbols per call
get_equity_historicalsOHLCV candles per symbol/intervalCompleted 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_bookOrder-book depthNeeds the Level-2 entitlement (Gold)
get_equity_fundamentalsFundamentals snapshot
get_financialsFinancial statements
get_equity_technical_indicatorsServer-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_tradabilitySession + fractional eligibility per symbolThe 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)

ToolWhat it doesGotcha
get_indexesList supported indexes
get_index_quotesReal-time index levels
get_index_historicalsHistorical index levels

Earnings (2)

ToolWhat it doesGotcha
get_earnings_calendarUpcoming earnings dates
get_earnings_resultsReported results and surprises

Equity orders (4)

ToolWhat it doesGotcha
place_equity_orderPlace a stock/ETF order (shares or dollars)Fractional/dollar orders execute in regular hours only, whatever the symbol's overnight flags say
review_equity_orderValidate + preview an order without placingThe single most under-used safety tool: an agent can show its work and stop here for a human yes
get_equity_ordersList open/past equity orders
cancel_equity_orderCancel an open order

Options market data (6)

ToolWhat it doesGotcha
get_option_chainsExpirations and strikes for an underlying
get_option_instrumentsResolve specific contracts
get_option_quotesQuotes and greeks for contracts
get_option_historicalsHistorical contract prices
get_option_positionsOpen option positions
get_option_level_upgrade_infoAccount's option level + upgrade requirements

Option orders (6)

ToolWhat it doesGotcha
place_option_orderPlace an option orderGated by the account's approved option level
review_option_orderPreview an option order without placing
get_option_ordersList open/past option orders
cancel_option_orderCancel an open option order
exercise_optionExercise a held contract
cancel_option_exerciseCancel a pending exercise

Watchlists (12)

ToolWhat it doesGotcha
get_watchlistsList the account's watchlists
get_watchlist_itemsSymbols in a watchlist
create_watchlistCreate a watchlistWatchlists double as cheap agent↔human channels — an agent writes candidates, a human reviews on the phone
update_watchlistRename/update a watchlist
add_to_watchlistAdd equity symbols
remove_from_watchlistRemove equity symbols
follow_watchlistFollow a shared watchlist
unfollow_watchlistUnfollow one
get_popular_watchlistsRobinhood's curated lists
get_option_watchlistSaved option contracts
add_option_to_watchlistSave an option contract
remove_option_from_watchlistRemove a saved contract

Scans — server-side screeners (6)

ToolWhat it doesGotcha
get_scanner_filter_specsSupported filter fields and operatorsRead this first — anything outside it gets silently dropped
create_scanCreate a saved screen
get_scansList saved scans
run_scanExecute a scanAlways read filters_applied back — a dropped filter silently widens results
update_scan_configUpdate name/sort/limit
update_scan_filtersReplace 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.

The strategy layer is the hard part

These tools give an agent hands. What to buy, when to enter, and when to stand aside is the actual problem — Coil scores every S&P 500 and Nasdaq-100 name daily and publishes the proof.

See the Scanner — $12/mo

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.