io.github.QBT-Labs/openmm-mcp

Official15 toolsLive

by QBT-Labs · TypeScript

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

OpenMM MCP Server (io.github.QBT-Labs/openmm-mcp)

This MCP server provides an integration layer for OpenMM by exposing tools for market data, account operations, trading, and strategy functionality to AI agents. It is packaged as an MCP server and is intended to be used by MCP clients within AI-agent workflows.

🛠️ Key Features

MCP server for OpenMM
Exposes market data tools
Provides account tools
Supports trading tools
Offers strategy tools

🚀 Use Cases

AI agents that require market data access
Agent-driven trading workflows
Agent actions that depend on account operations
Strategy execution and coordination for automated decision-making

⚡ Developer Benefits

Standardized MCP server interface for MCP clients
Tool access organized for AI-agent consumption
Open-source project focused on AI-agents and MCP interoperability

⚠️ Limitations

Only information provided is the server purpose; specific tool behaviors, inputs/outputs, and supported chains are not described here.

Topics

ai-agentsai-agents-mcpcardanodefimarket-makingmcpmcp-clientmcp-serveropen-sourcesolanax402

Captured live from the server via tools/list.

list_exchanges

List all supported exchanges with their IDs, features, and required credentials

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ticker

Get real-time price, bid/ask, spread, and volume for a trading pair

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_orderbook

Fetch order book depth (bids and asks) for a trading pair

