four-meme-ai

name	four-meme-ai
description	Full-featured Four.meme AI agent skill for BSC meme token operations — create tokens, buy/sell execution, rankings, quotes, tax info, on-chain events, send BNB/ERC-20, and ERC-8004 agent identity registration. Installable via CLI or npm.
license	MIT-0
metadata	{"category":"trading","difficulty":"intermediate","author":"four-meme-community","version":"1.0.7","tags":["trading","four-meme","bsc","meme","launchpad","erc-8004","cli"]}

Four.meme AI Skill

Full-featured AI agent skill for interacting with Four.meme — a BSC meme token launchpad. Provides read-only market intelligence and write operations (token creation, trading, transfers, on-chain identity) via the fourmeme CLI.

User Agreement & Security Notice

English: By using this skill you agree that (1) all write operations require a funded BSC wallet and you are solely responsible for all transactions, (2) never share or paste your PRIVATE_KEY in chat — use .env files or platform-level secret management only, (3) this skill is provided AS-IS with no liability for financial losses.

繁體中文: 使用本技能即表示您同意：(1) 所有寫入操作需要已充值的 BSC 錢包，您對所有交易負全責；(2) 絕對不要在聊天中分享或貼上您的 PRIVATE_KEY——僅使用 .env 文件或平台級別的密碼管理；(3) 本技能按「現狀」提供，對財務損失不承擔任何責任。

When to Use

• User wants to create a meme token on BSC via Four.meme
• User wants to buy or sell tokens on Four.meme
• User asks for trending, newest, or graduated token rankings
• User needs a buy or sell quote before executing a trade
• User wants to send BNB or ERC-20 tokens to an address
• User wants to register an ERC-8004 agent identity NFT
• User asks about tax token mechanics (TaxToken fee splits)
• User wants to browse or search tokens on Four.meme
• User asks about bonding curve progress or graduation status

Tools

Tool	Description	Key Args
config	Platform config — raisedToken, contract addresses	—
create-instant	One-shot create: upload image + deploy in single command	--image, --name, --short-name, --desc, --label
create-api	Upload image + metadata; prepare token for launch	name, shortName, description, imagePath, taxType
create-chain	Launch a prepared token on-chain	tokenAddress
token-info	On-chain token info — version, price, offers	tokenAddress
token-list	Browse and filter tokens with pagination	orderBy, pageIndex, pageSize, tokenName, symbol, labels
token-get	Full token detail and trading info	tokenAddress
token-rankings	Rankings: Hot, 24h volume, newest, graduated, etc.	orderBy, barType
quote-buy	Estimate buy cost in BNB or tokens	tokenAddress, amountWei, fundsWei
quote-sell	Estimate sell proceeds	tokenAddress, amountWei
buy	Execute a token purchase	tokenAddress, fundsWei
sell	Execute a token sale	,

Installation

1. Install the CLI globally

pnpm add -g @four-meme/four-meme-ai@latest

Then use the fourmeme command.

2. Or install as a skill package

npx skills add four-meme-community/four-meme-ai

3. Configure private key and RPC

Create a .env file in the project directory:

PRIVATE_KEY=your_wallet_private_key
BSC_RPC_URL=https://bsc-dataseed.binance.org   # optional — defaults to public BSC RPC

The CLI loads environment variables from the current directory. On OpenClaw, set the apiKey to your private key in the Skill management page instead.

Security: Never paste your private key directly in chat. Always use .env files or platform-level secret management.

Platform Setup

OpenClaw

In the Skill page, find four-meme-ai and enable it for your agent/session.

Cursor / Claude Code / other editors with skills

After installing the repo or npm package, enable the four-meme-ai skill in the agent settings. The agent will call the fourmeme CLI automatically.

Kimi / OpenAI / other agents with terminal access

If the agent can run Bash, use fourmeme <command> or npx fourmeme <command>. Never paste your private key directly in chat.

Token Creation Flow

Option A — One-shot (create-instant)

fourmeme create-instant --image ./logo.png --name "My Token" --short-name "MTK" --desc "A fun meme token" --label Meme

Optional flags:

• --tax-token — enable TaxToken mode
• --tax-options — JSON config for tax split: '{"feeRate":5,"burnRate":20,"divideRate":30,"liquidityRate":30,"recipientRate":20}'
• --pre-sale — enable pre-sale mode
• --fee-plan — fee plan identifier

Option B — Two-step (create-api + create-chain)

1. Prepare token — upload image and metadata:

   fourmeme create-api --name "My Token" --shortName "MTK" --description "A fun meme token" --image ./logo.png --taxType 0
   

2. Launch on-chain — deploy the prepared token to BSC:

   fourmeme create-chain --tokenAddress 0x...
   

