Skip to main content
Glama

@qbtlabs/openmm-mcp

npm version npm downloads License: MIT Ask DeepWiki

📚 Documentación · 🤖 Portal de habilidades de IA · 🔌 Referencia de API

Servidor MCP para OpenMM — expone datos de mercado, cuentas, trading y herramientas de estrategia a agentes de IA a través de cualquier cliente MCP.

Dos formas de usarlo

Opción

Ideal para

Claves API

Pagos

Local (npm)

Control total, tus propias claves

Bóveda cifrada

Gratis

Alojado (mcp.openmm.io)

Sin configuración, pago por uso

No necesario para datos públicos

x402 USDC


Related MCP server: polymarket-trader-mcp

Configuración local

Requisitos previos: Node.js 20 o superior.

1. Instalar y configurar

npm install -g @qbtlabs/openmm-mcp
openmm-mcp --setup

El asistente de configuración escribe la configuración MCP correcta para tu cliente (Claude Desktop, Claude Code, Cursor, Windsurf). No se almacenan credenciales en los archivos de configuración, solo la ruta del socket.

2. Inicializar la bóveda cifrada

openmm-init

Esto crea una bóveda cifrada en ~/.openmm/vault.enc que contiene tu clave de billetera y las credenciales de API de intercambio. Establecerás una contraseña, generarás (o importarás) una billetera y, opcionalmente, añadirás claves de intercambio.

3. Iniciar el servidor

openmm serve

Escribe tu contraseña de bóveda una vez. El socket unificado se inicia en /tmp/openmm.sock: todos los clientes MCP se conectan aquí. No existen credenciales en ningún archivo de configuración.

Configuración manual

Si prefieres editar los archivos de configuración directamente en lugar de usar --setup:

Cliente

Archivo de configuración

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

~/.claude.json

Cursor

.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openmm": {
      "command": "node",
      "args": ["/path/to/openmm-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "OPENMM_SOCKET": "/tmp/openmm.sock",
        "PAYMENT_SERVER": "https://mcp.openmm.io",
        "X402_TESTNET": "true"
      }
    }
  }
}

Reemplaza /path/to/openmm-mcp con la ruta de instalación real. Para Claude Desktop, usa la ruta completa a node (por ejemplo, desde which node) para evitar problemas con nvm/PATH.

Consejo: Ejecuta openmm-mcp --setup en su lugar: escribe las rutas absolutas correctas automáticamente.

Sin claves API. Sin claves privadas. Sin contraseñas. Solo la ruta del socket.

Sin bóveda (inicio rápido)

Puedes omitir la bóveda y pasar las claves API directamente en el bloque env:

{
  "mcpServers": {
    "openmm": {
      "command": "npx",
      "args": ["@qbtlabs/openmm-mcp"],
      "env": {
        "MEXC_API_KEY": "your_key",
        "MEXC_SECRET": "your_secret"
      }
    }
  }
}

La bóveda fortalece cada escenario: nada sensible existe en ningún archivo de configuración, entorno de proceso o memoria del cliente.

Compatibilidad del cliente

Cliente

Sin bóveda

Con bóveda

Claude Desktop

Claves API en env

Solo OPENMM_SOCKET

Claude Code

Claves API en env

Solo OPENMM_SOCKET

Cursor

Claves API en env

Solo OPENMM_SOCKET

Windsurf

Claves API en env

Solo OPENMM_SOCKET

Todos los clientes se conectan al mismo openmm serve en ejecución: una bóveda, un socket, cualquier cliente.


Servidor alojado con pagos x402

Conéctate a mcp.openmm.io: no se necesita instalación local para datos públicos. Paga por llamada de herramienta con USDC en Base.

Cómo funciona

AI Agent (Claude / Cursor / Windsurf)
│  MCP stdio — no keys in config
▼
MCP Client Process
(reads OPENMM_SOCKET — credentials never here)
│  Unix socket /tmp/openmm.sock (mode 0600)
▼
openmm serve — unified vault process
┌──────────────────────────────────┐
│  ~/.openmm/vault.enc             │
│  AES-256-GCM + PBKDF2           │  ← wallet key + exchange keys, one vault
│            │                     │
│  Policy Engine                   │  ← maxPerTx, maxPerDay, allowedChains
│  (checked before key is touched) │
│            │                     │
│  signAndWipe()                   │  ← key used inline, wiped from memory
└──────────────────────────────────┘
│  EIP-3009 signature only
▼
mcp.openmm.io → x402 verification → Base L2 settlement

