Robinhood for Agents

Community

Robinhood integration for AI agents — 50 MCP tools + TypeScript client library.

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #327 of 438
Stars: ★ 67 Popular
Transport: stdio (local process)
Runtime: Bun 1.3+ · Docker · Node.js
Credentials: API key / credential required
License: MIT
Last commit: 13 days ago
Tools: 50

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.

Strongest · Documentation 12/20 Weakest · Reliability 6/20

Reliability

6/20

Security and permissions

7/20

Maintenance

7/20

Documentation

12/20

Setup experience

11/20

Why each score

Reliability 6/20: Only the README and repo metadata were supplied; no source code, server manifest, CI workflow, or tests could be reviewed. The README claims 50 MCP tools, self-renewing sessions, order simulation, and so on, but those claims are untrusted and the MCP init/tool-list handshake cannot be verified against real behavior. Dependencies on Bun, Chrome, and an unofficial Robinhood API make edge cases hard to control from the evidence available. The calibration rule says reliability cannot be high without verifiable execution evidence, so significant deductions apply.
Security and permissions 7/20: The README describes a strong intended security posture: OS keychain by default, AES-256-GCM encrypted file storage, passive OAuth token interception, blocked bank transfers and bulk cancel, explicit order parameters, explicit sell_short for opening shorts, a review→confirm→place workflow, and a threat-model doc. However, the source is not inspectable, so these controls cannot be confirmed. The MCP surface includes direct order-placement tools; confirmation appears to rely on skill/client workflow rather than server-enforced checks. Handling real brokerage credentials and browser login is high-risk. No clear red line (malware, credential theft, covert exfiltration, real secrets in examples, or unconfirmed irreversible payment default) is visible in the supplied material, but the inability to verify implementation prevents a high score.
Maintenance 7/20: Repo metadata shows an MIT license, not archived, and 4 open issues; the README references CI, npm version, and ClawHub badges. These suggest ongoing development but do not provide verifiable commit history, releases, issue-response behavior, dependency updates, or a security-response channel. Stars are discovery signals only and are not scored. The score therefore stays in the low-mid range.
Documentation 12/20: The README is strong: quick start, manual config examples for multiple clients, a 50-tool table, order flow, authentication and session lifetime, Docker/headless deployment, security warnings, architecture links, development/integration-test commands, and a disclaimer. It also discloses real limitations such as the single-writer token store, Chrome-only login, and the encrypted file not protecting against a malicious agent. Deductions apply for missing per-tool parameter/limit details, rate-limit or cost documentation, thin troubleshooting beyond session status, and referenced docs that were not provided for verification.
Setup experience 11/20: The README gives clear setup steps: Bun 1.3+ and Chrome prerequisites, npx/onboard guided setup, config examples for Claude Code, Codex, OpenClaw, and other MCP clients, plus a Docker/headless path with encrypted token files. As documentation this is quite usable, but there is no verifiable execution evidence that the bunx entrypoint, onboard flow, or client registration actually works. The hard Chrome dependency with no fallback and partial platform-compatibility documentation also add fragility. Under static calibration, setup cannot exceed 15 without verifiable evidence, so 11 is awarded.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account dataControls a browser

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.

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.

Setup

Before you start

Runtime：Bun 1.3+ · Docker · Node.js

ROBINHOOD_TOKEN_KEY optionalsecret Base64 key used to decrypt ROBINHOOD_TOKENS_FILE, printed by the onboard flow.

ROBINHOOD_ACCESS_TOKEN optionalsecret Pass a Robinhood access token directly (serverless/testing; no refresh supported).

Other optional settings (1)

