@clawnch/clawncher-mcp

MCP (Model Context Protocol) server for Clawncher — deploy tokens, trade, manage liquidity, claim fees on Base, and operate Hummingbot market-making bots via AI agents.

Install

npm install -g @clawnch/clawncher-mcp

Configuration

Set environment variables before running:

# Required for write operations (deploy, swap, claim)
export CLAWNCHER_PRIVATE_KEY=0x...

# Optional
export CLAWNCHER_NETWORK=mainnet          # or "sepolia" (default: mainnet)
export CLAWNCHER_RPC_URL=https://...      # custom RPC (default: public Base RPC)
export CLAWNCHER_API_URL=https://clawn.ch # API base URL
export CLAWNCHER_API_KEY=...              # for verified agent deploys
export UNISWAP_API_KEY=...               # for Uniswap Trading API swaps (hub.uniswap.org)

# Hummingbot (optional — enables 23 market-making tools)
export HUMMINGBOT_API_URL=http://localhost:8000  # Hummingbot API server
export HUMMINGBOT_USERNAME=admin                 # HTTP Basic Auth
export HUMMINGBOT_PASSWORD=admin

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "clawncher": {
      "command": "clawncher-mcp",
      "env": {
        "CLAWNCHER_PRIVATE_KEY": "0x...",
        "CLAWNCHER_NETWORK": "mainnet"
      }
    }
  }
}

Or with npx (no global install):

{
  "mcpServers": {
    "clawncher": {
      "command": "npx",
      "args": ["-y", "@clawnch/clawncher-mcp"],
      "env": {
        "CLAWNCHER_PRIVATE_KEY": "0x...",
        "CLAWNCHER_NETWORK": "mainnet"
      }
    }
  }
}

Available Tools

| Tool | Description | Requires Key | |------|-------------|:---:| | clawncher_deploy | Deploy a new ERC-20 token with Uniswap V4 pool | Yes | | clawncher_deploy_verified | Deploy as a verified @clawnch agent (costs 100 CLAWNCH) | Yes + API Key | | clawncher_token_info | Get on-chain token details (vault, MEV, rewards, etc.) | No | | clawncher_swap | Execute token swaps via 0x aggregation | Yes | | clawncher_fees_check | Check claimable LP trading fees for a wallet | No | | clawncher_fees_claim | Claim accumulated LP trading fees | Yes | | clawncher_stats | Get Clawnch market statistics | No | | clawncher_tokens | List tokens launched via Clawnch | No | | clawncher_portfolio | Portfolio summary with claimable fees | No | | clawncher_addresses | Contract addresses for a network | No | | clawncher_agent_register | Register as a verified Clawnch agent | Yes | | clawncher_agent_status | Check verified agent status | Yes + API Key | | clawncher_wallet_balance | ETH and token balances | No | | clawncher_skill | Retrieve Clawncher SDK quick-start docs | No | | Uniswap V4 / Permit2 | | | | clawncher_price | On-chain token price from V4 pool | No | | clawncher_uniswap_quote | V4 on-chain swap simulation with price impact | No | | clawncher_uniswap_swap | Execute swap via Uniswap Trading API | Yes + Uniswap Key | | clawncher_liquidity_positions | List V3 LP positions for a wallet | No | | clawncher_v4_pool | Read V4 pool state (price, tick, liquidity) | No | | clawncher_v4_position | Read V4 position details | No | | clawncher_v4_mint | Mint a new V4 LP position | Yes | | clawncher_permit2_status | Check Permit2 allowance state for a token | No | | clawncher_permit2_approve | Set up Permit2 approval flow (ERC20 + Permit2) | Yes | | clawncher_permit2_revoke | Emergency lockdown — revoke all Permit2 access | Yes | | Hummingbot Market Making | | | | hummingbot_status | Health check and API version | No | | hummingbot_portfolio | Portfolio overview, history, distribution across exchanges | No | | hummingbot_order | Place market/limit orders on any connected exchange | No | | hummingbot_cancel_order | Cancel an active order | No | | hummingbot_leverage | Set position mode and leverage for perpetual futures | No | | hummingbot_executor | Create, search, stop executors (grid, DCA, position, single) | No | | hummingbot_market_data | Prices, candles, order books, funding rates, VWAP | No | | hummingbot_connector | List connectors, trading rules, config maps | No | | hummingbot_controller | CRUD for controller and controller config definitions | No | | hummingbot_bot | Deploy, stop, status, logs, history for trading bots | No | | hummingbot_scripts | CRUD for scripts and script configs | No | | hummingbot_gateway_container | Start/stop/status/logs for Hummingbot Gateway | No | | hummingbot_gateway_config | Chains, networks, connectors, tokens, wallets | No | | hummingbot_gateway_swap | DEX swap quotes and execution via Gateway | No | | hummingbot_gateway_clmm | Concentrated liquidity: list pools, positions, add/remove | No | | hummingbot_backtest | Run backtests on strategy configurations | No | | hummingbot_discovery | Discover available connectors, trading rules, order types | No | | hummingbot_archived_bots | List archived bots, performance, trades, orders | No | | hummingbot_analytics | Portfolio history, funding payments, rate oracle | No | | hummingbot_accounts | List, create, delete trading accounts | No | | hummingbot_templates | Browse and build from 9 strategy templates | No | | hummingbot_servers | Server connection management | No |

Links

• Clawncher — Product page
• SDK Docs — Full technical documentation
• Skill Doc — Agent quick-start (raw markdown)
• npm: @clawnch/clawncher-sdk — SDK
• npm: clawncher — CLI