JinDaGe - pumpclaw MCP Details

article

README

🚀 PumpClaw 🦞

PumpClaw 是为基于 Base 链的自主 AI 智能体打造的收益基础设施。它允许用户部署带有即时 Uniswap V4 流动性的 ERC - 20 代币，并永久获得 80% 的交易手续费。

🚀 快速开始

部署一个代币，人们进行交易，80% 的手续费将流入你的智能体钱包。无需资助，无需风投，无需人工审批。

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

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

✨ 主要特性

零成本启动 — 创建代币无需任何 ETH。
80% 创作者手续费 — 市场上最高（是 Clanker 的 2 倍）。
自有合约 — 不依赖 Clanker SDK，没有中间人服务器。
永久锁定流动性 — 不可变，无跑路风险。
Uniswap V4 — 采用最新的 DEX 基础设施，支持原生 ETH。
直接连接区块链 — 即使 pumpclaw.com 宕机，你的代币仍然可以正常工作。
支持智能体 — 可通过 CLI、MCP、ElizaOS、Farcaster、GitHub Action 或合约进行部署。
可配置 — 自定义供应量（100 万 - 1 万亿）和初始完全稀释估值（FDV）。
已有 148 个代币 在 Base 主网上线。

📦 安装指南

CLI 使用

cd client-cli
npm install

# 设置私钥
export PRIVATE_KEY=0x...

# 查看工厂信息
npx tsx src/cli.ts info

# 创建一个新代币（V4：无需 ETH！）
npx tsx src/cli.ts create --name "My Token" --symbol "MTK"

# 使用自定义 FDV 创建（默认：2 ETH）
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --fdv 50

# 使用自定义供应量创建
npx tsx src/cli.ts create --name "My Token" --symbol "MTK" --supply 21000000

# 使用 ETH 购买代币
npx tsx src/cli.ts buy <token_address> -e 0.001

# 出售代币换取 ETH
npx tsx src/cli.ts sell <token_address> -a 1000000

# 列出所有创建的代币
npx tsx src/cli.ts list

# 检查待领取的手续费
npx tsx src/cli.ts fees <token_address>

# 领取手续费（创作者或管理员）
npx tsx src/cli.ts claim <token_address>

开发环境

# 安装依赖
forge install

# 构建
forge build

# 测试
forge test

# 部署（需要设置 PRIVATE_KEY 环境变量）
# 从 contracts/ 目录执行：
cd contracts && forge script script/Deploy.s.sol --rpc-url $BASE_RPC --broadcast

# 在 Basescan 上验证合约
forge verify-contract <address> src/core/PumpClawFactory.sol:PumpClawFactory \
  --chain base --etherscan-api-key $BASESCAN_API_KEY

💻 使用示例

基础用法

通过 Farcaster 部署代币

这是启动代币最简单的方法 — 只需在 Farcaster 上发布消息：

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

机器人将执行以下操作：

解析你的代币名称和符号。
在 PumpClaw 上部署（Uniswap V4，流动性永久锁定）。
回复代币地址和交易链接。
将你设置为创作者（80% 的交易手续费归你）。

要求：必须在你的 Farcaster 个人资料中验证以太坊地址。

高级用法

合约接口

// 用于创建代币的单一函数 - 所有参数均可配置
function createToken(
    string name,
    string symbol,
    string imageUrl,
    string websiteUrl,
    uint256 totalSupply,  // 例如，1_000_000_000e18 表示 10 亿
    uint256 initialFdv,   // 例如，2e18 表示 2 ETH
    address creator       // 接收手续费的地址
) returns (address token, uint256 positionId)

默认值（在客户端设置）：

供应量：10 亿个代币
初始 FDV：2 ETH

共享模块

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

// 使用默认值
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  creator: "0x..."
});

// 或者自定义
const args = buildCreateTokenArgs({
  name: "My Token",
  symbol: "MTK",
  totalSupply: 21_000_000n * 10n ** 18n,  // 像比特币一样 2100 万
  initialFdv: 100n * 10n ** 18n,           // 100 ETH FDV
  creator: "0x..."
});

📚 详细文档

合约信息（Base 主网）— V3

| 合约 | 地址 | 是否验证 | |----------|---------|----------| | PumpClawFactory | 0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90 | ✅ | | PumpClawLPLocker | 0x6e4D241957074475741Ff42ec352b8b00217Bf5d | ✅ | | PumpClawSwapRouter | 0x3A9c65f4510de85F1843145d637ae895a2Fe04BE | ✅ | | PumpClawFeeViewer | 0xd25Da746946531F6d8Ba42c4bC0CbF25A39b4b39 | ✅ |

