token-launcher
Enables AI agents to interact with the Ethereum blockchain to deploy 9-contract token systems, participate in token presales, perform swaps on PonzuSwap DEX, and manage liquidity farming through staking and reward claiming.
@ponzu_app/mcp
MCP server for Ponzu — deploy tokens, buy presales, swap, and farm on Ethereum via AI agents.
Tools (17)
Tool | Description |
| Fetch full Ponzu documentation (SKILL.md) |
| Get protocol contract addresses for configured network |
| Calculate presale pricing curve from target ETH raise |
| Deploy full 9-contract token system in one transaction |
| Read presale state (tokens available, launched, etc.) |
| Buy tokens in a presale |
| Refund presale tokens (20% penalty) |
| Trigger DEX launch when presale sells out |
| Claim vested tokens from presale |
| Claim ETH rewards from presale |
| Buy tokens on PonzuSwap DEX |
| Sell tokens on PonzuSwap DEX |
| Convert ETH into LP tokens in one transaction |
| Stake LP tokens in a farm |
| Unstake LP tokens (burns LiquidityCard NFT) |
| Claim primary token rewards from farm |
| Claim WETH rewards from farm |
Related MCP server: VetAgent
Configuration
Environment Variables
Variable | Required | Default | Description |
| For write ops | — | Hex private key for signing transactions |
| No | Public RPC | Ethereum RPC endpoint |
| No |
|
|
Claude Desktop / Claude Code
Add to your MCP config (~/.claude/config.json or Claude Desktop settings):
{
"mcpServers": {
"ponzu": {
"command": "npx",
"args": ["-y", "@ponzu_app/mcp"],
"env": {
"PONZU_PRIVATE_KEY": "0x...",
"PONZU_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
"PONZU_NETWORK": "mainnet"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"ponzu": {
"command": "npx",
"args": ["-y", "@ponzu_app/mcp"],
"env": {
"PONZU_PRIVATE_KEY": "0x...",
"PONZU_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
"PONZU_NETWORK": "mainnet"
}
}
}
}Read-Only Mode
Omit PONZU_PRIVATE_KEY to use read-only tools (ponzu_get_skill, ponzu_get_addresses, ponzu_calc_pricing, ponzu_get_presale_info). Write operations will return a clear error asking for the key.
Development
yarn install
yarn build # compiles TypeScript
yarn dev # watch mode via tsxAvailable Tools
17 toolsponzu_calc_pricingA
Calculate the linear pricing curve for a Ponzu presale given a target ETH raise. Returns start price, end price (10x start), and encoded pricing data. Formula: 690,000 tokens sold on a linear curve. Minimum raise: 3 ETH mainnet, 0.1 ETH sepolia.
Inputs: targetEthRaise (required).
ponzu_claim_ethA
Claim ETH rewards from a Ponzu presale. Repeatable — can be called multiple times as more ETH flows into the presale from the Distributor.
Inputs: tokenId (required), presaleAddress (required).
ponzu_claim_tokensA
Claim vested tokens from a Ponzu presale. One-time claim per PonzuBottle NFT. If claimed before vesting completes (10 days), unvested portion goes to Distributor. Burns the PonzuBottle NFT.
Inputs: tokenId (required), presaleAddress (required).
ponzu_deployA
Deploy a full Ponzu token system — 9 contracts in one transaction: ERC-20 token, presale, launcher, distributor, farm, project, operator, PonzuBottle NFT, and LiquidityCard NFT. Cost: 0.005 ETH creation fee + optional initial buy. Presale opens immediately after deployment.
Inputs: imageURI (required), metadata (required), tokenName (required), tokenSymbol (required), +2 more.
ponzu_farm_claimA
Claim primary token rewards from a Ponzu farm. One-time claim per LiquidityCard. After claiming, no further token or ETH claims are possible for this card.
Inputs: cardId (required), farmAddress (required).
ponzu_farm_claim_ethA
Claim WETH rewards from a Ponzu farm. Repeatable — call as rewards accumulate. Cannot claim after primary token claim.
Inputs: cardId (required), farmAddress (required).
ponzu_farm_stakeA
Stake LP tokens in a Ponzu farm. Mints a LiquidityCard NFT on first stake. Requires LP token approval first (handled automatically). Early unstake (<7 days) incurs penalty up to 100% LP.
Inputs: lpAmount (required), farmAddress (required).
ponzu_farm_unstakeA
Unstake LP tokens from a Ponzu farm. Full withdrawal only — burns the LiquidityCard NFT. If staked <7 days, early exit penalty applies (up to 100% LP forfeiture). Half of penalty boosts remaining stakers.
Inputs: cardId (required), farmAddress (required).
ponzu_get_addressesA
Get all deployed Ponzu protocol contract addresses for the configured network. Returns factory, DEX, router, zap, WETH, and other protocol addresses.
Inputs: no named parameters.
ponzu_get_presale_infoA
Read the current state of a Ponzu presale contract. Returns tokens available, whether launched, launch time, total sold, and total purchases.
Inputs: presaleAddress (required).
ponzu_get_skillA
Fetch the complete Ponzu skill documentation. Returns the full SKILL.md with instructions for deploying tokens, buying presales, swapping, farming, and all contract interactions. Use this first to understand how Ponzu works.
Inputs: no named parameters.
ponzu_presale_buyB
Buy tokens in a Ponzu presale. Sends ETH and receives tokens at the current price on the linear curve. 4% fee: 1% creator, 1% protocol, 1% platform referrer, 1% order referrer.
Inputs: ethAmount (required), presaleAddress (required), minTokens.
ponzu_presale_refundA
Refund tokens from a Ponzu presale. Available before launch only. 20% token penalty (stays in presale as pro-rata bonus for holders). 80% of proportional ETH returned.
Inputs: tokenAmount (required), presaleAddress (required).
ponzu_swap_eth_for_tokensA
Buy tokens on PonzuSwap DEX by swapping ETH. 1% swap fee (20% in first hour after launch, decaying linearly). Uses PonzuRouter.swapExactETHForTokens.
Inputs: ethAmount (required), tokenAddress (required), slippage.
ponzu_swap_tokens_for_ethA
Sell tokens on PonzuSwap DEX for ETH. Requires token approval first (handled automatically). Uses PonzuRouter.swapExactTokensForETH.
Inputs: tokenAmount (required), tokenAddress (required), slippage.
ponzu_trigger_launchA
Trigger DEX launch for a Ponzu presale that has sold out. Creates the PonzuSwap liquidity pool with all raised ETH + 310,000 tokens. Anyone can call this once presale is sold out.
Inputs: presaleAddress (required).
ponzu_zap_ethA
Convert ETH into LP tokens in one transaction. Splits ETH 50/50 — half buys tokens, half pairs with ETH to create LP. Uses ZapEth contract.
Inputs: ethAmount (required), tokenAddress (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool has a distinct purpose with clear naming ('ponzu_' prefix followed by specific action and target). The slight overlap between presale and farm ETH claims is mitigated by explicit descriptions differentiating claim sources.
All tools follow a consistent 'ponzu_<action>_<target>' pattern in snake_case, with no mixing of styles. Verbs are descriptive (e.g., 'deploy', 'claim', 'stake'), making the set predictable.
With 17 tools, the count is slightly above the ideal 3–15 range, but each tool covers a necessary function across presale, farming, swapping, and protocol info. The scope justifies the number.
The tool surface covers the full lifecycle: deploy, presale management, DEX launch, farming (stake/unstake/claim rewards), swapping, zapping, and protocol info. No obvious gaps for the intended token ecosystem.
Maintenance
Related MCP Connectors
Unsigned Pump/Bags/Zora/Clanker launches. mintPubkey required. Fees lock at launch.
Launch pump.fun tokens whose fees pay callers in USDC. Find paying pools, register calls, claim.
Create, launch and rug-check Solana SPL tokens over x402. Non-custodial, no keys handed over.
Prepare pump.fun token launches from your AI agent. You review and sign each one in your own wallet.
Related MCP Servers
- FlicenseAqualityBmaintenanceDrafts and deploys a coin from your repo to pump.fun's bonding curve on Solana, with local key management and fee recycling into an agent budget.7-
- AlicenseAqualityBmaintenancePre-trade token safety check for AI agents. Simulates a sell before you buy, then reports honeypot, tax, liquidity, pair age, same-ticker impersonation and owner powers as one low/medium/high/unknown verdict. Fail-closed: when a critical check cannot run it answers unknown rather than guessing low. Publishes its own measured error rate with the benchmark harness in the repo.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables launching tokens on pump.fun and StonkFun with user-signed transactions, plus a disclosed two-sided quoter for market making.MIT
- AlicenseAqualityBmaintenanceInstitutional pre-trade honeypot simulation, buy/sell tax verifier, and liquidity lock proofs on Base and Solana.32MIT