# OpenMM MCP

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

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add qbtlabs/openmm-mcp

# Browse available tools
npx -y smithery tool list qbtlabs/openmm-mcp

# Get full schema for a tool
npx -y smithery tool get qbtlabs/openmm-mcp get_ticker

# Call a tool
npx -y smithery tool call qbtlabs/openmm-mcp get_ticker '{}'
```

## Direct MCP Connection

Endpoint: `https://openmm-mcp--qbtlabs.run.tools`

## Tools (13)

- `get_ticker` — Get real-time price, bid/ask, spread, and volume for a trading pair on a supported exchange
- `get_orderbook` — Fetch order book depth (bids and asks) for a trading pair on a supported exchange
- `get_trades` — Get recent trades for a trading pair on a supported exchange
- `get_balance` — Get account balances for all assets (or a specific asset) on a supported exchange
- `list_orders` — List open orders on a supported exchange, optionally filtered by trading pair symbol
- `create_order` — Create a new order (limit or market) on a supported exchange
- `cancel_order` — Cancel a specific order by ID on a supported exchange
- `cancel_all_orders` — Cancel all open orders for a trading pair on a supported exchange
- `get_cardano_price` — Get aggregated price for a Cardano native token from DEX liquidity pools (TOKEN/USDT via ADA bridge)
- `discover_pools` — Discover Cardano DEX liquidity pools for a native token via Iris API
- `start_grid_strategy` — Calculate and optionally place grid trading orders around the current price
- `stop_strategy` — Cancel all open orders for a trading pair, effectively stopping any running grid strategy
- `get_strategy_status` — Get current grid strategy status: open orders, current price, and P&L estimate

```bash
# Get full input/output schema for a tool
npx -y smithery tool get qbtlabs/openmm-mcp <tool-name>
```

## Resources

- `exchanges://list`
- `strategies://grid`
- `strategies://grid/profiles`

## Prompts (3)

- `market_analysis` (exchange, symbol) — Analyze market conditions for a trading pair using ticker, order book, and recent trades data
- `portfolio_overview` (exchange) — Get a comprehensive overview of account balances and open orders across an exchange
- `grid_setup_advisor` (exchange, symbol, budget) — Analyze market conditions and recommend optimal grid trading configuration