Robinhood

The Robinhood MCP Server allows your AI assistants and MCP clients to interact with the Robinhood Crypto API.

It handles authentication, account management, market data retrieval, and trading operations through both REST API and WebSocket interfaces.

Featuress

• 🔒 Secure authentication and account management
• 💹 Real-time market data via WebSocket
• 📊 REST API for trading operations and account info
• ⚡ WebSocket support for order updates
• 🛡️ Rate limiting and error handling
• 🔧 Easy configuration with environment variables

Use Cases

• Cryptocurrency trading bots can use this server to automate trading strategies on Robinhood
• Portfolio management applications can integrate with Robinhood to provide users with a unified view of their crypto holdings
• Market analysis tools can leverage the real-time data to provide insights and visualizations
• Personal finance apps can use the account management features to include Robinhood crypto balances in overall net worth calculations

How to Use It

1. Clone the repository:

 git clone https://github.com/rohitsingh-iitd/robinhood-mcp-server
 cd robinhood-mcp-server

2. Set up a virtual environment:

 python -m venv venv
 source venv/bin/activate  # On Windows: .\venv\Scripts\activate

3. Install dependencies:

 pip install -r requirements.txt

4. Create a .env file with your Robinhood API credentials:

 ROBINHOOD_API_KEY=your_api_key_here
 ROBINHOOD_PRIVATE_KEY=your_base64_encoded_private_key_here
  # Optional (with defaults)
  HOST=0.0.0.0
  PORT=8000
  WEBSOCKET_PORT=8001
  DEBUG=False
  LOG_LEVEL=INFO
  LOG_FILE=robinhood_mcp_server.log
  RATE_LIMIT_ENABLED=True
  RATE_LIMIT_REQUESTS=100
  RATE_LIMIT_PERIOD=60

5. Start the server:

 python -m src.main

The server will start the REST API on port 8000 and WebSocket on port 8001 by default.

Key API Endpoints:

• Authentication: GET /auth/status
• Account Info: GET /account
• Market Data: GET /market/best-price
• Trading: POST /trading/orders

WebSocket API:

• Connect to ws://localhost:8001
• Subscribe to market data: Send {"type": "market_data", "action": "subscribe", "symbols": ["BTC-USD"]}
• Subscribe to order updates: Send {"type": "orders", "action": "subscribe"}

FAQs

Q: How do I obtain Robinhood API credentials?
A: You’ll need to apply for API access through Robinhood’s developer program. Once approved, you’ll receive an API key and instructions to generate your private key.

Q: Can I use this server with a paper trading account?
A: Yes, you can use it with a paper trading account by using the appropriate API credentials for your paper trading environment.

Q: How can I handle rate limiting?
A: The server implements rate limiting by default. You can adjust the settings in the .env file using the RATE_LIMIT_* variables.

Q: Is this server suitable for high-frequency trading?
A: While it can handle real-time data and order placement, it’s not optimized for high-frequency trading. For HFT, you might need to implement additional optimizations.

Q: How can I secure my API credentials when deploying this server?
A: Always use environment variables or a secure secrets management system to store your API credentials. Never hard-code them or include them in version control.