mcpField
P
ponzu

ponzu

Local
github.com/PonzuTechFinance0Updated 32w ago
Repository

About ponzu

ponzu is an MCP server for operating Ponzu's Ethereum token launchpad through AI agents. Its tools cover token deployment, presales, swaps, liquidity conversion, and farming; read-only tools are available without a private key.

Key features

  1. 01Deploy a nine-contract token system
  2. 02Inspect presales and calculate pricing
  3. 03Buy, refund, and claim presale tokens
  4. 04Swap ETH and tokens on PonzuSwap
  5. 05Convert ETH to LP tokens and farm

Use cases

  1. 01Deploy a token system on Ethereum
  2. 02Review pricing and presale status
  3. 03Participate in presales and claim tokens
  4. 04Stake LP tokens and claim farm rewards

MCP support

The MCP server exposes 17 Ponzu tools for Ethereum launchpad, presale, swap, and farm operations. Without PONZU_PRIVATE_KEY, only read-only tools are available.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ponzutech-ponzu": {
      "command": "npx",
      "args": [
        "-y",
        "@ponzu_app/mcp"
      ],
      "env": {
        "PONZU_PRIVATE_KEY": "<PONZU_PRIVATE_KEY>",
        "PONZU_RPC_URL": "<PONZU_RPC_URL>",
        "PONZU_NETWORK": "<PONZU_NETWORK>"
      }
    }
  }
}
Run commandnpx -y @ponzu_app/mcp
Environment variables to set
PONZU_PRIVATE_KEYSecretPrivate key for signing transactions (optional, enables write operations)
PONZU_RPC_URLEthereum RPC URL (defaults to public RPCs)
PONZU_NETWORKNetwork to use: mainnet or sepolia (default: mainnet)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@ponzu_app/mcp1.1.0

Tools

17

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

@ponzu_app/mcp

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

Tools (17)

ToolDescription
ponzu_get_skillFetch full Ponzu documentation (SKILL.md)
ponzu_get_addressesGet protocol contract addresses for configured network
ponzu_calc_pricingCalculate presale pricing curve from target ETH raise
ponzu_deployDeploy full 9-contract token system in one transaction
ponzu_get_presale_infoRead presale state (tokens available, launched, etc.)
ponzu_presale_buyBuy tokens in a presale
ponzu_presale_refundRefund presale tokens (20% penalty)
ponzu_trigger_launchTrigger DEX launch when presale sells out
ponzu_claim_tokensClaim vested tokens from presale
ponzu_claim_ethClaim ETH rewards from presale
ponzu_swap_eth_for_tokensBuy tokens on PonzuSwap DEX
ponzu_swap_tokens_for_ethSell tokens on PonzuSwap DEX
ponzu_zap_ethConvert ETH into LP tokens in one transaction
ponzu_farm_stakeStake LP tokens in a farm
ponzu_farm_unstakeUnstake LP tokens (burns LiquidityCard NFT)
ponzu_farm_claimClaim primary token rewards from farm
ponzu_farm_claim_ethClaim WETH rewards from farm

Configuration

Environment Variables
VariableRequiredDefaultDescription
PONZU_PRIVATE_KEYFor write ops—Hex private key for signing transactions
PONZU_RPC_URLNoPublic RPCEthereum RPC endpoint
PONZU_NETWORKNomainnetmainnet 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.