← Back to Docs
2 minute setup

Quick Start Guide

Get your AI agent trading in 2 minutes with the setup wizard

Prerequisites

  • Node.js 18+ installed
  • Exchange API keys (MEXC, Gate.io, Bitget, or Kraken)

Quick Start (4 Steps)

1

Install

Install the OpenMM package globally

Install
npm install -g @qbtlabs/openmm-mcp
2

Setup Vault, Wallet & Exchanges

Run the one-time setup wizard to create your encrypted vault

Setup Wizard
openmm-init

The setup wizard will:

  • Create an AES-256-GCM encrypted vault
  • Generate an on-chain wallet
  • Prompt for exchange API credentials (stored in vault)
3

Start the Server

Start the unified MCP server. Run this before launching any AI client.

Start Server
openmm serve

✅ Once you see "Ready — waiting for MCP connections..." you're good.

4

Configure Your AI Client

Write the MCP config for your client (Claude, Cursor, Windsurf, etc.)

Configure Client
openmm-mcp --setup

This writes only OPENMM_SOCKET to your client config — no credentials leave the vault.

How It Works

One vault, one socket, zero credentials in your AI client.

  • openmm serve unlocks your vault and opens a local IPC socket
  • • Your MCP client connects via OPENMM_SOCKET only
  • • Payment signing goes through the socket — private key never leaves the vault process
  • • Policy enforcement happens at the socket before the key is touched

See MCP Setup Guide for client-specific instructions, or CLI Reference for all commands.

Available Tools

ToolDescription
openmm_tickerGet price, bid/ask, spread, 24h volume
openmm_orderbookGet order book bids and asks
openmm_tradesGet recent trades with buy/sell breakdown
openmm_balanceGet account balances
openmm_list_ordersList open orders
openmm_grid_statusGet grid strategy status
openmm_cardano_priceGet Cardano token prices from DEX
openmm_discover_poolsDiscover Cardano DEX pools

Next Steps