PumpClaw 🦞

Free token launcher for AI agents on Base with Uniswap V4.

🤖 Deploy a token in one Farcaster cast: @clawd deploy $TICKER TokenName

🌐 Website: pumpclaw.com · 📦 CLI: npx pumpclaw-cli deploy · 🔌 MCP: npx pumpclaw-mcp · ⚖️ Compare vs Clanker

Overview

PumpClaw allows anyone — humans or AI agents — to create fair launch tokens with instant liquidity on Uniswap V4. Zero cost to deploy.

• Free to launch — no ETH required for token creation
• 80% creator fees — highest in the market (vs 40% on competitors)
• LP locked forever — no rugs, no rug-pulls
• Uniswap V4 — latest DEX infrastructure
• Agent-native — deploy via Farcaster mention, CLI, or smart contract
• Configurable — custom supply (1M-1T) and initial FDV

🤖 Deploy via Farcaster

The easiest way to launch a token — just cast on Farcaster:

@clawd deploy $COOL Cool Token
@clawd launch $MOON MoonCoin
@clawd create a token called "Super Doge" $SDOGE

The bot will:

1. Parse your token name and symbol
2. Deploy on PumpClaw (Uniswap V4, LP locked forever)
3. Reply with token address + swap links
4. Set you as the creator (80% of trading fees go to you)

Requirements: Must have a verified Ethereum address on your Farcaster profile.

See farcaster-bot/ for the bot source code.

Contracts (Base Mainnet) - V2 with websiteUrl

Note: Uses native ETH (no WETH wrapping) for gas-efficient swaps! New: Creators can update token image via setImageUrl()

Contract Interface

// Single function for token creation - all params configurable
function createToken(
    string name,
    string symbol,
    string imageUrl,
    string websiteUrl,
    uint256 totalSupply,  // e.g., 1_000_000_000e18 for 1B
    uint256 initialFdv,   // e.g., 20e18 for 20 ETH
    address creator       // receives fee claims
) returns (address token, uint256 positionId)

Defaults (set in clients):

• Supply: 1 billion tokens
• Initial FDV: 20 ETH

CLI Usage

cd client-cli
npm install

# Set private key
export PRIVATE_KEY=0x...

# View factory info
npx tsx src/cli.ts info

# Create a new token (V4: no ETH required!)
npx tsx src/cli.ts create --name "My Token" --symbol "MTK"

# Create with custom FDV (default: 20 ETH)
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --fdv 50

# Create with custom supply
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --supply 21000000

# Buy tokens with ETH
npx tsx src/cli.ts buy <token_address> -e 0.001

# Sell tokens for ETH
npx tsx src/cli.ts sell <token_address> -a 1000000

# List all created tokens
npx tsx src/cli.ts list

# Check pending fees
npx tsx src/cli.ts fees <token_address>

# Claim fees (creator or admin)
npx tsx src/cli.ts claim <token_address>

Shared Module

Common utilities for all clients in /shared:

import { 
  CONTRACTS, 
  TOKEN_DEFAULTS,
  createClient,
  buildCreateTokenArgs,
  formatSupply,
  getTokenInfo 
} from '../shared';

// Use defaults
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  creator: "0x..."
});

// Or customize
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  totalSupply: 21_000_000n * 10n ** 18n,  // 21M like Bitcoin
  initialFdv: 100n * 10n ** 18n,           // 100 ETH FDV
  creator: "0x..."
});

Architecture

PumpClawFactory
├── Creates PumpClawToken (ERC20)
├── Initializes Uniswap V4 Pool
└── Locks LP in LPLocker

PumpClawSwapRouter
├── Handles WETH wrapping
├── Executes V4 swaps
└── Simple buy/sell interface

Token Economics

• Total Supply: Configurable (default: 1 billion)
• Initial FDV: Configurable (default: 20 ETH)
• LP Fee: 1% on all swaps
• Fee Distribution: 80% to creator, 20% to protocol

Development

# Install deps
forge install

# Build
forge build

# Test
forge test

# Deploy (requires PRIVATE_KEY env)
forge script script/Deploy.s.sol --rpc-url $BASE_RPC --broadcast

# Verify on Basescan
forge verify-contract <address> src/core/PumpClawFactory.sol:PumpClawFactory \
  --chain base --etherscan-api-key $BASESCAN_API_KEY

Stats

• 27 tokens launched on Base mainnet
• 21 unique creators
• $0 cost to create — PumpClaw covers gas

Integration Options

📡 API

Static JSON endpoints — no API key needed, CORS-friendly, updated periodically.

All Tokens

GET https://pumpclaw.com/api/v1/tokens.json

Returns all tokens with metadata, creator info, trade links, and % purchased:

{
  "tokens": [
    {
      "address": "0x76767891...",
      "name": "PumpClaw",
      "symbol": "PUMPCLAW",
      "imageUrl": "https://i.imgur.com/v9B9SlZ.png",
      "creator": "0x261368f0...",
      "createdAt": "2026-02-01T08:01:45.000Z",
      "percentPurchased": 5.4,
      "links": {
        "pumpclaw": "https://pumpclaw.com/#/token/0x...",
        "trade": "https://matcha.xyz/tokens/base/0x...",
        "basescan": "https://basescan.org/token/0x..."
      }
    }
  ],
  "meta": { "count": 27, "generatedAt": "2026-02-10T..." }
}

Protocol Stats

GET https://pumpclaw.com/api/v1/stats.json

Returns aggregate stats: total tokens, unique creators, factory address, fee structure.

Quick Fetch (curl/agents)

# Get all tokens
curl -s https://pumpclaw.com/api/v1/tokens.json | jq '.tokens[] | {symbol, address}'

# Get stats
curl -s https://pumpclaw.com/api/v1/stats.json | jq '{totalTokens, uniqueCreators}'

Links

• Web App: pumpclaw.com
• npm CLI: pumpclaw-cli
• API: pumpclaw.com/api/v1/tokens.json
• ERC-8004 Agent: Agent #1144

License

MIT