What is Rb Mcp

rb-mcp is a Model Context Protocol (MCP) server that provides Robinhood trading functionality to LLM clients like Claude Desktop.

Use cases

Use cases include automated trading systems, portfolio management tools, and applications that require real-time stock market data and trading functionalities.

How to use

To use rb-mcp, first authenticate with your Robinhood account. Then, you can access various tools for stock quotes, placing orders, and monitoring your portfolio through the provided API.

Key features

Key features include stock quote retrieval, market and limit order placement, portfolio monitoring, and tracking of open orders and trading history.

Where to use

rb-mcp is primarily used in financial technology applications, especially for trading and investment management, integrating with LLM clients for enhanced trading capabilities.

Robinhood MCP Server

A Model Context Protocol (MCP) server that provides Robinhood trading functionality to LLM clients like Claude Desktop.

Overview

This MCP server exposes Robinhood’s trading API as a set of tools and resources that can be used by Claude or other LLM clients. It allows you to:

• Check stock quotes and market data
• Place various types of stock orders (market, limit)
• Monitor your portfolio and positions
• Track open orders and trading history

Setup

Prerequisites

• Python 3.8+
• uv package manager (recommended for Claude Desktop integration)
• A Robinhood account

Installation

1. Clone this repository:

git clone https://github.com/syyunn/rb-mcp.git
cd rb-mcp

2. Install dependencies:

pip install fastmcp robin_stocks pydantic

3. Install the server in Claude Desktop:

fastmcp install server.py

Or run it in development mode:

fastmcp dev server.py

Usage

Authentication

Before using trading functionality, you must authenticate with Robinhood:

To use the Robinhood trading capabilities, please log in first.

[Call the login tool with your Robinhood credentials]

Tools

The server provides the following tools:

Authentication

• login - Authenticate with Robinhood
• logout - End your Robinhood session

Stock Information

• get_stock_quote - Get detailed quote for a stock
• get_latest_price - Get the current price of a stock

Trading Operations

• buy_stock_market_order - Place a market order to buy a stock
• sell_stock_market_order - Place a market order to sell a stock
• buy_stock_limit_order - Place a limit order to buy a stock
• sell_stock_limit_order - Place a limit order to sell a stock
• cancel_order - Cancel an open order

Portfolio Information

• get_portfolio - Get portfolio summary and account balance
• get_positions - View all current stock positions
• get_open_orders - View all open orders

Resources

The server also provides these resources:

• robinhood://stocks/{ticker}/info - Detailed stock information
• robinhood://portfolio/summary - Portfolio summary
• robinhood://account/history/{timespan} - Account history over specified time period

Example Conversations

Getting a Stock Quote

User: What's the current price of Apple stock?

Claude: Let me check the current price of Apple stock for you.

[Claude calls get_stock_quote with ticker="AAPL"]

The current price of Apple (AAPL) is $182.25.
Bid: $182.24
Ask: $182.26
Volume: 23,451,872

Placing a Buy Order

User: I'd like to buy 5 shares of Microsoft.

Claude: I can help you place an order for Microsoft stock.

[Claude calls get_latest_price with ticker="MSFT"]

Microsoft (MSFT) is currently trading at $417.82 per share.

Would you like to place a market order for 5 shares at the current price (approximately $2,089.10 total), or would you prefer to set a limit order at a specific price?

User: Let's do a market order.

Claude: I'll place a market order for 5 shares of Microsoft (MSFT).

[Claude calls buy_stock_market_order with ticker="MSFT", quantity=5]

Your market order has been placed successfully!
Order ID: 12345abc-6789-def0-1234-56789abcdef0
Status: queued

Security Notes

• This tool requires your Robinhood login credentials
• Credentials are not stored in the MCP server itself
• Authentication tokens are managed by the robin_stocks library in a local pickle file
• Always verify the content of any trades before confirming

License

This project uses the Apache 2.0 license.

Disclaimer

This tool is not affiliated with or endorsed by Robinhood. Use at your own risk. Trading stocks involves risk of financial loss.