Skip to content

Free token launcher for AI agents on Base. Uniswap V4. 80% creator fees. LP locked forever. Deploy via Farcaster (@Clawd), CLI, or smart contract.

Notifications You must be signed in to change notification settings

clawd800/pumpclaw

Repository files navigation

PumpClaw 🦞

Revenue infrastructure for autonomous AI agents on Base.

Base Uniswap V4 Tokens Launched Creator Fees License

Packages:

npm pumpclaw-cli npm pumpclaw-mcp npm elizaos-plugin GitHub Action ClawHub Skill ERC-8004

Deploy a token → people trade it → 80% of fees flow to your agent wallet. No grants, no VCs, no human approvals.

🌐 pumpclaw.com · 📦 CLI: npx pumpclaw-cli deploy · 🔌 MCP: npx pumpclaw-mcp

🧩 ElizaOS: npm i elizaos-plugin-pumpclaw · 🎬 GitHub Action · 🛠️ ClawHub Skill

Overview

PumpClaw is how autonomous agents earn their existence. Deploy an ERC-20 token with instant Uniswap V4 liquidity, earn 80% of all trading fees — forever. Your agent's token isn't speculation; it's a revenue stream.

  • $0 to launch — zero ETH required for token creation
  • 80% creator fees — highest in the market (2× Clanker)
  • Own contracts — no Clanker SDK dependency, no middleman servers
  • LP locked forever — immutable, no rugs
  • Uniswap V4 — latest DEX infrastructure with native ETH
  • Direct blockchain — if pumpclaw.com goes down, your tokens still work
  • Agent-native — deploy via CLI, MCP, ElizaOS, Farcaster, GitHub Action, or contract
  • Configurable — custom supply (1M-1T) and initial FDV
  • 141 tokens live on Base mainnet

🤖 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) — V3

Contract Address Verified
PumpClawFactory 0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90
PumpClawLPLocker 0x6e4D241957074475741Ff42ec352b8b00217Bf5d
PumpClawSwapRouter 0x3A9c65f4510de85F1843145d637ae895a2Fe04BE
PumpClawFeeViewer 0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39

Note: Uses native ETH (no WETH wrapping) for gas-efficient swaps. Creators can set proof-of-origin websiteUrl and update 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: 10 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: 10 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: 10 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)
# From contracts/ directory:
cd contracts && 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

PumpClaw vs Competitors

Feature PumpClaw 🦞 Clanker ConLaunch Bankr pump.fun
Creator Fee Share 80% 40% 80% (via Clanker) 57% 0% (Cashback)
Own Contracts ✅ MIT ❌ Clanker SDK
Server Dependency None None ⚠️ API required None None
LP Lock Forever (immutable) Varies Forever → 0xdead Varies
Chain Base Base Base Base Solana
Agent Integration CLI, MCP, ElizaOS, ClawHub, GH Action, FC bot FC only API, MCP FC, 4claw
Custom Supply 1M–1T Fixed Fixed Fixed Fixed
Custom FDV Configurable Fixed Fixed Fixed Fixed
On-chain Registry ✅ (no indexer)
Open Source MIT

Key differentiator: PumpClaw calls the blockchain directly — no middleman server, no SDK dependency. If our website goes down, your tokens still work, fees still flow, agents still earn. Competitors that wrap Clanker SDK go down when their server goes down.

Stats

  • 141 tokens launched on Base mainnet
  • 70+ unique creators
  • $0 cost to create
  • 7 integration methods — ClawHub skill, CLI, MCP, ElizaOS, GitHub Action, Farcaster bot, direct contract

Integration Options

Method Best For Docs
Farcaster Bot Humans & social agents farcaster-bot/
CLI Developers & automation client-cli/
npm package Agent frameworks npx pumpclaw-cli deploy
MCP Server Claude, GPT, any MCP agent npx pumpclaw-mcp
Smart Contract Direct integration See contract interface above
REST API Read-only token data See API section below

📡 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}'

Integration Packages

Package Install Version Description
CLI npx pumpclaw-cli deploy npm One-command token deployment
MCP Server npx pumpclaw-mcp npm Model Context Protocol for AI tools
ElizaOS Plugin npm i elizaos-plugin-pumpclaw npm Plugin for ElizaOS agent framework
ClawHub Skill clawdhub install pumpclaw-base v2.0.0 OpenClaw agent skill
GitHub Action clawd800/pumpclaw-action@v1 v1.0.0 CI/CD token deployment
REST API curl pumpclaw.com/api/v1/tokens.json Read-only token data

Links

License

MIT

About

Free token launcher for AI agents on Base. Uniswap V4. 80% creator fees. LP locked forever. Deploy via Farcaster (@Clawd), CLI, or smart contract.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •