How kevin1chun/robinhood-for-agents works
robinhood-for-agents is an MCP server and TypeScript client for Robinhood research and trading. An agent connects over MCP; standard mode forwards calls to Robinhood’s hosted Trading MCP, while web mode registers local tools backed by the web API. Web-mode login establishes a reusable session, then tools cover portfolio, research, orders, options, and account utilities. The client owns HTTP requests and session handling; review calculations also have a pure compute layer. README capabilities are represented, though unsampled tool implementations are shown only at their documented subsystem boundaries.
Main entry points: client.ts Robinhood client · server.ts MCP server · browser-auth.ts Browser login · forward.ts Official forwarding
Components 25
Agent interface
- MCP server
src/server/server.ts - Stdio transport
src/server/index.ts - Official forwarding
src/server/official/forward.ts
Authentication
- Official credentials
src/server/official/auth.ts - Browser login
src/server/browser-auth.ts - Session tools
src/server/tools/auth.ts
Web tools
- Portfolio tools
src/server/tools/portfolio.ts - Stock tools
src/server/tools/stocks.ts - Market tools
src/server/tools/markets.ts - Options tools
src/server/tools/options.ts - Crypto tools
src/server/tools/crypto.ts - Order tools
src/server/tools/orders.ts - Watchlist tools
src/server/tools/watchlists.ts - Scanner tools
src/server/tools/scanners.ts - P&L tools
src/server/tools/pnl.ts - Tax lot tools
src/server/tools/tax-lots.ts - Order review
src/server/tools/review.ts
Client runtime
- Robinhood client
src/client/client.ts - Session and auth
src/client/auth.ts - Token stores
src/client/token-store.ts - HTTP layer
src/client/http.ts
Analysis
- Trading analytics
src/compute
Other components
- AI agent
- Robinhood services
- User browser
Connections 40
- AI agent → Stdio transport: uses MCP
- Stdio transport → MCP server: creates server
- MCP server → Official forwarding: registers standard tools
- MCP server → Session tools: registers web tools
- MCP server → Portfolio tools: registers web tools
- MCP server → Stock tools: registers web tools
- MCP server → Market tools: registers web tools
- MCP server → Options tools: registers web tools
- MCP server → Crypto tools: registers web tools
- MCP server → Order tools: registers web tools
- MCP server → Watchlist tools: registers web tools
- MCP server → Scanner tools: registers web tools
- MCP server → P&L tools: registers web tools
- MCP server → Tax lot tools: registers web tools
- MCP server → Order review: registers web tools
- AI agent → User browser: approves login
- Session tools → Browser login: starts login
- Browser login → User browser: opens Chrome
- Browser login → Token stores: saves tokens
- Browser login → Robinhood client: restores session
- Robinhood client → Session and auth: manages session
- Session and auth → Token stores: loads and saves
- Robinhood client → HTTP layer: sends requests
- HTTP layer → Robinhood services: calls web API
- Official forwarding → Official credentials: loads credentials
- Official forwarding → Robinhood services: relays MCP calls
- Session tools → Robinhood client: checks session
- Portfolio tools → Robinhood client: calls client
- Stock tools → Robinhood client: calls client
- Market tools → Robinhood client: calls client
- Options tools → Robinhood client: calls client
- Crypto tools → Robinhood client: calls client
- Order tools → Robinhood client: calls client
- Watchlist tools → Robinhood client: calls client
- Scanner tools → Robinhood client: calls client
- P&L tools → Robinhood client: calls client
- Tax lot tools → Robinhood client: calls client
- Order review → Robinhood client: requests order data
- Order review → Trading analytics: evaluates price collar
- Robinhood client → Robinhood services: uses REST API