tsunami-mcp

MCP server for Tsunami DEX and Sentry Launchpad on Ink (chain 57073).

Provides 28 tools for querying pools, swapping tokens, managing LP positions, launching meme tokens, and collecting fees — all via the Model Context Protocol.

Quick Start

npx tsunami-mcp

Claude Desktop / Claude Code

Add to your MCP config (.mcp.json or Claude Desktop settings):

{
  "mcpServers": {
    "tsunami": {
      "command": "npx",
      "args": ["tsunami-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

EVM_PRIVATE_KEY is only needed for write operations (swaps, launches, fee collection). Read-only tools work without it.

Tools

Tsunami DEX (Read)

| Tool | Description | |------|-------------| | tsunami_get_pool | Get pool address for token pair + fee tier | | tsunami_pool_info | Get pool state (price, tick, liquidity) | | tsunami_quote | Quote a swap (expected output, gas) | | tsunami_positions | Get LP position details by tokenId | | tsunami_tick_data | Get populated ticks for a pool | | tsunami_token_info | Get ERC20 token info + balance |

Tsunami DEX (Write)

| Tool | Description | |------|-------------| | tsunami_swap | Execute exact-input swap | | tsunami_swap_multi | Multi-hop swap | | tsunami_add_liquidity | Mint new LP position | | tsunami_remove_liquidity | Remove liquidity + collect | | tsunami_collect_fees | Collect LP trading fees | | tsunami_create_pool | Create + initialize pool |

Sentry Launchpad

| Tool | Description | |------|-------------| | sentry_launch | Launch a new meme token | | sentry_collect_fees | Collect fees (WETH → SENTRY buyback) | | sentry_collect_multiple_fees | Batch collect fees | | sentry_get_creator_nfts | Get creator's LP NFTs | | sentry_get_token_by_nft | Get token for LP NFT | | sentry_get_total_deployed | Total tokens deployed | | sentry_get_supported_base_tokens | Supported base tokens | | sentry_get_pool_manager | Pool manager for base token | | sentry_factory_info | Factory state |

Sentry Agent Launchpad

| Tool | Description | |------|-------------| | sentry_agent_launch | Launch agent token | | sentry_agent_collect_fees | Collect agent LP fees | | sentry_agent_collect_multiple_fees | Batch collect | | sentry_agent_get_creator_nfts | Get creator's agent NFTs | | sentry_agent_get_token_by_nft | Get agent token for NFT | | sentry_agent_get_total_deployed | Total agent tokens | | sentry_agent_factory_info | Agent factory state |

Contract Addresses (Ink Mainnet)

| Contract | Address | |----------|---------| | TsunamiV3Factory | 0xD8B0826150B7686D1F56d6F10E31E58e1BCF1193 | | TsunamiSwapRouter02 | 0x4415F2360bfD9B1bF55500Cb28fA41dF95CB2d2b | | TsunamiV3PositionManager | 0x98b6267DA27c5A21Bd6e3edfBC2DA6b0428Fa9F7 | | TsunamiQuoterV2 | 0x547D43a6F83A28720908537Aa25179ff8c6A6411 | | SentryLaunchFactory | 0xDc37e11B68052d1539fa23386eE58Ac444bf5BE1 | | SentryAgentLaunchFactory | 0x733733E8eAbB94832847AbF0E0EeD6031c3EB2E4 | | WETH | 0x4200000000000000000000000000000000000006 | | USDT0 | 0x0200C29006150606B650577BBE7B6248F58470c1 | | NAMI | 0x40f297b5a31FB7D28169Ba75666bea38122860c2 | | SENTRY | 0x94CfB34d41E94687cD8A56c0624AaA0c8080cd93 |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EVM_PRIVATE_KEY | For writes | Wallet private key | | RPC_URL | No | Custom RPC (default: https://rpc-gel.inkonchain.com) |

License

MIT