@qbtlabs/openmm-mcp

MCP (Model Context Protocol) server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents via Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients.

Install and connect — 13 tools are now available to your AI agent.

What Agents Can Do

• Monitor markets — Real-time prices, order books, and trade history across multiple exchanges
• Trade — Place limit and market orders, cancel orders, manage positions
• Check balances — View account holdings across all connected exchanges
• Run grid strategies — Configure and deploy automated grid trading with dry-run preview
• Discover Cardano DEX liquidity — Aggregated token prices and pool discovery via on-chain data

Installation

npm install -g @qbtlabs/openmm-mcp

Or run directly:

npx @qbtlabs/openmm-mcp

Available Tools

| Tool | Description | Parameters | |------|-------------|------------| | get_ticker | Real-time price, bid/ask, spread, volume | exchange, symbol | | get_orderbook | Order book depth (bids/asks) | exchange, symbol, limit? | | get_trades | Recent trades with buy/sell summary | exchange, symbol, limit? | | get_balance | Account balances (all or filtered) | exchange, asset? | | list_orders | Open orders (all or by symbol) | exchange, symbol? | | create_order | Place limit or market order | exchange, symbol, type, side, amount, price? | | cancel_order | Cancel order by ID | exchange, symbol, orderId | | cancel_all_orders | Cancel all orders for a pair | exchange, symbol | | start_grid_strategy | Calculate and place grid orders | exchange, symbol, levels?, spacing?, orderSize?, spacingModel?, sizeModel?, dryRun? | | stop_strategy | Cancel all orders for a pair | exchange, symbol | | get_strategy_status | Grid status with open orders and spread | exchange, symbol | | get_cardano_price | Aggregated Cardano token price from DEXes | symbol | | discover_pools | Discover Cardano DEX liquidity pools | symbol |

MCP Resources

| URI | Description | |-----|-------------| | exchanges://list | Supported exchanges with credential requirements | | strategies://grid | Grid trading strategy documentation | | strategies://grid/profiles | Example grid profiles (conservative/moderate/aggressive) |

Prompts

| Prompt | Description | |--------|-------------| | market_analysis | Analyze ticker + order book + trades for a pair | | portfolio_overview | Summarize balances and open orders | | grid_setup_advisor | Recommend grid config based on market analysis |

Supported Exchanges

• MEXC — MEXC_API_KEY, MEXC_SECRET_KEY
• Bitget — BITGET_API_KEY, BITGET_SECRET, BITGET_PASSPHRASE
• Gate.io — GATEIO_API_KEY, GATEIO_SECRET
• Kraken — KRAKEN_API_KEY, KRAKEN_SECRET

Framework Setup

Claude Code

claude mcp add openmm -- npx @qbtlabs/openmm-mcp

Set your exchange API keys as environment variables before launching Claude Code.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json in your project:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Any MCP-Compatible Client

The server uses stdio transport. Point your client at:

npx @qbtlabs/openmm-mcp

Pass exchange credentials as environment variables (see Supported Exchanges).

Example Usage

Check a ticker price:

{
  "tool": "get_ticker",
  "arguments": {
    "exchange": "mexc",
    "symbol": "BTC/USDT"
  }
}

Place a limit buy order:

{
  "tool": "create_order",
  "arguments": {
    "exchange": "kraken",
    "symbol": "ETH/USDT",
    "type": "limit",
    "side": "buy",
    "amount": 0.5,
    "price": 2400
  }
}

Preview a grid strategy (dry run):

{
  "tool": "start_grid_strategy",
  "arguments": {
    "exchange": "mexc",
    "symbol": "INDY/USDT",
    "levels": 5,
    "spacing": 0.02,
    "orderSize": 50,
    "dryRun": true
  }
}

Get aggregated Cardano DEX price:

{
  "tool": "get_cardano_price",
  "arguments": {
    "symbol": "INDY"
  }
}

Development

git clone https://github.com/QBT-Labs/openMM-mcp-agent.git
cd openMM-mcp-agent
npm install
cp .env.example .env  # Edit with your API keys

npm run typecheck    # Type checking
npm run lint         # Linting
npm run format:check # Format checking
npm test             # Run tests
npm run build        # Build to dist/

Resources

• OpenMM SDK — Underlying trading SDK
• npm package — Published package
• MCP Specification — Model Context Protocol docs
• QBT Labs — Organization

Contributing

See CONTRIBUTING.md for guidelines on submitting issues and pull requests.

License

MIT