Parameters3

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
limit	number	optional	Number of results to return (default: 10, max: 100)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "limit": {
      "default": 10,
      "description": "Number of results to return (default: 10, max: 100)",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_trades

Get recent trades for a trading pair

Parameters3

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
limit	number	optional	Number of results to return (default: 20, max: 100)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "limit": {
      "default": 20,
      "description": "Number of results to return (default: 20, max: 100)",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ohlcv

Get OHLCV (candlestick) data for a trading pair

Parameters4

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
timeframe	string	optional	Candlestick timeframe (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w)
limit	number	optional	Number of results to return (default: 100, max: 500)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "timeframe": {
      "default": "1h",
      "description": "Candlestick timeframe (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w)",
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d",
        "1w"
      ]
    },
    "limit": {
      "default": 100,
      "description": "Number of results to return (default: 100, max: 500)",
      "type": "number",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_balance

Get account balances for all assets (or a specific asset) on a supported exchange

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
asset	string	optional	Optional asset to filter by (e.g., USDT, BTC). Returns all assets if omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "asset": {
      "description": "Optional asset to filter by (e.g., USDT, BTC). Returns all assets if omitted.",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_orders

List open orders on a supported exchange, optionally filtered by trading pair symbol

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	optional	Optional trading pair to filter by (e.g., BTC/USDT). Returns all if omitted.

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "description": "Optional trading pair to filter by (e.g., BTC/USDT). Returns all if omitted.",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_order

Create a new order (limit or market) on a supported exchange

Parameters6

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
type	string	required	Order type: limit or market
side	string	required	Order side: buy or sell
amount	number	required	Order amount in base currency
price	number	optional	Order price (required for limit orders, ignored for market orders)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "type": {
      "type": "string",
      "enum": [
        "limit",
        "market"
      ],
      "description": "Order type: limit or market"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "description": "Order side: buy or sell"
    },
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Order amount in base currency"
    },
    "price": {
      "description": "Order price (required for limit orders, ignored for market orders)",
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "exchange",
    "symbol",
    "type",
    "side",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_order

Cancel a specific order by ID on a supported exchange

Parameters3

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
orderId	string	required	The order ID to cancel

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "orderId": {
      "type": "string",
      "description": "The order ID to cancel"
    }
  },
  "required": [
    "exchange",
    "symbol",
    "orderId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_all_orders

Cancel all open orders for a trading pair on a supported exchange

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_cardano_price

Get aggregated price for a Cardano native token from DEX liquidity pools (TOKEN/USDT via ADA bridge)

Parameters1

symbol

string

required

Cardano token symbol (INDY, SNEK, MIN, NIGHT)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Cardano token symbol (INDY, SNEK, MIN, NIGHT)"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_pools

Discover Cardano DEX liquidity pools for a native token via Iris API

Parameters1

symbol

string

required

Cardano token symbol (INDY, SNEK, MIN, NIGHT)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Cardano token symbol (INDY, SNEK, MIN, NIGHT)"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

start_grid_strategy

Calculate and optionally place grid trading orders around the current price

Parameters9

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)
levels	number	optional	Grid levels per side (default: 5)
spacing	number	optional	Base spacing as decimal (default: 0.02 = 2%)
orderSize	number	optional	Base order size in quote currency (default: 50)
spacingModel	string	optional	Spacing model
spacingFactor	number	optional	Factor for geometric spacing (default: 1.3)
sizeModel	string	optional	Size model
dryRun	boolean	optional	Preview grid without placing orders (default: true)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    },
    "levels": {
      "default": 5,
      "description": "Grid levels per side (default: 5)",
      "type": "number",
      "minimum": 1,
      "maximum": 10
    },
    "spacing": {
      "default": 0.02,
      "description": "Base spacing as decimal (default: 0.02 = 2%)",
      "type": "number",
      "minimum": 0.001,
      "maximum": 0.5
    },
    "orderSize": {
      "default": 50,
      "description": "Base order size in quote currency (default: 50)",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "spacingModel": {
      "default": "linear",
      "description": "Spacing model",
      "type": "string",
      "enum": [
        "linear",
        "geometric"
      ]
    },
    "spacingFactor": {
      "default": 1.3,
      "description": "Factor for geometric spacing (default: 1.3)",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "sizeModel": {
      "default": "flat",
      "description": "Size model",
      "type": "string",
      "enum": [
        "flat",
        "pyramidal"
      ]
    },
    "dryRun": {
      "default": true,
      "description": "Preview grid without placing orders (default: true)",
      "type": "boolean"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

stop_strategy

Cancel all open orders for a trading pair, effectively stopping any running grid strategy

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_strategy_status

Get current grid strategy status: open orders, current price, and P&L estimate

Parameters2

exchange	string	required	Exchange to query. Supported: mexc, gateio, bitget, kraken
symbol	string	required	Trading pair symbol (e.g., BTC/USDT, INDY/USDT)

Raw schema

{
  "type": "object",
  "properties": {
    "exchange": {
      "type": "string",
      "description": "Exchange to query. Supported: mexc, gateio, bitget, kraken"
    },
    "symbol": {
      "type": "string",
      "description": "Trading pair symbol (e.g., BTC/USDT, INDY/USDT)"
    }
  },
  "required": [
    "exchange",
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md11 KBView on GitHub

@qbtlabs/openmm-mcp

smithery badge

📚 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.

Two Ways to Use

Option	Best For	API Keys	Payments
Local (npm)	Full control, your own keys	Encrypted vault	Free
Hosted (mcp.openmm.io)	No setup, pay-per-use	Not needed for public data	x402 USDC

Local Setup

Prerequisites: Node.js 20 or later.

1. Install and configure

bash

npm install -g @qbtlabs/openmm-mcp
openmm-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:

Client	Config 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

Client	Without vault	With vault
Claude Desktop	API keys in env	Only `OPENMM_SOCKET`
Claude Code	API keys in env	Only `OPENMM_SOCKET`
Cursor	API keys in env	Only `OPENMM_SOCKET`
Windsurf	API keys in env	Only `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

code

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

Property	How
Keys encrypted at rest	AES-256-GCM + PBKDF2 in `~/.openmm/vault.enc`
Keys never in client memory	MCP process only holds socket path
Keys never in config files	No API keys, no private keys anywhere in config
Process isolation	Signing happens in `openmm serve`, not in the AI agent process
Policy enforcement	Spending limits checked before private key is accessed
Memory safety	`signAndWipe()` — key used once, goes out of scope immediately

Payment flow

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

Tool Pricing

Category	Tools	Price (USDC)
Free	`list_exchanges`	$0.00
Read	`get_ticker`, `get_orderbook`, `get_trades`, `get_ohlcv`, `get_balance`, `list_orders`, `get_cardano_price`, `discover_pools`, `get_strategy_status`	$0.001
Write	`create_order`, `cancel_order`, `cancel_all_orders`, `start_grid_strategy`, `stop_strategy`	$0.01

Available Tools (15)

Tool	Description	Parameters
Market Data
`list_exchanges`	List supported exchanges	—
`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_ohlcv`	OHLCV candlestick data	`exchange`, `symbol`, `timeframe?`, `limit?`
Account
`get_balance`	Account balances (all or filtered)	`exchange`, `asset?`
`list_orders`	Open orders (all or by symbol)	`exchange`, `symbol?`
Trading
`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`
Cardano DEX
`get_cardano_price`	Aggregated token price from DEXes	`symbol`
`discover_pools`	Discover liquidity pools	`symbol`, `minLiquidity?`
Strategy
`start_grid_strategy`	Start grid trading	`exchange`, `symbol`, `lowerPrice`, `upperPrice`, `gridLevels?`, `totalAmount`
`stop_strategy`	Stop a running strategy	`strategyId`, `cancelOrders?`
`get_strategy_status`	Get strategy status	`strategyId`

CLI Reference

Setup & Server

Command	Description
`openmm-init`	Create vault, generate/import wallet, add exchanges
`openmm-init --import <key>`	Create vault with an existing private key
`openmm serve`	Unlock vault, start unified socket
`openmm-status`	Show vault, socket, wallet, and exchange status (no password)

Exchange Credentials

Command	Description
`openmm-exchange list`	List 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

Command	Description
`openmm-wallet info`	Show wallet address and chain
`openmm-wallet set`	Set wallet credentials
`openmm-wallet export`	Display private key (requires confirmation)

Spending Policy

Command	Description
`openmm-policy show`	Show 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 reset`	Clear all policy limits

Advanced

Command	Description
`openmm-vault info`	Show vault metadata
`openmm-vault change-password`	Change vault password
`openmm-vault export`	Export all credentials (dangerous)
`openmm-vault destroy`	Delete the vault

Example Usage

Check BTC price:

code

"Get me the BTC/USDT ticker on MEXC"

Place an order:

code

"Buy 0.1 ETH at $2400 on Kraken"

Start grid strategy:

code

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

Check Cardano token:

code

"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.git
cd openMM-MCP
npm install
npm run typecheck
npm run lint
npm test
npm run build

Resources

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

License

MIT

Hosted deployment

A hosted deployment is available on Fronteir AI.

Install

Tools (15)

list_exchangesget_tickerget_orderbookget_tradesget_ohlcvget_balancelist_orderscreate_order

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "openmm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qbtlabs/openmm-mcp@1.0.14"
      ]
    }
  }
}