Propiedades de seguridad

Propiedad

Cómo

Claves cifradas en reposo

AES-256-GCM + PBKDF2 en ~/.openmm/vault.enc

Las claves nunca están en la memoria del cliente

El proceso MCP solo mantiene la ruta del socket

Las claves nunca están en archivos de configuración

Sin claves API, sin claves privadas en ninguna parte de la configuración

Aislamiento de procesos

La firma ocurre en openmm serve, no en el proceso del agente de IA

Aplicación de políticas

Límites de gasto verificados antes de acceder a la clave privada

Seguridad de memoria

signAndWipe(): la clave se usa una vez, sale del alcance inmediatamente

Flujo de pago

  1. El agente llama a una herramienta

  2. El servidor devuelve 402 Payment Required con el precio

  3. openmm serve firma la autorización EIP-3009 (sin gas, no se necesita ETH)

  4. El servidor envía el pago en la cadena y devuelve los datos

Precios de herramientas

Categoría

Herramientas

Precio (USDC)

Gratis

list_exchanges

$0.00

Lectura

get_ticker, get_orderbook, get_trades, get_ohlcv, get_balance, list_orders, get_cardano_price, discover_pools, get_strategy_status

$0.001

Escritura

create_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy

$0.01


Herramientas disponibles (15)

Herramienta

Descripción

Parámetros

Datos de mercado

list_exchanges

Listar intercambios compatibles

—

get_ticker

Precio en tiempo real, bid/ask, spread, volumen

exchange, symbol

get_orderbook

Profundidad del libro de órdenes (bids/asks)

exchange, symbol, limit?

get_trades

Operaciones recientes con resumen de compra/venta

exchange, symbol, limit?

get_ohlcv

Datos de velas OHLCV

exchange, symbol, timeframe?, limit?

Cuenta

get_balance

Saldos de cuenta (todos o filtrados)

exchange, asset?

list_orders

Órdenes abiertas (todas o por símbolo)

exchange, symbol?

Trading

create_order

Colocar orden límite o de mercado

exchange, symbol, type, side, amount, price?

cancel_order

Cancelar orden por ID

exchange, symbol, orderId

cancel_all_orders

Cancelar todas las órdenes de un par

exchange, symbol

Cardano DEX

get_cardano_price

Precio agregado del token desde DEXes

symbol

discover_pools

Descubrir pools de liquidez

symbol, minLiquidity?

Estrategia

start_grid_strategy

Iniciar trading de cuadrícula

exchange, symbol, lowerPrice, upperPrice, gridLevels?, totalAmount

stop_strategy

Detener una estrategia en ejecución

strategyId, cancelOrders?

get_strategy_status

Obtener estado de la estrategia

strategyId


Referencia de CLI

Configuración y servidor

Comando

Descripción

openmm-init

Crear bóveda, generar/importar billetera, añadir intercambios

openmm-init --import <key>

Crear bóveda con una clave privada existente

openmm serve

Desbloquear bóveda, iniciar socket unificado

openmm-status

Mostrar estado de bóveda, socket, billetera e intercambio (sin contraseña)

Credenciales de intercambio

Comando

Descripción

openmm-exchange list

Listar intercambios configurados

openmm-exchange add <id>

Añadir credenciales de intercambio

openmm-exchange remove <id>

Eliminar credenciales de intercambio

Intercambios compatibles: mexc, gateio, bitget, kraken, binance, coinbase, okx

Billetera

Comando

Descripción

openmm-wallet info

Mostrar dirección de billetera y cadena

openmm-wallet set

Establecer credenciales de billetera

openmm-wallet export

Mostrar clave privada (requiere confirmación)

Política de gastos

Comando

Descripción

openmm-policy show

Mostrar política actual

openmm-policy set max-per-tx <amount>

USDC máximo por transacción

openmm-policy set max-per-day <amount>

USDC máximo por día

openmm-policy set allowed-chains <chains>

IDs de cadena separados por comas

openmm-policy reset

Borrar todos los límites de política

Avanzado

Comando

Descripción

openmm-vault info

Mostrar metadatos de la bóveda

openmm-vault change-password

Cambiar contraseña de la bóveda

openmm-vault export

Exportar todas las credenciales (peligroso)

openmm-vault destroy

Eliminar la bóveda


Ejemplo de uso

Comprobar precio de BTC:

