@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

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

ponzu

Quick Install