OpenMM MCP

📚Documentation·🤖AI Skills Portal·🔌API Reference

MCP server forOpenMM— exposes market data, account, trading, and strategy tools to AI agents via any MCP client.

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

{ "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" } } } }

Replace/path/to/openmm-mcpwith the actual install path. For Claude Desktop, use the full path tonode(e.g. fromwhich node) to avoid nvm/PATH issues.

Tip:Runopenmm-mcp --setupinstead — it writes the correct absolute paths automatically.

No API keys. No private keys. No passwords. Just the socket path.

You can skip the vault and pass API keys directly in theenvblock:

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

The vault strengthens every scenario — nothing sensitive exists in any config file, process environment, or client memory.

All clients connect to the same runningopenmm serve— one vault, one socket, any client.

Connect tomcp.openmm.io— no local installation needed for public data. Pay per tool call with USDC on Base.

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

- Agent calls a tool
- Server returns402 Payment Requiredwith price
- openmm servesigns EIP-3009 authorization (gasless — no ETH needed)
- Server submits payment on-chain and returns data

Supported exchanges:mexc,gateio,bitget,kraken,binance,coinbase,okx

"Get me the BTC/USDT ticker on MEXC"

"Buy 0.1 ETH at $2400 on Kraken"

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

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

- Vault:AES-256-GCM encrypted at~/.openmm/vault.enc
- Password:Interactive terminal only — never in any config file, env var, or CLI flag
- Socket:/tmp/openmm.sockmode0600— the socket is the authentication boundary
- Policy:Spending limits enforced at the socket before the private key is touched
- Isolation:Private key never enters any MCP client process memory — signing happens in theopenmm serveprocess via IPC

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

- OpenMM SDK— Underlying trading SDK
- x402 Package— Payment integration
- MCP Specification— Model Context Protocol docs
- Base Network— L2 for USDC payments

A hosted deployment is available onFronteir AI.

Cross-chain cryptocurrency swaps via Chainflip. Get quotes, execute swaps, and track progress.