"Get me the BTC/USDT ticker on MEXC"

Colocar una orden:

"Buy 0.1 ETH at $2400 on Kraken"

Iniciar estrategia de cuadrícula:

"Start a grid strategy on MEXC for INDY/USDT between $0.10 and $0.15 with 10 levels and $500 total"

Comprobar token de Cardano:

"What's the current price of SNEK on Cardano DEXes?"

Seguridad

  • Bóveda: AES-256-GCM cifrada en ~/.openmm/vault.enc

  • Contraseña: Solo terminal interactiva: nunca en ningún archivo de configuración, variable de entorno o bandera de CLI

  • Socket: /tmp/openmm.sock modo 0600: el socket es el límite de autenticación

  • Política: Límites de gasto aplicados en el socket antes de tocar la clave privada

  • Aislamiento: La clave privada nunca entra en la memoria del proceso del cliente MCP: la firma ocurre en el proceso openmm serve a través de IPC


Desarrollo

git clone https://github.com/QBT-Labs/openMM-MCP.git
cd openMM-MCP
npm install
npm run typecheck
npm run lint
npm test
npm run build

Recursos

Licencia

MIT

Despliegue alojado

Un despliegue alojado está disponible en Fronteir AI.

Available Tools

13 tools
cancel_all_ordersAInspect

Cancel all open orders for a trading pair on a supported exchange

Inputs: exchange (required), symbol (required).

cancel_orderAInspect

Cancel a specific order by ID on a supported exchange

Inputs: exchange (required), symbol (required), orderId (required).

create_orderBInspect

Create a new order (limit or market) on a supported exchange

Inputs: exchange (required), symbol (required), type (required), side (required), +2 more.

discover_poolsAInspect

Discover Cardano DEX liquidity pools for a native token via Iris API

Inputs: symbol (required).

get_balanceAInspect

Get account balances for all assets (or a specific asset) on a supported exchange

Inputs: exchange (required), asset.

get_cardano_priceAInspect

Get aggregated price for a Cardano native token from DEX liquidity pools (TOKEN/USDT via ADA bridge)

Inputs: symbol (required).

get_orderbookBInspect

Fetch order book depth (bids and asks) for a trading pair on a supported exchange

Inputs: exchange (required), symbol (required), limit.

get_strategy_statusAInspect

Get current grid strategy status: open orders, current price, and P&L estimate

Inputs: exchange (required), symbol (required).

get_tickerAInspect

Get real-time price, bid/ask, spread, and volume for a trading pair on a supported exchange

Inputs: exchange (required), symbol (required).

get_tradesCInspect

Get recent trades for a trading pair on a supported exchange

Inputs: exchange (required), symbol (required), limit.

list_ordersAInspect

List open orders on a supported exchange, optionally filtered by trading pair symbol

Inputs: exchange (required), symbol.

start_grid_strategyBInspect

Calculate and optionally place grid trading orders around the current price

Inputs: exchange (required), symbol (required), levels, spacing, +5 more.

stop_strategyAInspect

Cancel all open orders for a trading pair, effectively stopping any running grid strategy

Inputs: exchange (required), symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as create_order for order creation and get_ticker for price data. However, cancel_all_orders and stop_strategy both involve canceling orders for a trading pair, which could cause confusion in selection, though stop_strategy is tied to grid strategies.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern with snake_case throughout, such as get_balance and list_orders. Minor deviations exist, like discover_pools using 'discover' instead of 'get' or 'list', but overall the pattern is clear and readable.

    Tool Count5/5

    With 13 tools, the count is well-scoped for a trading and strategy automation server. Each tool serves a specific function, from order management to price fetching and strategy control, without feeling excessive or insufficient for the domain.

    Completeness4/5

    The toolset covers core trading operations like order CRUD, balance checks, and market data, plus grid strategy management. A minor gap is the lack of tools for modifying existing orders (e.g., update_order) or detailed strategy configuration, but agents can work around this with the available tools.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides cryptocurrency trading signals, market analysis, and portfolio management capabilities across 15+ exchanges with AI-enhanced technical analysis, arbitrage detection, and risk assessment tools.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Trade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.
      48
      115 npm
      20
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for DeFi execution — lets AI agents swap, provide liquidity, lend, bridge, and run yield strategies across 22 chains in a single transaction. 7 tools for token discovery, portfolio analysis, quoting, and execution via the Haiku API.
      7
      80 npm
      2
      MIT