{
  "markdown": "# PumpClaw 🦞\n\n**Revenue infrastructure for autonomous AI agents on Base.**\n\n[![Base](https://img.shields.io/badge/Chain-Base-blue)](https://base.org)\n[![Uniswap V4](https://img.shields.io/badge/DEX-Uniswap%20V4-ff007a)](https://uniswap.org)\n[![Tokens Launched](https://img.shields.io/badge/Tokens%20Launched-148-brightgreen)](https://pumpclaw.com)\n[![Creator Fees](https://img.shields.io/badge/Creator%20Fees-80%25-orange)](https://pumpclaw.com)\n[![License](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)\n\n**Packages:**\n\n[![npm pumpclaw-cli](https://img.shields.io/npm/v/pumpclaw-cli?label=pumpclaw-cli&color=cb3837)](https://www.npmjs.com/package/pumpclaw-cli)\n[![npm pumpclaw-mcp](https://img.shields.io/npm/v/pumpclaw-mcp?label=pumpclaw-mcp&color=cb3837)](https://www.npmjs.com/package/pumpclaw-mcp)\n[![npm elizaos-plugin](https://img.shields.io/npm/v/elizaos-plugin-pumpclaw?label=elizaos-plugin&color=cb3837)](https://www.npmjs.com/package/elizaos-plugin-pumpclaw)\n[![GitHub Action](https://img.shields.io/badge/GitHub%20Action-v1.0.0-2088FF)](https://github.com/clawd800/pumpclaw-action)\n[![ClawHub Skill](https://img.shields.io/badge/ClawHub-token--launcher%20v2.1.0-7c3aed)](https://clawhub.ai/clawd800/token-launcher)\n[![ERC-8004](https://img.shields.io/badge/ERC--8004-Agent%20%2317197-4ade80)](https://pumpclaw.com/agent.json)\n\n> Deploy a token → people trade it → 80% of fees flow to your agent wallet. No grants, no VCs, no human approvals.\n\n🌐 [pumpclaw.com](https://pumpclaw.com) · 📦 CLI: `npx pumpclaw-cli deploy` · 🔌 MCP: `npx pumpclaw-mcp`\n\n🧩 ElizaOS: `npm i elizaos-plugin-pumpclaw` · 🎬 [GitHub Action](https://github.com/clawd800/pumpclaw-action) · 🛠️ [ClawHub Skill](https://clawhub.ai/clawd800/token-launcher)\n\n## Overview\n\nPumpClaw 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.\n\n- **$0 to launch** — zero ETH required for token creation\n- **80% creator fees** — highest in the market (2× Clanker)\n- **Own contracts** — no Clanker SDK dependency, no middleman servers\n- **LP locked forever** — immutable, no rugs\n- **Uniswap V4** — latest DEX infrastructure with native ETH\n- **Direct blockchain** — if pumpclaw.com goes down, your tokens still work\n- **Agent-native** — deploy via CLI, MCP, ElizaOS, Farcaster, GitHub Action, or contract\n- **Configurable** — custom supply (1M-1T) and initial FDV\n- **148 tokens live** on Base mainnet\n\n## 🤖 Deploy via Farcaster\n\nThe easiest way to launch a token — just cast on Farcaster:\n\n```\n@clawd deploy $COOL Cool Token\n@clawd launch $MOON MoonCoin\n@clawd create a token called \"Super Doge\" $SDOGE\n```\n\nThe bot will:\n1. Parse your token name and symbol\n2. Deploy on PumpClaw (Uniswap V4, LP locked forever)\n3. Reply with token address + swap links\n4. Set **you** as the creator (80% of trading fees go to you)\n\n**Requirements:** Must have a verified Ethereum address on your Farcaster profile.\n\nThe bot source is an internal operational script.\n\n## Contracts (Base Mainnet) — V3\n\n| Contract | Address | Verified |\n|----------|---------|----------|\n| **PumpClawFactory** | [`0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90`](https://basescan.org/address/0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90#code) | ✅ |\n| **PumpClawLPLocker** | [`0x9047c0944c843d91951a6C91dc9f3944D826ACA8`](https://basescan.org/address/0x9047c0944c843d91951a6C91dc9f3944D826ACA8#code) | ✅ |\n| **PumpClawSwapRouter** | [`0x3A9c65f4510de85F1843145d637ae895a2Fe04BE`](https://basescan.org/address/0x3A9c65f4510de85F1843145d637ae895a2Fe04BE#code) | ✅ |\n| **PumpClawFeeViewer** | [`0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39`](https://basescan.org/address/0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39#code) | ✅ |\n\n> **Note:** Uses native ETH (no WETH wrapping) for gas-efficient swaps.\n> Creators can set proof-of-origin `websiteUrl` and update image via `setImageUrl()`.\n\n## Contract Interface\n\n```solidity\n// Single function for token creation - all params configurable\nfunction createToken(\n    string name,\n    string symbol,\n    string imageUrl,\n    string websiteUrl,\n    uint256 totalSupply,  // e.g., 1_000_000_000e18 for 1B\n    uint256 initialFdv,   // e.g., 2e18 for 2 ETH\n    address creator       // receives fee claims\n) returns (address token, uint256 positionId)\n```\n\n**Defaults (set in clients):**\n- Supply: 1 billion tokens\n- Initial FDV: 2 ETH\n\n## CLI Usage\n\n```bash\ncd client-cli\nnpm install\n\n# Set private key\nexport PRIVATE_KEY=0x...\n\n# View factory info\nnpx tsx src/cli.ts info\n\n# Create a new token (V4: no ETH required!)\nnpx tsx src/cli.ts create --name \"My Token\" --symbol \"MTK\"\n\n# Create with custom FDV (default: 2 ETH)\nnpx tsx src/cli.ts create --name \"My Token\" --symbol \"MTK\" --fdv 50\n\n# Create with custom supply\nnpx tsx src/cli.ts create --name \"My Token\" --symbol \"MTK\" --supply 21000000\n\n# Buy tokens with ETH\nnpx tsx src/cli.ts buy <token_address> -e 0.001\n\n# Sell tokens for ETH\nnpx tsx src/cli.ts sell <token_address> -a 1000000\n\n# List all created tokens\nnpx tsx src/cli.ts list\n\n# Check pending fees\nnpx tsx src/cli.ts fees <token_address>\n\n# Claim fees (creator or admin)\nnpx tsx src/cli.ts claim <token_address>\n```\n\n## Shared Module\n\nCommon utilities for all clients in `/shared`:\n\n```typescript\nimport { \n  CONTRACTS, \n  TOKEN_DEFAULTS,\n  createClient,\n  buildCreateTokenArgs,\n  formatSupply,\n  getTokenInfo \n} from '../shared';\n\n// Use defaults\nconst args = buildCreateTokenArgs({\n  name: \"My Token\",\n  symbol: \"MTK\",\n  creator: \"0x...\"\n});\n\n// Or customize\nconst args = buildCreateTokenArgs({\n  name: \"My Token\",\n  symbol: \"MTK\",\n  totalSupply: 21_000_000n * 10n ** 18n,  // 21M like Bitcoin\n  initialFdv: 100n * 10n ** 18n,           // 100 ETH FDV\n  creator: \"0x...\"\n});\n```\n\n## Architecture\n\n```\nPumpClawFactory\n├── Creates PumpClawToken (ERC20)\n├── Initializes Uniswap V4 Pool\n└── Locks LP in LPLocker\n\nPumpClawSwapRouter\n├── Executes V4 swaps (native ETH)\n└── Simple buy/sell interface\n```\n\n## Token Economics\n\n- **Total Supply**: Configurable (default: 1 billion)\n- **Initial FDV**: Configurable (default: 2 ETH)\n- **LP Fee**: 1% on all swaps\n- **Fee Distribution**: 80% to creator, 20% to protocol\n\n## Development\n\n```bash\n# Install deps\nforge install\n\n# Build\nforge build\n\n# Test\nforge test\n\n# Deploy (requires PRIVATE_KEY env)\n# From contracts/ directory:\ncd contracts && forge script script/Deploy.s.sol --rpc-url $BASE_RPC --broadcast\n\n# Verify on Basescan\nforge verify-contract <address> src/core/PumpClawFactory.sol:PumpClawFactory \\\n  --chain base --etherscan-api-key $BASESCAN_API_KEY\n```\n\n## PumpClaw vs Competitors\n\n| Feature | PumpClaw 🦞 | Clanker | ConLaunch | Bankr | pump.fun |\n|---------|-------------|---------|-----------|-------|----------|\n| **Creator Fee Share** | **80%** | 40% | 80% (via Clanker) | 57% | 0% (Cashback) |\n| **Own Contracts** | **✅ MIT** | ✅ | ❌ Clanker SDK | ✅ | ✅ |\n| **Server Dependency** | **None** | None | ⚠️ API required | None | None |\n| **LP Lock** | Forever (immutable) | Varies | Forever | → 0xdead | Varies |\n| **Chain** | Base | Base | Base | Base | Solana |\n| **Agent Integration** | CLI, MCP, ElizaOS, ClawHub, GH Action, FC bot | FC only | API, MCP | FC, 4claw | ❌ |\n| **Custom Supply** | 1M–1T | Fixed | Fixed | Fixed | Fixed |\n| **Custom FDV** | Configurable | Fixed | Fixed | Fixed | Fixed |\n| **On-chain Registry** | ✅ (no indexer) | ❌ | ❌ | ❌ | ❌ |\n| **Open Source** | **MIT** | ❌ | ❌ | ❌ | ❌ |\n\n> **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.\n\n## Stats\n\n- **148 tokens launched** on Base mainnet\n- **70+ unique creators**\n- **$0 cost** to create\n- **7 integration methods** — ClawHub skill, CLI, MCP, ElizaOS, GitHub Action, Farcaster bot, direct contract\n\n## Integration Options\n\n| Method | Best For | Docs |\n|--------|----------|------|\n| **Farcaster Bot** | Humans & social agents | Cast `@clawd deploy $SYM Name` |\n| **CLI** | Developers & automation | [`client-cli/`](./client-cli/) |\n| **npm package** | Agent frameworks | [`npx pumpclaw-cli deploy`](https://npmjs.com/package/pumpclaw-cli) |\n| **MCP Server** | Claude, GPT, any MCP agent | [`npx pumpclaw-mcp`](https://npmjs.com/package/pumpclaw-mcp) |\n| **Smart Contract** | Direct integration | See contract interface above |\n| **REST API** | Read-only token data | See API section below |\n\n## 📡 API\n\nLive JSON API — no API key needed, CORS-friendly, served by the indexer.\n\n### All Tokens\n```\nGET https://api.pumpclaw.com/api/v1/tokens\n```\n\nReturns all tokens with metadata, creator info, trade links, and % purchased:\n```json\n{\n  \"tokens\": [\n    {\n      \"address\": \"0x76767891...\",\n      \"name\": \"PumpClaw\",\n      \"symbol\": \"PUMPCLAW\",\n      \"imageUrl\": \"https://i.imgur.com/v9B9SlZ.png\",\n      \"creator\": \"0x261368f0...\",\n      \"createdAt\": \"2026-02-01T08:01:45.000Z\",\n      \"percentPurchased\": 5.4,\n      \"links\": {\n        \"pumpclaw\": \"https://pumpclaw.com/#/token/0x...\",\n        \"trade\": \"https://matcha.xyz/tokens/base/0x...\",\n        \"basescan\": \"https://basescan.org/token/0x...\"\n      }\n    }\n  ],\n  \"total\": 148, \"lastSynced\": 42701077, \"currentBlock\": 42701109\n}\n```\n\n### Protocol Stats\n```\nGET https://api.pumpclaw.com/api/v1/stats\n```\n\nReturns aggregate stats: total tokens, unique creators, factory address, fee structure.\n\n### Quick Fetch (curl/agents)\n```bash\n# Get all tokens\ncurl -s https://api.pumpclaw.com/api/v1/tokens | jq '.tokens[] | {symbol, address}'\n\n# Get stats\ncurl -s https://api.pumpclaw.com/api/v1/stats | jq '{totalTokens, uniqueCreators}'\n```\n\n## Integration Packages\n\n| Package | Install | Version | Description |\n|---------|---------|---------|-------------|\n| **CLI** | `npx pumpclaw-cli deploy` | ![npm](https://img.shields.io/npm/v/pumpclaw-cli?label=) | One-command token deployment |\n| **MCP Server** | `npx pumpclaw-mcp` | ![npm](https://img.shields.io/npm/v/pumpclaw-mcp?label=) | Model Context Protocol for AI tools |\n| **ElizaOS Plugin** | `npm i elizaos-plugin-pumpclaw` | ![npm](https://img.shields.io/npm/v/elizaos-plugin-pumpclaw?label=) | Plugin for ElizaOS agent framework |\n| **ClawHub Skill** | `clawdhub install clawd800/token-launcher` | v2.1.0 | OpenClaw agent skill |\n| **GitHub Action** | `clawd800/pumpclaw-action@v1` | v1.0.0 | CI/CD token deployment |\n| **REST API** | `curl api.pumpclaw.com/api/v1/tokens` | — | Read-only token data |\n\n## Links\n- 🌐 Web App: [pumpclaw.com](https://pumpclaw.com)\n- 🛠️ ClawHub: [token-launcher](https://clawhub.ai/clawd800/token-launcher)\n- 📦 npm CLI: [pumpclaw-cli](https://npmjs.com/package/pumpclaw-cli)\n- 🔌 npm MCP: [pumpclaw-mcp](https://npmjs.com/package/pumpclaw-mcp)\n- 🧩 npm ElizaOS: [elizaos-plugin-pumpclaw](https://npmjs.com/package/elizaos-plugin-pumpclaw)\n\n## License\n\nMIT\n",
  "bytes": 10976,
  "sha": "096f2d031dea7d7961175ea90745a2879ed8d7488505eba666b8d5c20b182a10",
  "repo_slug": "clawd800/pumpclaw",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_clawd800_pumpclaw_b02385c3/readme"
}