# Qmax

> Qmax is a freemium MCP server for finance and payments. Best-price quotes, order books and trade plans for Qubic's QX and QSwap. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://qmax.exchange/agents/
- **Repository:** https://github.com/profitphil/qmax
- **MCP Registry name:** io.github.profitphil/qmax
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Qmax is a router for the Qubic network that prices an order on the QX order book and the QSwap pool, including fees, price impact and transfer costs, then picks the cheaper venue or splits across both. The MCP server gives an agent read-only access to that data: assets, quotes, order books, candles, price history, arbitrage checks, pools, asset health, the live trade tape, wallet ledgers and backtests.

Nothing in it signs or sends a transaction. The qmax_build_plan tool returns unsigned steps, and quotes and plans include an openInQMax link so you review and sign in your own wallet. A hosted endpoint needs no key or install, or you can run a single Node 22 file over stdio. The connector also offers a prompt for building a Qubic trading bot with a dry run and spending limits.

Almost everything is free. The one paid tool is qmax_best_position, 100 QU per plan, paid from a prepaid key or an x402 session. Free callers are limited to 60 requests a minute per address. The repository says all rights are reserved with no licence granted.

## Features

- **Cross-venue quotes:** Compares the QX order book with the QSwap pool and can split an order across both.
- **Unsigned trade plans:** qmax_build_plan returns steps for your own wallet to sign; the server never signs.
- **Market data tools:** Covers order books, candles, price history, pools, asset health and the live trade tape.
- **Backtests and ledgers:** Tests ideas on real history and reads wallet ledgers.
- **Hosted or local:** Use the hosted Streamable HTTP endpoint or run one Node file over stdio.
- **x402 payments:** Optional paid sessions for the Max plan, with a configurable spend cap.

## Good for

- Ask what selling 50 million of a Qubic asset would fetch
- Check for arbitrage between QX and QSwap
- Backtest a trading idea before writing a bot
- Prepare an unsigned trade plan to review in your wallet

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http qmax https://qmax.exchange/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://qmax.exchange/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qmax": {
      "url": "https://qmax.exchange/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qmax": {
      "type": "http",
      "url": "https://qmax.exchange/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qmax": {
      "serverUrl": "https://qmax.exchange/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qmax": {
      "type": "http",
      "url": "https://qmax.exchange/api/mcp"
    }
  }
}
```

## Tools

- `qmax_build_plan`: Returns unsigned trade steps for your own wallet to sign.
- `qmax_get_quote`: Quotes a buy or sell, with a plain-language summary.
- `qmax_best_position`: Paid Max tool that finds the best position for a trade, 100 QU per plan.
- `qmax_build_trading_bot`: Prompt that walks an assistant through building a Qubic trading bot safely.

## FAQ

### Can it trade for me?

No. Every tool is read-only; plans come back unsigned and you sign them in your own wallet.

### Is it free?

Almost all of it. qmax_best_position costs 100 QU per plan, paid from a prepaid key or inside a paid x402 session.

### Do I need an account?

Not for the hosted server, which needs no key and no sign-in.

### Are there rate limits?

Callers without a QMax key are limited per IP; the README gives a default of 60 a minute on market endpoints.

### Is Qmax free?

Qmax has a free plan, with paid plans for more usage or features.

### How do I add Qmax to Claude Code?

Run this command in your terminal: claude mcp add --transport http qmax https://qmax.exchange/api/mcp

### What are the best alternatives to Qmax?

The closest alternatives to Qmax are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/qmax
