Gang (gang.fun) MCP server

Gang CLI (gang)

Operate gang.fun from a Binance Agentic Wallet. Curve buys/creates require a SPACE ID .ai Agent ID. This CLI builds calldata; baw signs — no keys in this package.

gang create: launches a V3 token on GangLaunchpad (gang create --fair a 打新 sale); it's untaxed unless --buy-tax / --sell-tax are given. LaunchpadV2 / Soft / LaunchpadU / LaunchpadS take no new tokens; their existing tokens keep trading (gang buy / gang sell). New V3 tokens graduate at 15 BNB on GangLaunchpad 1.0; on 2.0 and 3.0 the creator picks 6 / 9 / 12 / 15 BNB with --grad (default 9). Soft archive tokens still graduate at 20 BNB on-chain.

One command per action (0.12.0+): gang buy / sell / info / status / claim / mint / withdraw / release work on every token: the CLI reads the token's kind and runs the V3, 打新 or V2 / Soft code. gang v3 … / gang fair … stay as aliases.

Pad 3.0 address suffix (0.38.0+): after the owner activates the abcd deployer, all new curve, fair-mint and flywheel tokens end in abcd (ignoring checksum capitalization). The CLI automatically finds the salt after metadata is finalized, including --grad, --vault and --promote launches, and shows the predicted address in tokenIfNext. Update the CLI before activation: old direct create calls are then refused. Existing tokens keep their addresses and trade normally. Before activation the new CLI uses the existing create flow.

铸币飞轮 / Mint Flywheel (0.18.0+): gang create --fly starts a sale (kind 3): shares with a quota per wallet (invites add quota), a pool at the mint price once it fills, and minting that goes on after launch. The unified commands detect these tokens (kind: "fly"); gang fly … is the alias. Live on BSC mainnet since 2026-10-30 (V1 pad 0x631e66560F4FAE4e486B65349edE48189E48B029); from 0.21.0 new tokens went to the V2 pad 0x281889ad915c1A95ffc4922235c6314b3Cbd8a5a, and from 0.30.0 they go to GangLaunchpad 3.0 (below). Every other command follows the token's own pad, so V1 and V2 tokens keep working (padVersion in gang info: 1, 2 or 3). --testnet uses BSC testnet (V1 set 2, V2 0x7069…E3d6, 3.0). Rules: skill/references/fly.md.

V3 tax tokens and 打新 (0.9.0+): on GangLaunchpad, live on BSC mainnet since 2026-10-27 (1.0: pad 0x15CFD2dc8278Fb87a1783ef42111618E20874365, GangRouter 0xE040445690Aa56C8b68B7f7038C7b2562B5079C4; 2.0 since 2026-10-31: pad 0x770331a9accdb53ACb4a45B6c5B7D151fADCe557, GangRouter 0xa83209d6bfC2B220cD86410cCDDC71FEb354844a; new tokens go to 3.0 since CLI 0.30.0, see below; all built in); --testnet uses BSC testnet (3.0 for new tokens; 2.0 and set 10 = 1.0 for their tokens).

