Skip to main content
Glama
deenesjakoruzh
k1xme

schwab-mcp

by k1xme
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

schwab-mcp

Un servidor MCP que se conecta a la API de corretaje de Charles Schwab, además de un plugin para Claude Code con habilidades que ahorran viajes de ida y vuelta al LLM al llamar a las herramientas MCP.

Qué hace esto

Servidor MCP — Envuelve la API de Schwab a través de schwabdev y expone 18 herramientas a través de HTTP transmitible:

Categoría

Herramientas

Sesión

list_accounts, set_active_account, get_active_account

Datos de mercado

get_quotes, get_option_chain, get_option_expirations, get_price_history, get_movers, get_market_hours

Cuentas

get_account, get_transactions, get_transaction, get_preferences

Órdenes

list_orders, list_all_orders, get_order, place_order, cancel_order, replace_order, preview_order

Instrumentos

search_instruments, get_instrument

Plugin para Claude Code — Incluye seis habilidades (schwab:account, schwab:orders, schwab:quotes, schwab:market, schwab:instruments, schwab:chart-orders) que proporcionan a Claude las reglas de selección de herramientas, formatos de parámetros y patrones de seguridad por adelantado. Esto elimina el ir y venir que el LLM necesitaría de otro modo para averiguar qué herramienta llamar y cómo llamarla.

Related MCP server: KiteMCP

Requisitos previos

  • Python 3.11+

  • Una cuenta de Schwab Developer con una aplicación aprobada (necesitas la clave y el secreto de la aplicación)

Configuración

# Clone and install
git clone <repo-url> && cd schwab-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Add credentials
cp .env.example ~/.schwab-mcp/.env
# Edit ~/.schwab-mcp/.env with your Schwab app key and secret

# Authenticate (opens browser for OAuth)
schwab-mcp auth

# Start the server
schwab-mcp serve

El servidor escucha en http://127.0.0.1:8099/mcp por defecto. Puedes sobrescribirlo con las variables de entorno SCHWAB_MCP_HOST y SCHWAB_MCP_PORT.

Uso con Claude Code

Instala el directorio del plugin para que Claude Code detecte la conexión MCP y las habilidades:

claude plugin add ./plugin

Esto registra:

  • La conexión del servidor MCP (a través de plugin/.mcp.json)

  • Seis habilidades que guían a Claude sobre cómo usar cada categoría de herramienta

  • Un gancho de fin de sesión que limpia los archivos temporales

Una vez instalado, pregúntale a Claude cosas como:

  • "¿Cuáles son mis posiciones de cuenta?"

  • "Dame una cotización para AAPL"

  • "Coloca una orden limitada para comprar 10 acciones de MSFT a $400"

  • "Muéstrame los principales movimientos de hoy en el S&P 500"

  • "Grafica mis órdenes ejecutadas para SPX hoy"

Ejemplo: Colocar una orden limitada

You: Buy 100 shares of SPY with limit order at current median bid-ask spread.
     This order should be canceled if it weren't filled before 3/30 12PM ET.

Claude: I need to get SPY's current bid-ask spread first, then build the order.
        Let me fetch the quote.

        [calls get_quotes for SPY]

        Got the quote. Here's the current SPY pricing:
        - Bid: $632.70
        - Ask: $633.00
        - Midpoint: $632.85

        Regarding cancellation by 3/30 12PM ET — Schwab doesn't support
        "cancel at a specific time." I'll use DAY duration (valid through
        market close on 3/30). You'd need to manually cancel at noon if
        unfilled.

        [calls place_order with confirmed=False — dry run]

        | Field      | Value                      |
        |------------|----------------------------|
        | Action     | BUY                        |
        | Symbol     | SPY                        |
        | Quantity   | 100 shares                 |
        | Order Type | LIMIT                      |
        | Price      | $632.85 (bid-ask midpoint) |
        | Duration   | DAY                        |
        | Session    | NORMAL                     |

        Shall I submit this order?

You: yes

