Qian

@qianexchange/mcp

qian.ag · npm · Docs · License: MIT

MCP server for Qian, a multichain exchange and payments layer for every asset. Any MCP-capable agent can launch tokens, trade, and read market data on every chain Qian supports (Robinhood Chain, Base, Ethereum), plus trade tokenized stocks on Robinhood Chain.

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

{
  "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 (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
list_stocks / quote_stock List and preview tokenized stocks, read-only (no key)
buy_stock / sell_stock Trade tokenized stocks via QianRWARouter (Robinhood Chain)
x402_wallet The x402 payment wallet: address and USDC balances
x402_pay Pay an x402 (HTTP 402) API in USDC and return its response

Tokenized stocks

Robinhood Chain carries tokenized stocks (NVDA, TSLA, SPY, and more) issued by a third party (Robinhood Assets); Qian is a non-custodial venue, not the issuer. US persons are restricted from trading them. The read tools (list_stocks, quote_stock) work for everyone, but buy_stock and sell_stock are for non-US persons only. The server is headless and cannot verify location, so that restriction is on you to honor.

x402 payments

x402_pay lets an agent pay for x402-gated APIs (HTTP 402 + USDC, Base mainnet or Arc testnet). It fetches the URL; on a 402 it signs an EIP-3009 USDC authorization and retries with the X-PAYMENT header. It never pays above the max_amount_usdc you pass per call.

Signing key resolution: X402_PRIVATE_KEY, else QIAN_KEY, else the server generates a burner wallet at ~/.qian/mcp-wallet.json on first use and prints its address. Fund that wallet with a few USDC on Base and treat it as float — never store more there than you're willing to let the agent spend.

Configuration

Env overrides: QIAN_API, QIAN_KEY, X402_PRIVATE_KEY, RPC_ROBINHOOD, RPC_BASE, RPC_ETHEREUM.

MIT. Contact: [email protected]

S
Description
No description provided
Readme MIT
151 KiB
Languages
JavaScript 100%