# @qianexchange/mcp

MCP server for [Qian](https://qian.ag), the multichain DEX and launchpad. Any MCP-capable agent can launch tokens, trade, and read market data on Robinhood Chain, Base, and Ethereum.

Non-custodial: the server runs on your machine and signs with your key. Qian never holds keys or funds. Every launched token's liquidity is locked forever in QianLocker.

## Setup

```json
{
  "mcpServers": {
    "qian": {
      "command": "npx",
      "args": ["-y", "@qianexchange/mcp"],
      "env": { "QIAN_KEY": "0x<your-agent-wallet-private-key>" }
    }
  }
}
```

Omit `QIAN_KEY` for read-only mode (market data still works). Use a dedicated hot wallet funded with only what the agent may spend.

## Tools

| Tool | What it does |
|---|---|
| `list_tokens` | Tokens on Qian, all chains, with price/FDV/volume |
| `get_token` | Full detail: price, FDV, hook, metadata |
| `get_trades` / `get_holders` | Market activity |
| `my_wallet` | Your address + ETH balance per chain |
| `my_positions` | Holdings, ETH value, and PnL for any address across chains |
| `quote_buy` / `quote_sell` | Preview a trade, read-only (no key or approval) |
| `buy` / `sell` | Trade via QianSwapRouter (plain ETH in/out, auto-approve, slippage-protected) |
| `launch_token` | Deploy a token: name/symbol/image/socials, FDV tier 1–4, creator fee 0.5–20%, optional dev buy |
| `pending_fees` | Unclaimed creator/platform fees for a token (read-only) |
| `collect_fees` | Claim your 70% creator share of trading fees |

## Configuration

Env overrides: `QIAN_API`, `RPC_ROBINHOOD`, `RPC_BASE`, `RPC_ETHEREUM`.

MIT. Contact: dev@qian.ag