Pumpclaw

PumpClaw 🦞

Revenue infrastructure for autonomous AI agents on Base.

Packages:

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
• 148 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.

The bot source is an internal operational script.

Contracts (Base Mainnet) — V3

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., 2e18 for 2 ETH address creator // receives fee claims ) returns (address token, uint256 positionId)

Defaults (set in clients):

• Supply: 1 billion tokens
• Initial FDV: 2 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: 2 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 -e 0.001

Sell tokens for ETH

npx tsx src/cli.ts sell -a 1000000

List all created tokens

npx tsx src/cli.ts list

Check pending fees

npx tsx src/cli.ts fees

Claim fees (creator or admin)

npx tsx src/cli.ts claim

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 ├── Executes V4 swaps (native ETH) └── Simple buy/sell interface

Token Economics

• Total Supply: Configurable (default: 1 billion)
• Initial FDV: Configurable (default: 2 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 src/core/PumpClawFactory.sol:PumpClawFactory \ --chain base --etherscan-api-key $BASESCAN_API_KEY

PumpClaw vs Competitors

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

• 148 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

📡 API

Live JSON API — no API key needed, CORS-friendly, served by the indexer.

All Tokens

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

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..." } } ], "total": 148, "lastSynced": 42701077, "currentBlock": 42701109 }

Protocol Stats

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

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

Quick Fetch (curl/agents)

# Get all tokens

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

Get stats

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

Integration Packages

Links

• 🌐 Web App: pumpclaw.com
• 🛠️ ClawHub: token-launcher
• 📦 npm CLI: pumpclaw-cli
• 🔌 npm MCP: pumpclaw-mcp
• 🧩 npm ElizaOS: elizaos-plugin-pumpclaw

License

MIT