io.github.PonzuTech/ponzu (MCP) Server

This MCP server provides ERC-20 token launchpad functionality on Ethereum. It supports deploying token systems, buying presales, swapping, and farming via AI agents, based on configurable protocol tooling. The server exposes 17 tools for documentation access, address lookup, pricing calculation, contract deployment, presale state reading, and presale purchase.

🛠️ Key Features

ERC-20 token launchpad on Ethereum
Deploy tokens, run presales, swap, and farm via AI agents
17 tools for protocol operations

🚀 Use Cases

Deploy a full token system in one transaction
Compute presale pricing curves from a target ETH raise
Read presale state (e.g., tokens available, launched)
Purchase presale tokens

⚡ Developer Benefits

ponzu_get_skill fetches full Ponzu documentation (SKILL.md)
ponzu_get_addresses returns protocol contract addresses for the configured network
ponzu_calc_pricing supports presale pricing calculations
ponzu_deploy automates deployment of a “9-contract token system”
ponzu_presale_buy enables presale purchases

⚠️ Limitations

Tool list details are partially shown; only a subset of all 17 tools is visible in the provided data.

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

Public RPC

Ethereum RPC endpoint

PONZU_NETWORK

mainnet

mainnet or sepolia

Claude Desktop / Claude Code

Add to your MCP config (~/.claude/config.json or Claude Desktop settings):

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"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

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.

Install

Configuration

Environment variables

PONZU_PRIVATE_KEYsecret

Private key for signing transactions (optional, enables write operations)

PONZU_RPC_URL

Ethereum RPC URL (defaults to public RPCs)

PONZU_NETWORK

Network to use: mainnet or sepolia (default: mainnet)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ponzu": {
      "command": "npx",
      "args": [
        "-y",
        "@ponzu_app/mcp@1.1.0"
      ],
      "env": {
        "PONZU_PRIVATE_KEY": "<YOUR_PONZU_PRIVATE_KEY>",
        "PONZU_RPC_URL": "<YOUR_PONZU_RPC_URL>",
        "PONZU_NETWORK": "<YOUR_PONZU_NETWORK>"
      }
    }
  }
}

io.github.PonzuTech/ponzu