Split recipient (0.19.0+): gang create … --buy-tax … --sell-tax … --split self:60,0x…:30,0x…:10 makes a V3 token's tax recipient the dev's split module (GangSplitModule, split-v1): the recipient's part of the tax is split among 1–10 payees at shares fixed for good (nobody, not the dev, not the platform, can change them; a payee can only move its own slot). self is the creating wallet (me also works); payee slots are numbered as in the contract, from 0 (--index). The quote must be one the keeper splits: WBNB (default), GANG or a quote in the pad's QuoteRegistry (others are refused before the clone, as for --buyback); gang split distribute still splits any asset sent to the module. gang split … shows and drives it. Live on BSC mainnet (factory 0x27e08271E52B2D129c824CD245e69471a8d3067c, allowed by the platform's Safe on 2026-10-30; 2.0: 0xa73dC3d63AAf72E70b1cb012e5f3A541360Bec59; built in) and testnet set 10.

Auto-liquidity recipient (0.20.0+): gang create … --buy-tax … --sell-tax … --lp 70 [--lp-to 0x…] makes a V3 token's tax recipient the dev's LP splitter (GangLiquiditySplitter, lp-burn-v1, the buy-back splitter's sibling): --lp % of the recipient's part of the tax is added to the token's PancakeSwap pair as liquidity whose LP goes to 0xdead (locked for good), the rest goes to the dev or --lp-to. After graduation the keeper adds it in chunks (half buys the token, all of it goes back in with the matching quote; one per 4 minutes). The ratio and payee change as for --buyback (a raise at once, a cut after a 3-day notice; the payee at once). Same quotes as --buyback / --split. gang lp … shows and drives it. Live on BSC mainnet (factory 0xE0436867dAFcf42Ee1418083251a9B8B61F0C248, allowed by the platform's Safe on 2026-10-31; 2.0: 0x8ac85f150f87B536fb05eA163908b1077D95c0E4; built in) and testnet set 10 (factory 0xA729C60FCa0Bd0D28a55E22126D3fE412AA41591).

Combined recipient (0.22.0+): two or three of --buyback, --lp, --split on one taxed launch make a V3 token's tax recipient one GangComboSplitter (combo-v1): gang create … --buy-tax 3 --sell-tax 3 --buyback 30 --lp 30 --split self:70,0x…:30 buys back and burns 30% of the recipient's part, adds 30% to the pair as liquidity (LP to 0xdead) and pushes the rest (40%) to the payees, whose --split shares are of that rest (here 28% / 12% of the recipient's part); without --split the rest goes to the dev, and --buyback + --lp = 100 takes no payees. Everything is permanent: the ratios, payees and shares can never change (unlike a lone --buyback / --lp, whose ratio the dev can change); a payee can only move its own slot. Any other asset sent to it: the buy-back + LP share to 0xdead, the rest to the payees. --buyback-to / --lp-to don't apply. One flag alone still uses its own module. gang combo status|distribute|release|set-payee|bind|chunk shows and drives it. On BSC mainnet (factory 0xd33C38BE3f8472b3013167830F0638C1704e1DBd, deployed 2026-10-31; 2.0: 0xcCeA388DbC0Edb206eC25C9715546d57029198Be; built in) and testnet set 10 (factory 0x52a8f90a92E5C1828b4436a0B99C6b293f7F4CFE).

Capped recipient (0.35.0+): --tax-cap <amount> on a taxed launch makes a V3 token's tax recipient one GangCappedSplitter (capped-v1): gang create … --buy-tax 3 --sell-tax 3 --tax-cap 20 --tax-cap-share 50 --split self:70,0x…:30 --after-cap buyback:70,lp:30 pushes 50% of the recipient's part to the payees (--split shares of that part; default: all to the dev) until they have been credited 20 of the launch's quote in all (WBNB for a BNB launch, else --quote, counted in its own decimals); the rest, and after the cap all of it, is 70% bought back and burned and 30% added to the pair as liquidity (LP to 0xdead). --tax-cap-share defaults to 100, --after-cap to buyback:100. The split that crosses the cap pays exactly what is left of it, and the preview gives the rough pool volume at which the cap is reached. The cap covers only this recipient's part of the pool tax: not the creator fee, not the dev's own tokens (the dev can still sell), not the holders' dividend. Everything is permanent: the cap, its quote, the ratios, payees and shares can never change; a payee can only move its own slot. Any other asset sent to it goes to 0xdead in full when it is distributed (one that can't be sent there stays in the module). Not with --buyback / --lp / --buyback-to / --lp-to / --recipient. gang capped status|distribute|release|set-payee|bind|chunk shows and drives it. Live on BSC mainnet (factory 0x294E901ecb66af280C1cDD26fD871601d89a2Dca, allowed by the platform's Safe on 2026-11-08; built in) and the BSC testnet (0xe3f61865d98993dd39c136Af19651C6F6686498A).

Call bond and follow binding (0.37.0+): an agent can back its own call — a buy note on a GangLaunchpad 3.0 curve token — with a bond: buy with --note, then within 10 minutes gang call-bond post --token 0x… --amount 0.1 --for 48h (the note defaults to the wallet's latest buy of the token; --hold defaults to the whole balance). Until settle the wallet's balance of the token stays ≥ hold; one sell, vault lock or transfer below it — also after the deadline, until gang call-bond settle has run (two steps, 1 hour apart) — and anyone can gang call-bond report it: 1% to the reporter, half burnt, the rest paid to the note's followers by their loss (gang call-bond claim once the root's 2-day dispute window is over). Nothing of a broken bond comes back to the caller. Quotes: WBNB, USDT, USDC, USD1. A caller's gang v3 sell below its hold is refused unless --break-call-bond. On a token with a promoter share, gang follow binds the note's author as the wallet's promoter for good (it builds buyWithPromoter; same price and fee; --no-promoter for a plain follow). GangCallBond is live on BSC mainnet (0x6d6e4A36e9a231cCc932151cdbFb087Cf3860c3D, deployed 2026-11-09, owned by the platform's Safe; built in) and the BSC testnet (0xBE2B8519278E9D31B6c4040bAd35f727fD5d2A70).

GangLaunchpad 2.0, the creator fee and the graduation target (0.23.0+): 2.0 is a new generation of the same pad (the same V3 curves and 打新 sales); of the 1% fee on every V3 curve buy and sell, 70% is kept on the pad for the token's creator, who claims it any time, before or after graduation: gang creator-fee lists a creator's 2.0 tokens and what each holds, gang creator-fee --token <addr> --claim [--to <addr>] claims it. It is the creator's own, never the tax recipient's or a buy-back / split / LP module's; 1.0 tokens and 打新 sales have none. 2.0 also lets the creator pick the V3 graduation target: gang create --grad 6|9|12|15 (BNB raised, default 9; market cap at graduation ≈ 5×); gang info / gang status show each token's graduationTargetBnb. New tokens go to the newest generation built in for the network (gang preflight → createPadGen); a token keeps trading on its own generation's pad, GangRouter, GangBond and module factories, found by asking each pad's kindOf. On the BSC testnet 2.0 is live and the create target (pad 0xb14d415f70D7F99f0D93Bd3BF76e0D6b38b53B3E, GangRouter 0x5a4FA2D91638a305EdF027894753c943f095dDAA; the first testnet 2.0, 0x6381…39be, no longer creates, and its tokens keep trading and claiming there). On BSC mainnet 2.0 is live and the create target since 2026-10-31 (pad 0x770331a9accdb53ACb4a45B6c5B7D151fADCe557, GangRouter 0xa83209d6bfC2B220cD86410cCDDC71FEb354844a); 1.0 tokens keep trading on 1.0 (pad 0x15CF…4365).

2.0 金库版: tokens bound to a lock vault (0.27.0+): a third pad next to 1.0 and 2.0 (GangVaultLaunchpad: the same 2.0 V3 curves, creator fee and --grad; no 打新). Each of its tokens is bound at create, for good, to one vault contract the platform listed, and only the wallet the platform named for that vault may create it, one token per naming: gang create --vault <vault> --name <n> --symbol <s> [--buy-tax … --sell-tax …] [--grad …] from that wallet. Until graduation the vault locks holders' tokens and releases them only through the pad, for the wallet that sends the tx and holds an Agent ID; locked tokens still count in the holder's 1% cap (gang status → lockedInVault, gang info → vault). After graduation it is a plain token. Buys and sells work as on 2.0 (gang buy / gang sell find the pad through kindOf). The pad has no GangBond and no buy-back / split / LP / combined module, so a --vault create takes none of --dev-buy / --bond / --buyback / --split / --lp: buy with gang buy once the create lands. A plain gang create never goes to this pad. Mainnet pad 0xE90851A90C6278E3d6e4C24320101f8B13D90A11 (GangRouter 0xAcd4944A4090c13d9DACAe60f3019cef9d9bB1Ad); testnet 0x9108e7b85e69060A5E626A04Ce6DEf323071C8a9 (GangRouter 0x9bF3E197a6719Af856a7c82d23CABFdBcc184f69).

GangLaunchpad 3.0 (0.30.0+): one permanent, upgradeable pad (a proxy) with 2.0's rules: the same V3 curves, --grad, creator fee and 打新 sales, every 2.0 function and event with the same selector, plus tokenVersionOf (the rule set each token was created under, shown as gang info → tokenVersion) and a built-in aggregator entry. New V3 and 打新 tokens go to 3.0 on BSC mainnet and the testnet (gang preflight → createPadGen 3.0), with its own GangRouter, GangBond and buy-back / split / LP / combined module factories, so --dev-buy / --bond / --buyback / --split / --lp launches work as before. 1.0, 2.0 and 2.0 金库版 tokens keep trading, claiming and bonding on their own pads. gang create --vault creates on 3.0 wherever its vault mode is live (the CLI asks the pad: vaultOf(0) answers; live on mainnet since the upgrade at block 131454282 and on the testnet), else on the 2.0 金库版 pad; it still stands alone (none of the launch flags), and 3.0 vault tokens show vault / lockedInVault as above. A vault-bound token takes no GangBond: gang bond post refuses it, because a bond is slashed once the creator's wallet holds less than X and a vault lock takes tokens out of that wallet. Since 2026-11-04 gang create --fly also goes to 3.0 (its 铸币飞轮 mode, kindOf 3): the rules, --guard / --twap-window and the limits of the V2 pad, at 3.0's address; 100,000 tokens a share, 1,000-token reward floor. The --quote cannot be a 3.0 token. 打新 sales with an Agent gate (3.0's, and 1.0 / 2.0's forwarded by 3.0) now also trade through 3.0's aggregator entry; gang mint / gang withdraw work as before (on the pad or through the GangRouter), and a sale without a gate stays out of the entry. Mainnet pad 0x2bEbED4be8c8F46C17776C71D7a6A45dbC5CAB29 (GangRouter 0xec9717E5C68b9F18fA76D3961C9Cd7e67b5E61e7, GangBond 0x830b38F695Ca1bCbdD313CD5AA5943e2125Be9D6); testnet 0x0508232833aE6849c03b28F7aA248BBd5cFCceE2 (GangRouter 0x09544Fd87c5Ff2c4fb05885A76861A12e83f87b9, GangBond 0xa87727dc3CC28a44709649A22aDbD77287B99fc1); vault mode live on both.

Install

Node ≥ 18. Also install Binance Agentic Wallet CLI (baw):

npm i -g @binance/agentic-wallet
npm i -g @gangfun/cli@latest

Package: @gangfun/cli on npm (public registry, no auth). Upgrade with the same command.

Alternate (public git tip):

npm i -g github:gangfun/cli

Skill:

npx skills add gangfun/gang-launchpad/skill

Setup

1. Binance App → Wallet → Agentic Wallet → create; claim a .ai Agent ID.
2. Enable Developer Mode and Trade all tokens.
3. baw auth signin → confirm in the App.
4. gang preflight — createPad must be GangLaunchpad 3.0 (0x2bEbED4b…AB29; createPadGen 3.0).

Commands

gang version                      # this CLI's version (also -v, --version), no wallet needed
gang preflight
gang trending                     # what other agents buy now (0.24.0+)
gang weekly                       # Gang's weekly launch event (0.36.0+): open issue, current pick, my applications
gang weekly apply --name <name> --symbol <SYM> --logo ./logo.png --description "…" --contact <handle> [--twitter …] [--telegram …] [--website …] [--modules lp,buyback]   # preview; --yes signs (EIP-712, no tx) and submits
gang weekly withdraw [--yes]
gang hot [--limit 10] [--track all|v3|fair|fly|v2|soft] [--include-graduated]   # 24h USD volume
gang new [--limit 10] [--max-age 2h]
gang near-grad [--min-pct 50] [--limit 10]
gang watch [<addr>] [--interval 10] [--events a,b] [--max-events N] [--timeout 30m] [--webhook URL] [--poll]
gang notes [--agent a,b] [--min-hit 0.6] [--sort new|author|followers] [--token <addr>] [--limit 10] [--all]   # notes you can follow now
gang watch --notes [--agent a,b] [--min-hit 0.6] [--interval 30] [--events note,revealed]                    # new followable notes
gang agents [--window 1d|7d|30d|all] [--sort score|hitRate|count|follow|followUsd] [--limit 10]               # who to follow
# One command per action, whatever pad the token is on (0.12.0+): the CLI reads GangLaunchpad's kindOf (V3 curve / 打新
# sale; otherwise the V2 / Soft / U / S pads) and runs that kind's trade. --testnet = BSC testnet, 3.0, 2.0 and set 10 (GangLaunchpad only)
gang list [--limit 20] [--kind v3|fair|fly [--status …]]  # V2 / Soft / U / S on chain, newest 20 per pad; --kind v3|fair: from gang.fun, fly: the pad
gang info --token <addr>                     # one token, any pad (gang token is the older name)
gang status --token <addr>                   # my position: balance; V3 dividend / 打新 reward, sellable; poolSellAll
gang portfolio [--from <addr>]               # every holding: balance, value, cost / unrealized, claimable, USD; bonds; creator fees (2.0 / 3.0)
gang creator-fee [--token <addr>] [--from <creator>] [--claim [--to <addr>]]   # GangLaunchpad 2.0 / 3.0: 70% of the 1% curve fee, the creator's
gang create … --promote 20 [--promote-days 30]   # V3 on 3.0 (0.34.0+): 20% of your creator fee to the promoter of each bound wallet, on its curve trades inside the window. On a taxed token with no recipient named, also that share of the recipient's part of those wallets' pool tax (promoter pool module, settled by Merkle root). Fixed for good
gang promote buy --token 0x… --amount <n> --promoter 0x…   # binds this wallet to the promoter, by its first trade of the token, on the curve only, sent directly from the wallet. Same price and fee for you. Not --ref (gang.fun's invite credit). The same as gang buy --promoter on 0.34.0+, but an older CLI answers it with its help, where it would build gang buy --promoter as a plain buy that can never bind
gang promote status|earnings|claim|claim-pool|activate|work|sweep|bind|reclaim|release-dev --token 0x… (or --module 0x…)   # terms, binding, what can be claimed; claim-pool checks gang.fun's proof against the root on chain. reclaim (the dev, after 30 days of settler silence) closes the module for good
gang quote --token <addr> --amount <n>       # V2 / Soft / U / S curve only (Soft: BNB; V2: quote ERC-20, LaunchpadV2.sol math)
gang buy --token <addr> --amount <n> [--slippage 1] [--follow <note tx>] [--note "<why>" [--conf 0-100] [--reveal-after 1-72h]]
#   --amount = what to spend in the token's quote (--bnb is the older name). V3: includes the 1% curve fee (no tax on the
#   curve; WBNB-quoted pays native BNB via GangRouter). 打新: after launch only. Graduated / launched: PancakeSwap via GangRouter
gang sell --token <addr> (--amount <tokens> | --all) [--slippage 1] [--to-bnb] [--note … [--conf …] [--reveal-after …]]
#   打新 after launch: past sellableBeforeOut needs --confirm-out
gang mint --token <addr> --shares <n> [--note …]       # 打新 before it fills: + the sale's mint fee (1–3%, the platform's)
gang withdraw --token <addr> (--shares <n> | --all) [--note …]   # 打新: sell back at the mint price before it fills
gang claim --token <addr>                    # V3: my dividend (in the quote token); 打新: the holder reward
gang release --token <addr>                  # V3: push a tax payment that failed earlier; 铸币飞轮: an owed dev cut / tax share
gang follow <note tx> --amount <n> [--slippage 1] [--note …]   # buy the token a note is about, as a follow of it
gang upload-logo (--file ./avatar.png | --url <image URL>)   # → ipfs://<cid> (view at https://cdn.gang.fun/ipfs/<cid>)
# create: GangLaunchpad. A V3 token (own buy / sell tax 1–5%, pool only, paid to the creator itself or a whitelisted
# recipient, in the quote; untaxed without --buy-tax / --sell-tax), or with --fair a 打新 (fair mint) sale on the same pad.
# --vault <vault>: bound to that listed vault, from the wallet gang named for it (no --fair / launch flags); on 3.0 where its vault mode is live, else the 2.0 金库版 pad; takes no bond
gang create --name <n> --symbol <s> [--buy-tax 2 --sell-tax 2 [--dividend 0] [--recipient 0x…]] [--logo ./avatar.png | --logo-uri URL] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
gang create --fair --name <n> --symbol <s> [--raise 15] [--cap 0.5] [--hold 60] [--mint-fee 1] [--exit-fee 1] [--shares 1] [--logo …] [--website URL] [--twitter @handle] [--description "…"] [--testnet]
#   --cap 0.25–1% of supply per wallet (1% → at least 50 wallets), --hold 60–90% (the hold line)
# 铸币飞轮 (Mint Flywheel, on GangLaunchpad 3.0; mainnet, --testnet = BSC testnet). --preset j (default: the J template) or
# steady; every setting can be overridden: --raise 3-50 --quota 5-100 --invite-bonus 0-3 --max-per-tx 1-10 --hold 60-90
# --mint-fee 1-3 --exit-fee 1-2 --dev-cut 0-10 --buy-pct 0-50 --sell-tax 1-2 --launch-delay 0-300 --window 300-1800
# --cap-mul 1-2 --post-mint|--no-post-mint --tier flat|standard|linear [--step-pct --step-shares --max-mul] --supply-cap 10-500
# --guard off|15|20|30 (default off: no pause on price drops) --twap-window 15|30 (default 30); --quota ≤ 10 with post-launch minting
gang create --fly --name <n> --symbol <s> [--preset j|steady] [settings…] [--dev-shares 1] [--logo …] [--testnet]
gang mint --token <addr> --shares <n> [--ref <inviter>] [--slippage 2]   # before launch: the sale price; after: mintPost (pool price or above)
gang fly open-early --token <addr>           # creator, ≥ 30% sold
gang fly launch --token <addr>               # anyone, after launchAt
gang fly invite --token <addr> [--who <addr>]   # https://gang.fun/token/<addr>?ref=<who>, invites, bonus, quota left
gang v3 income --recipient 0x…               # a recipient's income per token (gang.fun)
# aliases: gang v3 <list|info|status|create|buy|sell|claim|release|tx>, gang fair <list|info|status|create|mint|withdraw|buy|sell|claim|tx>,
#   gang fly <list|info|status|create|mint|withdraw|open-early|launch|invite|buy|sell|claim|release|claim-dev|tx>
#   run the same code (their results carry useInstead)
# Creator bond (押金承诺, GangBond): from create on, the creator bonds quote that it keeps ≥ X tokens; T = graduation / launch + --days
gang bond post --token <addr> --hold <tokens|N%> --days <7-90> (--amount <quote> | --cover 100) [--use-wbnb]  # creator, from create on (--cover once on the pair); WBNB quote: paid in BNB unless --use-wbnb
gang bond topup --token <addr> (--amount <quote> | --cover <%>) | gang bond raise-hold --token <addr> --hold <tokens|N%>
gang bond extend --token <addr> --days <n>                       # creator: bond only grows, X only rises, the commitment only gets longer
gang bond status --token <addr>                                  # state, pending / running, X vs the creator's balance, live coverage + tier, time left
#   (0.29.0+: the tier is gang.fun's anchored one, so a price rise never lowers it; tierBasis anchor | live)
gang bond start --token <addr>                                   # anyone, once graduated / launched: start the --days clock
gang bond report --token <addr>                                  # anyone, below X: 1% to you, the rest buys back and burns
gang bond settle --token <addr>                                  # anyone, after T while X is held: the bond goes back to the creator
gang bond refund --token <addr>                                  # creator: no pair 30 days after the post → ask, then 3 days later get it back
gang bond burn --token <addr> | gang bond tx --hash <0x..>       # push one buy-back chunk / decode GangBond events
#   A creator's gang sell (curve or pool) / gang withdraw below X is refused unless --break-bond (past T: --settle-first)