io.github.PonzuTech/ponzu
ERC-20 token launchpad on Ethereum — deploy, presale, swap, and farm via AI agents
Open source Open in the app JSON README (API)
About
ERC-20 token launchpad on Ethereum — deploy, presale, swap, and farm via AI agents
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- ponzutech
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.0
- Last push
- 2026-03-18T17:55:22Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:10
- Updated
- 2026-08-29 03:02:10
- Origin id
io.github.PonzuTech/ponzu
README
# @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):
```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.
## Development
```bash
yarn install
yarn build # compiles TypeScript
yarn dev # watch mode via tsx
```