Skip to main content
Glama

@ponzu_app/mcp

MCP server for Ponzu — deploy tokens, buy presales, swap, and farm on Ethereum via AI agents.

Tools (17)

Tool

Description

ponzu_get_skill

Fetch full Ponzu documentation (SKILL.md)

ponzu_get_addresses

Get protocol contract addresses for configured network

ponzu_calc_pricing

Calculate presale pricing curve from target ETH raise

ponzu_deploy

Deploy full 9-contract token system in one transaction

ponzu_get_presale_info

Read presale state (tokens available, launched, etc.)

ponzu_presale_buy

Buy tokens in a presale

ponzu_presale_refund

Refund presale tokens (20% penalty)

ponzu_trigger_launch

Trigger DEX launch when presale sells out

ponzu_claim_tokens

Claim vested tokens from presale

ponzu_claim_eth

Claim ETH rewards from presale

ponzu_swap_eth_for_tokens

Buy tokens on PonzuSwap DEX

ponzu_swap_tokens_for_eth

Sell tokens on PonzuSwap DEX

ponzu_zap_eth

Convert ETH into LP tokens in one transaction

ponzu_farm_stake

Stake LP tokens in a farm

ponzu_farm_unstake

Unstake LP tokens (burns LiquidityCard NFT)

ponzu_farm_claim

Claim primary token rewards from farm

ponzu_farm_claim_eth

Claim WETH rewards from farm

Related MCP server: VetAgent

Configuration

Environment Variables

Variable

Required

Default

Description

PONZU_PRIVATE_KEY

For write ops

—

Hex private key for signing transactions

PONZU_RPC_URL

No

Public RPC

Ethereum RPC endpoint

PONZU_NETWORK

No

mainnet

mainnet or sepolia

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 tsx

Available Tools

17 tools
ponzu_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

    A4/5.0

    Scored across 17 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      B
      maintenance
      Drafts 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
      -
    • A
      license
      A
      quality
      B
      maintenance
      Pre-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.
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables launching tokens on pump.fun and StonkFun with user-signed transactions, plus a disclosed two-sided quoter for market making.
      MIT