ROBINHOOD_TOKENS_FILE optional Path to the encrypted token file (e.g. ./tokens.enc) for Docker/headless setups, exported by the onboard flow.

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"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "robinhood-for-agents": {
      "command": "bunx",
      "args": [
        "robinhood-for-agents"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add robinhood-for-agents -- bunx robinhood-for-agents

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After registering the server and restarting the client, confirm robinhood_check_session and robinhood_get_portfolio appear in the tool list; calling robinhood_check_session should return a status like logged_in or not_authenticated, proving the connection works.

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`.

Things to try

Once connected, you can ask your AI assistant things like:

Show my Robinhood portfolio and holdings
Search AAPL quotes and fundamentals
Show the SPX options chain expiring tomorrow with greeks
Simulate a market order to buy 10 shares of AAPL with robinhood_review_equity_order

Tools 50

robinhood_browser_login writes

Authenticate via Chrome browser login.

robinhood_check_session read-only

Probe the cached session: logged_in / expired / unknown / not_authenticated.

robinhood_get_portfolio read-only

Get portfolio: positions, P&L, equity, cash, buying power.

robinhood_get_equity_positions read-only

Get raw equity positions (shares, avg price).

robinhood_get_equity_tax_lots read-only

Get tax lots for a stock holding (cost basis, term, open date).

robinhood_get_accounts read-only

List all brokerage accounts.

robinhood_get_account read-only

Get account details and profile.

robinhood_get_stock_quote read-only

Get stock quotes and fundamentals.

Show 42 more tools

robinhood_get_fundamentals read-only

Get fundamentals: float, shares outstanding, valuation, profile.

robinhood_get_short_interest read-only

Get daily short-interest estimate (% of float, with bounds).

robinhood_get_historicals read-only

Get OHLCV price history.

robinhood_get_equity_price_book read-only

Get Level-2 price book (bid/ask depth).

robinhood_get_equity_tradability read-only

Get tradability flags (fractional, short-selling, per-account).

robinhood_get_earnings_results read-only

Get earnings for a symbol (EPS estimate vs. actual).

robinhood_get_earnings_calendar read-only

Get market-wide earnings calendar for a day window.

robinhood_get_news read-only

Get news, analyst ratings, earnings.

robinhood_get_movers read-only

Get market movers and popular stocks.

robinhood_get_market_hours read-only

Get market hours for a date: is it a trading day, when each session opens/closes.

robinhood_get_indexes read-only

Get tradable market indexes (SPX, NDX, VIX, …).

robinhood_get_index_quotes read-only

Get current values for index symbols.

robinhood_get_options read-only

Get options chain with greeks.

robinhood_get_option_positions read-only

Get open option positions (per-leg or by strategy).

robinhood_get_option_orders read-only

Get option order history.

robinhood_get_option_historicals read-only

Get historical OHLC for a specific option contract.

robinhood_get_crypto read-only

Get crypto positions and quotes.

robinhood_review_equity_order read-only

Simulate a stock order before placing (price-collar check, live quote).

robinhood_review_option_order read-only

Simulate an option order before placing (per-leg data, collateral).

robinhood_place_stock_order writes

Place stock orders (market/limit/stop/trailing, incl. sell_short).

robinhood_place_option_order writes

Place option orders.

robinhood_place_crypto_order writes

Place crypto orders.

robinhood_get_orders read-only

View order history.

robinhood_cancel_order writes

Cancel an order by ID.

robinhood_get_order_status read-only

Get status of a specific order by ID.

robinhood_search read-only

Search stocks or browse categories.

robinhood_get_watchlists read-only

List your own watchlists (with list ids).

robinhood_get_watchlist_items read-only

Items of a watchlist (enriched with symbols).

robinhood_get_popular_watchlists read-only

Robinhood-curated lists to follow.

robinhood_get_option_watchlist read-only

Your options watchlist — single-leg option contracts.

robinhood_create_watchlist writes

Create a new watchlist (confirm first).

robinhood_update_watchlist writes

Rename / re-describe a watchlist (confirm first).

robinhood_add_to_watchlist writes

Add symbols / indexes / crypto to a list (confirm first).

robinhood_remove_from_watchlist writes

Remove items from a list (confirm first).

robinhood_follow_watchlist writes

Follow a Robinhood-curated list (confirm first).

robinhood_unfollow_watchlist writes

Unfollow a curated list (confirm first).

robinhood_add_option_to_watchlist writes

Add long single-leg option contracts to the options watchlist (confirm first).

robinhood_remove_option_from_watchlist writes

Remove single-leg option contracts from the options watchlist (confirm first).

robinhood_get_scans read-only

List your saved scanners (screeners).

robinhood_get_scanner_filter_specs read-only

Filter vocabulary for building scans (RSI/MACD/fundamentals/…).

robinhood_get_realized_pnl read-only

Realized P&L over a window, bucketed (computed FIFO; equity + crypto).

robinhood_get_pnl_trade_history read-only

Per-trade realized P&L (computed FIFO; equity + crypto).

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 Desktop

Claude Code

Codex

OpenClawPartial support

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 410 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.5k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision 3cdb50455629 Data synced 2026-10-12 Read the FMRS scoring method