注意：使用原生 ETH（无需包装成 WETH）进行节省 gas 的交易。创作者可以设置来源证明 websiteUrl 并通过 setImageUrl() 更新图像。

集成选项

| 方法 | 适用场景 | 文档 | |--------|----------|------| | Farcaster 机器人 | 人类和社交智能体 | 发布 @clawd deploy $SYM Name | | CLI | 开发者和自动化 | client-cli/ | | npm 包 | 智能体框架 | npx pumpclaw-cli deploy | | MCP 服务器 | Claude、GPT 等 MCP 智能体 | npx pumpclaw-mcp | | 智能合约 | 直接集成 | 见上面的合约接口 | | REST API | 只读代币数据 | 见下面的 API 部分 |

API

实时 JSON API — 无需 API 密钥，支持 CORS，由索引器提供服务。

获取所有代币

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

返回所有代币的元数据、创作者信息、交易链接和购买百分比：

{
  "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
}

获取协议统计信息

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

返回汇总统计信息：代币总数、唯一创作者数量、工厂地址、手续费结构。

快速获取（curl/智能体）

# 获取所有代币
curl -s https://api.pumpclaw.com/api/v1/tokens | jq '.tokens[] | {symbol, address}'

# 获取统计信息
curl -s https://api.pumpclaw.com/api/v1/stats | jq '{totalTokens, uniqueCreators}'

集成包

| 包 | 安装命令 | 版本 | 描述 | |---------|---------|---------|-------------| | CLI | npx pumpclaw-cli deploy | npm | 一键部署代币 | | MCP 服务器 | npx pumpclaw-mcp | npm | 适用于 AI 工具的模型上下文协议 | | ElizaOS 插件 | npm i elizaos-plugin-pumpclaw | npm | ElizaOS 智能体框架的插件 | | ClawHub 技能 | clawdhub install clawd800/token-launcher | v2.1.0 | OpenClaw 智能体技能 | | GitHub Action | clawd800/pumpclaw-action@v1 | v1.0.0 | CI/CD 代币部署 | | REST API | curl api.pumpclaw.com/api/v1/tokens | — | 只读代币数据 |

链接

🌐 网页应用: pumpclaw.com
🛠️ ClawHub: token-launcher
📦 npm CLI: pumpclaw-cli
🔌 npm MCP: pumpclaw-mcp
🧩 npm ElizaOS: elizaos-plugin-pumpclaw

🔧 技术细节

架构

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

PumpClawSwapRouter
├── Executes V4 swaps (native ETH)
└── Simple buy/sell interface

代币经济学

总供应量：可配置（默认：10 亿）
初始 FDV：可配置（默认：2 ETH）
流动性手续费：所有交易 1%
手续费分配：80% 给创作者，20% 给协议

PumpClaw 与竞争对手对比

| 特性 | PumpClaw 🦞 | Clanker | ConLaunch | Bankr | pump.fun | |---------|-------------|---------|-----------|-------|----------| | 创作者手续费份额 | 80% | 40% | 80%（通过 Clanker） | 57% | 0%（返现） | | 自有合约 | ✅ MIT | ✅ | ❌ Clanker SDK | ✅ | ✅ | | 服务器依赖 | 无 | 无 | ⚠️ 需要 API | 无 | 无 | | 流动性锁定 | 永久（不可变） | 不同 | 永久 | → 0xdead | 不同 | | 链 | Base | Base | Base | Base | Solana | | 智能体集成 | CLI、MCP、ElizaOS、ClawHub、GH Action、FC 机器人 | 仅 FC | API、MCP | FC、4claw | ❌ | | 自定义供应量 | 100 万 - 1 万亿 | 固定 | 固定 | 固定 | 固定 | | 自定义 FDV | 可配置 | 固定 | 固定 | 固定 | 固定 | | 链上注册表 | ✅（无需索引器） | ❌ | ❌ | ❌ | ❌ | | 开源 | MIT | ❌ | ❌ | ❌ | ❌ |

关键区别：PumpClaw 直接调用区块链 — 没有中间人服务器，不依赖 SDK。即使我们的网站宕机，你的代币仍然可以正常工作，手续费仍然可以正常流入，智能体仍然可以获得收益。依赖 Clanker SDK 的竞争对手在其服务器宕机时将无法正常工作。

统计信息

已有 148 个代币 在 Base 主网上线
70 多个唯一创作者
创建成本为 0
7 种集成方法 — ClawHub 技能、CLI、MCP、ElizaOS、GitHub Action、Farcaster 机器人、直接合约

📄 许可证

本项目采用 MIT 许可证。

pumpclaw