Each MCP tools/call invocation is bounded by a configurable deadline. Tools that exceed the
deadline return a structured JSON error instead of blocking the server indefinitely.
The MCP result has isError: true; HTTP /mcp returns status 200 (not 500) so the
client can inspect the structured error. Broker-level request timeouts (Robinhood 16 s,
Schwab 30 s) remain in effect independently and count toward this deadline.
Operational Circuit Breaker Defaults
Broker call protection is enabled by default and reports state in MCP health_check,
MCP rate_limit_status, HTTP /health, and HTTP /status.
Watchlist management - All 5 tools working (add/remove symbols tested with AMC)
User profile and settings
Investment preferences
Account features
Market Research
Earnings data and analysis
Stock ratings and news
Dividend information
Corporate actions and splits
Analytics & Monitoring
Portfolio analytics
Performance metrics
Server health monitoring
Interest and loan payments
Notifications
Account notifications
Margin calls and interest
Subscription management
Referral tracking
Advanced Instruments
Multi-symbol instrument lookup
Enhanced search capabilities
Level II market data (Gold required)
Direct instrument access
Trading Capabilities
Stock Orders (✅ Live Tested):
✅ Market orders - Buy/sell tested with XOM and AMC
✅ Limit orders - Buy/sell tested with XOM ($106) and AMC ($3)
✅ Stop-loss orders - Sell tested with AMC (25 shares at $2.50)
Individual and bulk order cancellation
❌ Deprecated: Trailing stop orders, fractional shares (uncommon use cases)
Options Orders (✅ Live Tested):
✅ Options limit orders (buy/sell) - API bugs fixed
✅ Options discovery and contract search
✅ Credit and debit spread strategies - API bugs fixed, ready for testing
Live validation: F $9 put sell order placed successfully
Order Management:
Cancel individual or all orders (stock and options)
View open positions
Order status tracking
Authentication
The server handles Robinhood's authentication requirements:
App-Push Approval: Automatic handling of app-based device approval (approve via Robinhood mobile app).
SMS/Email MFA Code: Set ROBINHOOD_MFA_CODE before login attempts to complete code-based verification (time-sensitive, typically 5-10 minutes).
Session Persistence: Cached and encrypted authentication to reduce re-verification.
Development
Testing
uv run pytest # All tests (works after uv sync)
uv run pytest -m "journey_account" # Fast account tests (~1.8s)
uv run pytest -m "journey_market_data" # Market data tests (~3.8s)
uv run pytest -m "not slow and not exception_test" # Recommended for development
uv run pytest -m rate_limited # Opt-in live API tests that may hit broker rate limits
RUN_RATE_LIMITED=1 uv run pytest # Include rate-limited tests in a full run
uv run pytest -m performance tests/performance -v # Mocked, CI-safe benchmarks
RUN_PERFORMANCE=1 uv run pytest # Include performance tests in a full run
# See CLAUDE.md for complete journey testing guide
Code Quality
ruff check . --fix # Lint and fix
ruff format . # Format code
mypy . # Type check
YAML Configuration
Open Stocks MCP can load configuration from open-stocks-mcp.yaml or config.yaml in the current working directory.
You can also set an explicit path with OPEN_STOCKS_CONFIG=/path/to/config.yaml or OPEN_STOCKS_CONFIG_FILE=/path/to/config.yaml (OPEN_STOCKS_MCP_CONFIG remains supported for backward compatibility).
Environment variables always win over YAML values, including:
Disclaimer: This software is for educational and development purposes. Trading stocks and options involves substantial risk. Always verify trades and understand the risks before executing any financial transactions.
O
Open Stocks
Open-Agent-Tools·11 estrelas·
MCP Server for stock market data - Robinhood, Schwab APIs with multi-broker support
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Open Stocks?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Open Stocks precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Open Stocks usa?
Open Stocks roda localmente via stdio.
Quando Open Stocks foi verificado pela última vez?
Última verificação: 2026-10-28. MCP Server for stock market data - Robinhood, Schwab APIs with multi-broker support