io.github.PonzuTech/ponzu MCP Server

The MCP server for Ponzu automates Ethereum-based token operations, enabling deploying ERC-20 tokens, presale participation, swapping, and farming via AI agents. It exposes tools to manage contracts, pricing, and presale state, connecting developers with an AI-assisted workflow.

🛠️ Key Features

Deploys a full 9-contract token system in one transaction
Deploy, presale buy, swap, and farm capabilities through AI agents
Read presale information such as availability and launch status
Fetch Ponzu documentation and protocol addresses
Calculate presale pricing curves from target ETH raises

🚀 Use Cases

Create and launch new ERC-20 tokens on Ethereum
Conduct presales with automated pricing and participation
Enable token swaps and liquidity farming via AI-assisted processes

⚡ Developer Benefits

Centralized MCP tools for deployment, presales, pricing, and state reads
Clear access to contract addresses and documentation
Streamlined, atomic deployment of multi-contract systems

⚠️ Limitations

Data and capabilities are tied to configured networks and tool availability
Requires accurate target ETH raises for presale pricing calculations
Behavior depends on the underlying PoNzu ecosystem and AI agent integration

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