Tax Types

Tax Type	Fee Rate
0	No tax
1	1% fee
3	3% fee
5	5% fee
10	10% fee

Tax split: burnRate + divideRate + liquidityRate + recipientRate = 100%

Rankings

orderBy	Description
Hot	Trending tokens
TradingDesc	Top 24h volume (use barType: HOUR24)
Time	Newest tokens
ProgressDesc	Highest bonding curve progress
Graduated	Tokens that completed bonding and listed on PancakeSwap

Token Labels

Meme · AI · Defi · Games · Infra · De-Sci · Social · Depin · Charity · Others

Tax Token Info

When a token is a TaxToken, tax-info returns:

Field	Description
feeRate	1%, 3%, 5%, or 10%
burnRate	% of fee burned
divideRate	% of fee as dividends
liquidityRate	% of fee to liquidity
recipientRate	% of fee to recipient address
recipientAddress	Address receiving recipient share
minSharing	Min token balance for dividend eligibility

ERC-8004 Agent Identity

Use fourmeme 8004-register to mint an NFT for your agent wallet, giving on-chain identity to its activity. Query any address's 8004 balance with fourmeme 8004-balance --address 0x....

Agent Workflow

Use this discover → detail → quote → execute pattern for safe trading:

1. Discovery — find candidates:

   fourmeme token-rankings Hot              # trending tokens
   fourmeme token-list --orderBy Time       # newest tokens
   fourmeme token-list --labels AI,Meme     # filter by label
   fourmeme events <fromBlock> [toBlock]    # recent on-chain activity
   

2. Detail — inspect a specific token:

   fourmeme token-get <address>             # full REST detail
   fourmeme token-info <address>            # on-chain contract info
   

3. Quote — always fetch a quote before executing:

   fourmeme quote-buy --tokenAddress 0x... --fundsWei 10000000000000000
   fourmeme quote-sell --tokenAddress 0x... --amountWei 1000000000000000000
   

4. Execute — perform the trade:

   fourmeme buy --tokenAddress 0x... --fundsWei 10000000000000000
   fourmeme sell --tokenAddress 0x... --amountWei 1000000000000000000
   

Environment Variables

Required for write operations

Variable	Description
PRIVATE_KEY	Wallet private key for buy, sell, create-chain, send, 8004-register

Optional

Variable	Default	Description
BSC_RPC_URL	Public BSC RPC	Custom BSC RPC endpoint
CREATION_FEE_WEI	Platform default	Override token creation fee in wei
WEB_URL	—	Project website URL for token metadata
TWITTER_URL	—	Twitter/X URL for token metadata
TELEGRAM_URL	—	Telegram URL for token metadata
PRE_SALE	false	Enable pre-sale mode for token creation
FEE_PLAN	—	Fee plan identifier

ERC-8004

Variable	Description
8004_NFT_ADDRESS	ERC-8004 NFT contract address (primary)
EIP8004_NFT_ADDRESS	ERC-8004 NFT contract address (alias)

Example Prompts

• "Show me Four.meme hot rankings"
• "Quote buying 0.01 BNB of token 0xABC..."
• "Create a meme token named CoolDog with this image"
• "Sell all my tokens at address 0xDEF..."
• "Send 0.1 BNB to 0x123..."
• "Register my agent on ERC-8004"
• "Check the tax info for token 0xGHI..."

Architecture

AI Agent (SperaxOS / Cursor / Claude Code)
    │
    ▼
fourmeme CLI (@four-meme/four-meme-ai)
    │
    ├── Four.meme REST API (token data, rankings, quotes, create)
    │   └── four.meme/meme-api/
    │
    ├── BSC RPC (on-chain reads + write txns)
    │   └── BNB Smart Chain
    │
    └── ERC-8004 Contract (agent identity NFT)

Important Notes

• BSC only — Four.meme operates exclusively on BNB Smart Chain
• Only TokenManager V2 tokens are supported for trading
• Buy/sell quotes are estimates — slippage may apply on execution
• Write operations (buy, sell, create-chain, send, 8004-register) require a funded wallet via PRIVATE_KEY
• Token links: https://four.meme/token/{address}
• More intelligence and data tools are coming soon from the four-meme-community

Related Skills

• four-meme-tool — Read-only builtin tool variant (no CLI required)
• pancakeswap-tool — DEX where graduated tokens list
• erc8004-tool — General ERC-8004 identity tooling
• pump-fun-mcp-guide — Similar memecoin launchpad for Solana

Links

• npm: @four-meme/four-meme-ai
• GitHub: four-meme-community/four-meme-ai
• ClawHub: four-meme-ai skill page