@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

⚡ Quick Start

MCP Server (13 tools)

# 1. Install & Setup OpenMM MCP
npm install -g @qbtlabs/openmm-mcp
npx @qbtlabs/openmm-mcp setup

The setup wizard will:

• Ask which MCP clients to configure (Claude Desktop, Claude Code, Cursor, Windsurf)

• Let you select exchanges (MEXC, Gate.io, Kraken, Bitget)

• Prompt for API credentials

• Automatically update your MCP config files

CLI Tool — Optional

# 2. Install & Setup OpenMM CLI
npm install -g @3rd-eye-labs/openmm
npx @3rd-eye-labs/openmm setup

Creates a .env file with your exchange credentials for direct CLI usage.

Verify Installation

After setup, restart your MCP client and try:

"What is my balance on MEXC?"

Manual Installation

npm install -g @qbtlabs/openmm-mcp

Or run directly:

npx @qbtlabs/openmm-mcp

Available Tools

MCP Resources

Prompts

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

Docker

docker build -t openmm-mcp .
docker run -e MEXC_API_KEY=your_key -e MEXC_SECRET_KEY=your_secret openmm-mcp

Remote Server

Connect directly to the hosted server — no local install required:

https://openmm-mcp.qbtlabs.io/mcp

Any MCP-Compatible Client

The server uses stdio transport by default. Point your client at:

npx @qbtlabs/openmm-mcp

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

HTTP Mode

Run the server with HTTP transport (Streamable HTTP + SSE):

MCP_TRANSPORT=http PORT=3000 npx @qbtlabs/openmm-mcp

• POST /mcp — MCP endpoint

• GET /health — Health check

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