convez.ai
MCP ServerIntegração & APIsAvançado
seferino-fernandez

rhood-rs - Cliente Robinhood em Rust

seferino-fernandez/rhood-rs

Cliente Robinhood em Rust com MCP server para trading via LLM

Ver no GitHub
BomPluginScore · de 0 a 100

Biblioteca cliente assíncrona, CLI e servidor MCP para a API do Robinhood, permitindo integração com LLMs como Claude. Oferece acesso a operações de trading (ações, opções, futuros), gerenciamento de portfólio e dados de mercado via interface de linha de comando ou MCP tools.

Instalação

$npx convez-ai seferino-fernandez/rhood-rs

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
1
Acompanhando
0
Saúde
71%
Último commit
há 4 semanas
Versão
v0.3.1
Issues abertas
1
Contribuidores
2

Casos de uso

  • Automatizar consultas de cotações e histórico de ações via CLI
  • Integrar operações de trading com Claude/LLMs através de MCP tools
  • Gerenciar portfólio e consultar dados de conta programaticamente
  • Construir bots de trading LLM-driven com confirmação de ordens

Veredito

Ferramenta robusta e bem-estruturada para integração com Robinhood via Rust. O servidor MCP oferece caminho direto para LLMs executarem operações financeiras com segurança (two-step confirmation). Comunidade menor e projeto não-oficial, exige atenção a risco operacional em produção.

README

A tradução para o português deste README ainda está na fila.

rhood-rs

Rust client library, CLI, and MCP server for the Robinhood API.

Disclaimer: This is an unofficial, community-driven project and is not affiliated with, endorsed by, or supported by Robinhood Markets, Inc. Use at your own risk.

Inspired by robin_stocks, the excellent Python library for Robinhood.

Crates

CrateDescription
rhood-coreAsync Robinhood API client library
rhood-cliTerminal CLI (rhood) for trading
rhood-mcpMCP server for LLM-driven trading

Installation

Homebrew (macOS & Linux)

brew tap seferino-fernandez/tools
brew install rhood
brew install rhood-mcp

Cargo (build from source)

cargo install rhood-cli
cargo install rhood-mcp

cargo-binstall (prebuilt binaries, no compile)

cargo binstall rhood-cli
cargo binstall rhood-mcp

Quick Start

# Build
cargo build --release

# Login interactively
rhood login

# Stock quotes
rhood stock quote AAPL TSLA

# Historical data
rhood stock history AAPL --span year --interval day

# Portfolio
rhood account portfolio

# Place an order (orders require --read-write; you'll be prompted to confirm)
rhood --read-write order buy AAPL --quantity 10 --type market

# Output as JSON
rhood --output json stock quote AAPL

CLI

rhood-cli is a terminal interface to the Robinhood API. See the rhood-cli README for the full reference (commands, flags, output formats, config).

MCP Server

rhood-mcp exposes Robinhood operations as MCP tools for LLM clients. See the rhood-mcp README for the full reference (auth modes, OAuth, CLI flags, env vars).

Setup

The fastest path is the stdio transport with Claude Code:

claude mcp add rhood --transport stdio -- rhood-mcp --transport stdio

For other clients (Claude Desktop, Cursor, shared .mcp.json), HTTP transport, OAuth setup, environment variables, and the full CLI reference, see crates/rhood-mcp/.

Available Tools

Tools are grouped by domain: Stocks, Options, Futures, Indices, Account, Income (dividends, interest, transfers), Research, Recurring investments, Watchlists, User, Market, Orders.

A few representative tools:

ToolWhat it does
get_stock_quotesCurrent quotes for stock tickers
get_portfolioPortfolio summary (equity, cash, etc.)
place_stock_orderStage a stock order for confirmation
confirm_orderSubmit a previously staged order
cancel_orderCancel an open stock order

For the live tool list, call MCP tools/list against the running server. Order placement is two-step: stage with place_*, then submit with confirm_order. Read-only mode (default) hides write tools.

Testing

cargo test                    # All unit tests
cargo test -p rhood-core      # Core library only

or:

just test

License

MIT

Ver o original no GitHub

Bom para

Relacionados