# base-token-sniper-mcp

An MCP server for AI agents to discover and trade new token launches on Base chain.

## Install

```bash
npx -y base-token-sniper-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `watch_launches` | Get recent LaunchPad token deploys (newest first) |
| `snipe_buy` | Buy a token with ETH via PlatformRouter (0.5% platform fee) |
| `multi_quote` | Get buy quotes for multiple tokens at once |
| `get_token_safety` | Check token safety metrics (liquidity, burn, fees, age) |
| `get_launch_feed` | Live feed of launches since a given timestamp |

## Setup

Add to your MCP client config (Claude Code, Cursor, etc.):

```json
{
  "mcpServers": {
    "base-token-sniper": {
      "command": "npx",
      "args": ["-y", "base-token-sniper-mcp"],
      "env": {
        "DEPLOYER_PRIVATE_KEY": "your-private-key-for-trading"
      }
    }
  }
}
```

`DEPLOYER_PRIVATE_KEY` is only needed for `snipe_buy`. All read tools work without it.

## How It Works

This server connects to the OBSD LaunchPad on Base mainnet. New tokens are deployed with Aerodrome liquidity pools, progressive sell taxes, and built-in burn mechanics. Trading goes through the PlatformRouter which charges a 0.5% ETH fee.

**For agents**: Poll `get_launch_feed` to discover new tokens, check `get_token_safety` for risk assessment, use `multi_quote` to compare opportunities, and `snipe_buy` to execute.

## Chain

- **Network**: Base mainnet (chainId 8453)
- **Contracts**: LaunchPad, PlatformRouter, OBSD token — all verified on Basescan

## License

MIT