Best for
- Developers comfortable with Robinhood and programming.
- Users needing to enable AI agents to execute trading actions.
- Users wanting to integrate Robinhood data into AI workflows.
R
Robinhood for Agents
Community
Robinhood integration for AI agents — 50 MCP tools + TypeScript client library.
GitHub source repository ↗
43FMRS · D
This server provides a comprehensive MCP integration for Robinhood with rich features and safety controls, but it is unofficial and should be used with caution. Suitable for users who are aware of the risks.
robinhood-for-agents is an MCP server that provides 50 tools for AI agents to interact with your Robinhood brokerage account, covering portfolio viewing, research, stock/option/crypto trading, watchlist management, and more. It also includes a TypeScript client library (70+ async methods) and a unified trading skill for guided workflows. It supports Claude Code, Codex, OpenClaw, and other MCP clients. Authentication via Chrome browser login, token storage secure (OS keychain or encrypted file). Order flow requires review -> confirm -> place, and includes safety restrictions like blocking fund transfers and bulk cancellations.
Tools
robinhood_browser_login
Authenticate via Chrome browser login.
robinhood_check_session
Probe the cached session: logged_in / expired / unknown / not_authenticated.
robinhood_get_portfolio
Get portfolio: positions, P&L, equity, cash, buying power.
robinhood_get_equity_positions
Get raw equity positions (shares, avg price).
robinhood_get_equity_tax_lots
Get tax lots for a stock holding (cost basis, term, open date).
robinhood_get_accounts
List all brokerage accounts.
robinhood_get_account
Get account details and profile.
robinhood_get_stock_quote
Get stock quotes and fundamentals.
robinhood_get_fundamentals
Get fundamentals: float, shares outstanding, valuation, profile.
robinhood_get_short_interest
Get daily short-interest estimate (% of float, with bounds).
robinhood_get_historicals
Get OHLCV price history.
robinhood_get_equity_price_book
Get Level-2 price book (bid/ask depth).
robinhood_get_equity_tradability
Get tradability flags (fractional, short-selling, per-account).
robinhood_get_earnings_results
Get earnings for a symbol (EPS estimate vs. actual).
robinhood_get_earnings_calendar
Get market-wide earnings calendar for a day window.
robinhood_get_news
Get news, analyst ratings, earnings.
robinhood_get_movers
Get market movers and popular stocks.
robinhood_get_market_hours
Get market hours for a date: is it a trading day, when each session opens/closes.
robinhood_get_indexes
Get tradable market indexes (SPX, NDX, VIX, …).
robinhood_get_index_quotes
Get current values for index symbols.
robinhood_get_options
Get options chain with greeks.
robinhood_get_option_positions
Get open option positions (per-leg or by strategy).
robinhood_get_option_orders
Get option order history.
robinhood_get_option_historicals
Get historical OHLC for a specific option contract.
robinhood_get_crypto
Get crypto positions and quotes.
robinhood_review_equity_order
Simulate a stock order before placing (price-collar check, live quote).
robinhood_review_option_order
Simulate an option order before placing (per-leg data, collateral).
robinhood_place_stock_order
Place stock orders (market/limit/stop/trailing, incl. sell_short).
robinhood_place_option_order
Place option orders.
robinhood_place_crypto_order
Place crypto orders.
robinhood_get_orders
View order history.
robinhood_cancel_order
Cancel an order by ID.
robinhood_get_order_status
Get status of a specific order by ID.
robinhood_search
Search stocks or browse categories.
robinhood_get_watchlists
List your own watchlists (with list ids).
robinhood_get_watchlist_items
Items of a watchlist (enriched with symbols).
robinhood_get_popular_watchlists
Robinhood-curated lists to follow.
robinhood_get_option_watchlist
Your options watchlist — single-leg option contracts.
robinhood_create_watchlist
Create a new watchlist (confirm first).
robinhood_update_watchlist
Rename / re-describe a watchlist (confirm first).
robinhood_add_to_watchlist
Add symbols / indexes / crypto to a list (confirm first).
robinhood_remove_from_watchlist
Remove items from a list (confirm first).
robinhood_follow_watchlist
Follow a Robinhood-curated list (confirm first).
robinhood_unfollow_watchlist
Unfollow a curated list (confirm first).
robinhood_add_option_to_watchlist
Add long single-leg option contracts to the options watchlist (confirm first).
robinhood_remove_option_from_watchlist
Remove single-leg option contracts from the options watchlist (confirm first).
robinhood_get_scans
List your saved scanners (screeners).
robinhood_get_scanner_filter_specs
Filter vocabulary for building scans (RSI/MACD/fundamentals/…).
robinhood_get_realized_pnl
Realized P&L over a window, bucketed (computed FIFO; equity + crypto).
robinhood_get_pnl_trade_history
Per-trade realized P&L (computed FIFO; equity + crypto).
Setup
Recommended guided setup: run npx robinhood-for-agents onboard and follow the prompts (it detects your agent, registers the MCP server, installs skills, and guides login). Alternatively, manual config: For Claude Code, run claude mcp add -s user robinhood-for-agents -- bunx robinhood-for-agents. For Codex, run codex mcp add robinhood-for-agents -- bunx robinhood-for-agents. For OpenClaw, use clawhub install robinhood-for-agents. For other MCP clients, add a config entry like {"mcpServers":{"robinhood-for-agents":{"command":"bunx","args":["robinhood-for-agents"]}}}. Requires Bun v1.3+ and Google Chrome.
claude_desktop_config.json
{
"mcpServers": {
"robinhood-for-agents": {
"command": "bunx",
"args": [
"robinhood-for-agents"
]
}
}
}
Fit and risk
Not for
- Users unfamiliar with Robinhood or without a Robinhood account.
- Users seeking an officially supported Robinhood API.
- Users who cannot accept the risks of AI-driven trading.
- Users preferring a login method other than browser-based.
Required permissions
- Read and modify Robinhood account data (positions, orders, watchlists, etc.).
- Perform login via Chrome browser and capture OAuth tokens (passive).
- Access OS keychain or encrypted file for token storage.
- Make network requests to Robinhood's public interfaces.
Risks and side effects
- AI may misinterpret intent and place unintended orders, causing financial loss.
- Market data may be stale or inaccurate.
- Software bugs or unexpected behavior could lead to erroneous trades.
- Token storage risk: encrypted files can be decrypted by malicious agents with shell access in containers.
- Session refresh failures may leave the container unable to re-authenticate after restart.
- This is an unofficial tool; use at your own risk.
Troubleshooting
- Login issues: Ensure Google Chrome is installed and is the standard version.
- Session unknown: Run `robinhood_check_session` to check status.
- Token storage errors: Check `ROBINHOOD_TOKENS_FILE` and `ROBINHOOD_TOKEN_KEY` environment variables.
- Orders not executing: Check that the correct trading session (`market_hours`) is specified; it is required.
- Token file write failures: Ensure the mounted volume is writable.
- Integration tests failing: Confirm you have logged in via `npx robinhood-for-agents onboard`.
Use cases
AI agents querying portfolio and researching stocks.
Assisted order placement, always with user confirmation.
Automated trading strategies with careful oversight.
Tracking market news and earnings calendars.
Supported clients
Claude DesktopFull support
Claude CodeFull support
CodexFull support
OpenClawPartial support