Openmm Mcp

io.github.adacapo21Published by GitHub account adacapo21v1.0.5Updated Oct 24, 2026

AI-native crypto trading MCP server — market data, orders, grid strategies & DeFi

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

OpenMM MCP gives an AI assistant crypto market data, account balances, order placement and grid-strategy tools across several exchanges and Cardano DEXes.

What you can do
  • List supported exchanges and read market data: tickers, order books, recent trades and OHLCV candles
  • Check account balances and open orders on a configured exchange
  • Place limit or market orders, cancel one order or all orders for a pair
  • Query Cardano DEX token prices and discover ADA liquidity pools
  • Start, stop and inspect grid trading strategies
When to use it
Useful when you want an assistant to monitor crypto markets, check exchange balances and open orders, or place and cancel trades and run grid strategies through natural-language requests, with credentials kept in an encrypted local vault.
Requirements
Local process on the user's machine; Node.js 20 or later. Install the npm package and run the setup wizard, then initialize the encrypted vault at ~/.openmm/vault.enc with a password, a wallet and optional exchange keys. Clients connect to a local socket started by the serve command. Alternatively, exchange API keys can be passed directly in the environment block, or the hosted endpoint can be used with pay-per-call USDC payments.
Before you install
It can place and cancel real orders and start trading strategies, so mistakes cost money. The vault holds a wallet private key and exchange API credentials; the export and wallet-export commands reveal secrets. The hosted option charges per tool call in USDC on Base, with spending limits set through the policy commands. Anyone with access to the local socket can act as the authenticated client.

Installation

In SourceWeft

  1. Open Openmm Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@qbtlabs/openmm-mcp

[smithery badge] [npm version] [npm downloads] [License: MIT] [Ask DeepWiki]

📚 Documentation · 🤖 AI Skills Portal · 🔌 API Reference

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

[openmm-mcp MCP server]

Two Ways to Use

OptionBest ForAPI KeysPayments
Local (npm)Full control, your own keysEncrypted vaultFree
Hosted (mcp.openmm.io)No setup, pay-per-useNot needed for public datax402 USDC

Local Setup

Prerequisites: Node.js 20 or later.

1. Install and configure

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

The setup wizard writes the correct MCP config for your client (Claude Desktop, Claude Code, Cursor, Windsurf). No credentials are stored in config files — only the socket path.

2. Initialize encrypted vault

bash
openmm-init

This creates an encrypted vault at ~/.openmm/vault.enc containing your wallet key and exchange API credentials. You'll set a password, generate (or import) a wallet, and optionally add exchange keys.

3. Start the server

bash
openmm serve

Type your vault password once. The unified socket starts at /tmp/openmm.sock — all MCP clients connect here. No credentials exist in any config file.

Manual configuration

If you prefer to edit config files directly instead of using --setup:

ClientConfig file
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code~/.claude.json
Cursor.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
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"      }    }  }}

Replace /path/to/openmm-mcp with the actual install path. For Claude Desktop, use the full path to node (e.g. from which node) to avoid nvm/PATH issues.

Tip: Run openmm-mcp --setup instead — it writes the correct absolute paths automatically.

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

Without vault (quick start)

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

json
{  "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.

Client compatibility

ClientWithout vaultWith vault
Claude DesktopAPI keys in envOnly OPENMM_SOCKET
Claude CodeAPI keys in envOnly OPENMM_SOCKET
CursorAPI keys in envOnly OPENMM_SOCKET
WindsurfAPI keys in envOnly OPENMM_SOCKET

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

Hosted Server with x402 Payments

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

How it works

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

Security properties

PropertyHow
Keys encrypted at restAES-256-GCM + PBKDF2 in ~/.openmm/vault.enc
Keys never in client memoryMCP process only holds socket path
Keys never in config filesNo API keys, no private keys anywhere in config
Process isolationSigning happens in openmm serve, not in the AI agent process
Policy enforcementSpending limits checked before private key is accessed
Memory safetysignAndWipe() — key used once, goes out of scope immediately

Payment flow

  1. Agent calls a tool
  2. Server returns 402 Payment Required with price
  3. openmm serve signs EIP-3009 authorization (gasless — no ETH needed)
  4. Server submits payment on-chain and returns data

Tool Pricing

CategoryToolsPrice (USDC)
Freelist_exchanges$0.00
Readget_ticker, get_orderbook, get_trades, get_ohlcv, get_balance, list_orders, get_cardano_price, discover_pools, get_strategy_status$0.001
Writecreate_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy$0.01

Available Tools (15)

ToolDescriptionParameters
Market Data
list_exchangesList supported exchanges—
get_tickerReal-time price, bid/ask, spread, volumeexchange, symbol
get_orderbookOrder book depth (bids/asks)exchange, symbol, limit?
get_tradesRecent trades with buy/sell summaryexchange, symbol, limit?
get_ohlcvOHLCV candlestick dataexchange, symbol, timeframe?, limit?
Account
get_balanceAccount balances (all or filtered)exchange, asset?
list_ordersOpen orders (all or by symbol)exchange, symbol?
Trading
create_orderPlace limit or market orderexchange, symbol, type, side, amount, price?
cancel_orderCancel order by IDexchange, symbol, orderId
cancel_all_ordersCancel all orders for a pairexchange, symbol
Cardano DEX
get_cardano_priceAggregated token price from DEXessymbol
discover_poolsDiscover direct ADA pools via Minswap and SundaeSwapsymbol
Strategy
start_grid_strategyStart grid tradingexchange, symbol, lowerPrice, upperPrice, gridLevels?, totalAmount
stop_strategyStop a running strategystrategyId, cancelOrders?
get_strategy_statusGet strategy statusstrategyId

CLI Reference

Setup & Server

CommandDescription
openmm-initCreate vault, generate/import wallet, add exchanges
openmm-init --import <key>Create vault with an existing private key
openmm serveUnlock vault, start unified socket
openmm-statusShow vault, socket, wallet, and exchange status (no password)

Exchange Credentials

CommandDescription
openmm-exchange listList configured exchanges
openmm-exchange add <id>Add exchange credentials
openmm-exchange remove <id>Remove exchange credentials

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

Wallet

CommandDescription
openmm-wallet infoShow wallet address and chain
openmm-wallet setSet wallet credentials
openmm-wallet exportDisplay private key (requires confirmation)

Spending Policy

CommandDescription
openmm-policy showShow current policy
openmm-policy set max-per-tx <amount>Max USDC per transaction
openmm-policy set max-per-day <amount>Max USDC per day
openmm-policy set allowed-chains <chains>Comma-separated chain IDs
openmm-policy resetClear all policy limits

Advanced

CommandDescription
openmm-vault infoShow vault metadata
openmm-vault change-passwordChange vault password
openmm-vault exportExport all credentials (dangerous)
openmm-vault destroyDelete the vault

Example Usage

Check BTC price:

"Get me the BTC/USDT ticker on MEXC"

Place an order:

"Buy 0.1 ETH at $2400 on Kraken"

Start grid strategy:

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

Check Cardano token:

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

Security

  • 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.sock mode 0600 — 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 the openmm serve process via IPC

Development

bash
git clone https://github.com/QBT-Labs/openMM-MCP.gitcd openMM-MCPnpm installnpm run typechecknpm run lintnpm testnpm run build

Resources

License

MIT

Hosted deployment

A hosted deployment is available on Fronteir AI.

Source: README.md at commit 7f10368

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts