openmm-mcp
@qbtlabs/openmm-mcp
📚 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 --setupEl 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-initEsto 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 serveEscribe 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 |
|
Claude Code |
|
Cursor |
|
Windsurf |
|
{
"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 --setupen 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 |
Claude Code | Claves API en env | Solo |
Cursor | Claves API en env | Solo |
Windsurf | Claves API en env | Solo |
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 settlementPropiedades de seguridad
Propiedad | Cómo |
Claves cifradas en reposo | AES-256-GCM + PBKDF2 en |
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 |
Aplicación de políticas | Límites de gasto verificados antes de acceder a la clave privada |
Seguridad de memoria |
|
Flujo de pago
El agente llama a una herramienta
El servidor devuelve
402 Payment Requiredcon el precioopenmm servefirma la autorización EIP-3009 (sin gas, no se necesita ETH)El servidor envía el pago en la cadena y devuelve los datos
Precios de herramientas
Categoría | Herramientas | Precio (USDC) |
Gratis |
| $0.00 |
Lectura |
| $0.001 |
Escritura |
| $0.01 |
Herramientas disponibles (15)
Herramienta | Descripción | Parámetros |
Datos de mercado | ||
| Listar intercambios compatibles | — |
| Precio en tiempo real, bid/ask, spread, volumen |
|
| Profundidad del libro de órdenes (bids/asks) |
|
| Operaciones recientes con resumen de compra/venta |
|
| Datos de velas OHLCV |
|
Cuenta | ||
| Saldos de cuenta (todos o filtrados) |
|
| Órdenes abiertas (todas o por símbolo) |
|
Trading | ||
| Colocar orden límite o de mercado |
|
| Cancelar orden por ID |
|
| Cancelar todas las órdenes de un par |
|
Cardano DEX | ||
| Precio agregado del token desde DEXes |
|
| Descubrir pools de liquidez |
|
Estrategia | ||
| Iniciar trading de cuadrícula |
|
| Detener una estrategia en ejecución |
|
| Obtener estado de la estrategia |
|
Referencia de CLI
Configuración y servidor
Comando | Descripción |
| Crear bóveda, generar/importar billetera, añadir intercambios |
| Crear bóveda con una clave privada existente |
| Desbloquear bóveda, iniciar socket unificado |
| Mostrar estado de bóveda, socket, billetera e intercambio (sin contraseña) |
Credenciales de intercambio
Comando | Descripción |
| Listar intercambios configurados |
| Añadir credenciales de intercambio |
| Eliminar credenciales de intercambio |
Intercambios compatibles: mexc, gateio, bitget, kraken, binance, coinbase, okx
Billetera
Comando | Descripción |
| Mostrar dirección de billetera y cadena |
| Establecer credenciales de billetera |
| Mostrar clave privada (requiere confirmación) |
Política de gastos
Comando | Descripción |
| Mostrar política actual |
| USDC máximo por transacción |
| USDC máximo por día |
| IDs de cadena separados por comas |
| Borrar todos los límites de política |
Avanzado
Comando | Descripción |
| Mostrar metadatos de la bóveda |
| Cambiar contraseña de la bóveda |
| Exportar todas las credenciales (peligroso) |
| 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.encContraseña: Solo terminal interactiva: nunca en ningún archivo de configuración, variable de entorno o bandera de CLI
Socket:
/tmp/openmm.sockmodo0600: el socket es el límite de autenticaciónPolí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 servea 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 buildRecursos
OpenMM SDK — SDK de trading subyacente
Paquete x402 — Integración de pagos
Especificación MCP — Documentos del Protocolo de Contexto de Modelo
Base Network — L2 para pagos en USDC
Licencia
MIT
Despliegue alojado
Un despliegue alojado está disponible en Fronteir AI.
Available Tools
13 toolscancel_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
Scored across 13 tools
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.
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.
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.
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
Related MCP Connectors
AI prediction market trading — real-time data, CLOB exchange, Prop Desk, 40+ tools
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
AI crypto signals, whale positions, 19 technical indicators, derivatives, screener and backtests
Crypto market signals and portfolio telemetry. 6 tools pay-per-call in USDC, no API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides cryptocurrency trading signals, market analysis, and portfolio management capabilities across 15+ exchanges with AI-enhanced technical analysis, arbitrage detection, and risk assessment tools.2MIT
- AlicenseAqualityDmaintenanceTrade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.48115 npm20MIT

Haiku DeFi MCPofficial
AlicenseAqualityDmaintenanceMCP 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.780 npm2MIT- AlicenseNot gradedqualityDmaintenanceEnables AI-powered cryptocurrency trading and analytics across multiple exchanges and blockchains, with integrated Telegram bot and live trading capabilities.3MIT