Claude: [calls place_order with confirmed=True]

        Order submitted successfully.

La habilidad guió a Claude para:

  1. Obtener la cotización para calcular el precio medio

  2. Realizar una prueba de la orden primero (confirmed=False) y mostrar el resumen

  3. Solo enviar (confirmed=True) después de la aprobación explícita del usuario

Ejemplo: Graficar órdenes ejecutadas

You: Plot my last week's credit spread trades

Claude: [fetches filled orders for Mar 22-28]

        39 credit spread orders on SPXW last week — 30 vertical spreads
        and 9 iron condors across 5 trading days.

        [fetches 15-minute SPX candles for the same range]
        [runs chart_orders.py with candles + orders data]

        Candles: 130, Orders: 62 (12 buy, 11 sell, 39 spread)
        Interactive chart saved to plugin/skills/chart-orders/chart.html

Ejemplo de gráfico de órdenes

La habilidad guió a Claude para:

  1. Obtener las órdenes ejecutadas para el rango de fechas e identificar el subyacente (SPXW/SPX)

  2. Obtener velas de 15 minutos (apropiadas para un rango de varios días)

  3. Ejecutar el script de gráficos para generar un gráfico interactivo de Plotly con marcadores de órdenes, separadores de días y tooltips al pasar el ratón

Seguridad

Las operaciones de mutación (place_order, cancel_order, replace_order) utilizan un patrón de confirmación de dos pasos. La primera llamada es una prueba que muestra lo que sucedería; debes confirmar explícitamente para ejecutar.

Estructura del proyecto

src/schwab_mcp/
  server.py          # CLI entry point (serve / auth commands)
  client.py          # Schwab client init, OAuth tokens, state persistence
  _mcp.py            # FastMCP server instance
  logging_config.py  # Rotating log handler with credential redaction
  tools/             # MCP tool implementations
    session.py       # Account listing and selection
    market_data.py   # Quotes, options, price history, movers
    accounts.py      # Account details, transactions, preferences
    orders.py        # Order CRUD with dry-run safety
    instruments.py   # Symbol/CUSIP lookup

plugin/
  .mcp.json                  # MCP server connection config
  .claude-plugin/plugin.json # Plugin metadata
  hooks/hooks.json           # Session cleanup hook
  skills/                    # Claude Code skill definitions

Estado y registros

Todo el estado de ejecución reside en ~/.schwab-mcp/:

Archivo

Propósito

.env

Credenciales de API

tokens.db

Tokens OAuth (actualizados automáticamente por schwabdev)

state.json

Selección de cuenta activa

schwab-mcp.log

Registro rotativo (5 MB, 3 copias de seguridad, credenciales redactadas)

Las respuestas grandes de las herramientas (cadenas de opciones, listas largas de transacciones) se escriben en /tmp/schwab-mcp/ y se limpian automáticamente cuando termina la sesión de Claude Code.

Desarrollo

# Run tests
pytest

# Run with debug logging
LOG_LEVEL=DEBUG schwab-mcp serve

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Schwab MCP Server

    sudowealth
    F
    license
    Not graded
    quality
    F
    maintenance
    A Model Context Protocol server that enables AI assistants like Claude to securely interact with Charles Schwab accounts and market data through the official Schwab API.
    75
    -

  • KiteMCP

    utkarshagar2121
    F
    license
    Not graded
    quality
    D
    maintenance
    A command-based MCP server that enables programmatic stock trading on Zerodha through natural language interfaces like Claude, allowing users to buy and sell stocks via API calls.
    -

  • tradier-mcp

    fi222
    F
    license
    Not graded
    quality
    D
    maintenance
    MCP server exposing Tradier brokerage tools to Claude, enabling account balance checks, position management, order operations, and market data queries.
    -

  • ibkr-mcp-server

    ArjunDivecha
    A
    license
    A
    quality
    F
    maintenance
    MCP server for Interactive Brokers API integration, enabling account management, trading, market data, and short selling analysis through Claude.
    8
    35
    MIT