MCP (Model Context Protocol) 서버는 여러 브로커 API를 통해 재고 시장 데이터 및 거래 기능을 제공합니다.

특징

** ♨ 현재 상태: v0.6.5 - 멀티 포커 지원 (Robinhood + Schwab)**

• ✅ ** MCP 도구 ** Robinhood + Schwab 건너 (현재 고장에 대한 도구 참조)
• ✅ ** 멀티 브레이커 아키텍처 ** - Robinhood 및 Charles Schwab에 대한 지원
• ✅ **완전 거래 기능 ** - 주식, 옵션, 주문 관리
• ✅ Live trading validated - 실제 주문으로 테스트 된 Robinhood Stock 및 옵션 거래
• ✅Production-ready - HTTP 수송, 도커 지원, 종합 테스트
• ✅ **Schwab 통합 완료 ** - OAuth 인증, 테스트 준비 도구 (도구 참조)
• ☸ Account details Fixed - N/A 값 대신 실제 금융 데이터

설치

개발:

빠른 시작

##1. Credentials 설정

.env] 파일을 만듭니다:

** Robinhood의 경우:**

** Schwab (선택 사항) : **

Note: Schwab은 개발자 계정과 API 승인(단일)을 요구합니다. Schwab Setup 가이드를 참조하십시오.

##2. 서버 시작

**HTTP 전송 (추천) **

** STDIO 운송 **

##3. 서버 테스트

Open Stocks MCP

An MCP (Model Context Protocol) server providing access to stock market data and trading capabilities through multiple broker APIs.

Features

🚀 Current Status: v0.6.5 - Multi-Broker Support (Robinhood + Schwab)

• ✅ MCP tools across Robinhood + Schwab (see Tool Reference for current breakdown)
• ✅ Multi-broker architecture - Support for Robinhood and Charles Schwab
• ✅ Complete trading functionality - stocks, options, order management
• ✅ Live trading validated - Robinhood stock and options trading tested with real orders
• ✅ Production-ready - HTTP transport, Docker support, comprehensive testing
• ✅ Schwab integration complete - OAuth authentication, tools ready for testing (see Tool Reference)
• 🔧 Account details fixed - Real financial data instead of N/A values

Installation

pip install open-stocks-mcp

For development:

git clone https://github.com/Open-Agent-Tools/open-stocks-mcp.git
cd open-stocks-mcp
uv sync   # installs all deps including dev group

Quick Start

1. Set Up Credentials

Create a .env file:

For Robinhood:

[email protected]
ROBINHOOD_PASSWORD=your_password

For Schwab (optional):

SCHWAB_API_KEY=your_api_key
SCHWAB_APP_SECRET=your_app_secret
SCHWAB_CALLBACK_URL=https://127.0.0.1:8182/
SCHWAB_TOKEN_PATH=~/.tokens/schwab_token.json

# Enable both brokers
ENABLED_BROKERS=robinhood,schwab

Note: Schwab requires a developer account and API approval (several days). See Schwab Setup Guide for full setup instructions.

2. Start the Server

HTTP Transport (Recommended)

open-stocks-mcp-server --transport http --port 3001

STDIO Transport

open-stocks-mcp-server --transport stdio

3. Test the Server

# Health check (HTTP transport)
curl http://localhost:3001/health

# Prometheus metrics (no auth required)
curl http://localhost:3001/metrics

# Interactive testing
uv run mcp dev src/open_stocks_mcp/server/app.py

The /metrics endpoint exposes:

• open_stocks_mcp_tool_calls_total (counter by tool)
• open_stocks_mcp_tool_avg_calls_per_minute (gauge by tool; average over the rolling window)
• open_stocks_mcp_tool_latency_ms (gauge by tool and quantile: 0.50, 0.95, 0.99)

Distributed tracing setup (OpenTelemetry, Jaeger, Tempo):

• docs/OPENTELEMETRY_TRACING.md

MCP Tool Execution Timeout

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.

• YAML key: timeout.tool_execution_timeout_seconds (default: 30)
• Environment override: OPEN_STOCKS_MCP_TOOL_EXECUTION_TIMEOUT_SECONDS (e.g., 60)

When a tool times out its response body is:

{
  "status": "error",