Tapp Exchange MCP Server

An MCP (Model Context Protocol) server implementation for Tapp Exchange, a next-generation decentralized exchange built on Aptos blockchain.

Overview

Tapp Exchange is a decentralized trading platform that brings together innovations from leading DEX protocols. Built on concepts from Uniswap v4, Tapp offers a powerful hooks system and advanced singleton vault design for unmatched capital efficiency.

This MCP server provides AI agents like Claude with the ability to interact with Tapp Exchange, enabling:

• Pool Management: Query available pools, get detailed pool information
• Trading Operations: Execute swaps on AMM, CLMM, and Stable pools
• Liquidity Management: Add/remove liquidity, create new pools
• Position Tracking: Monitor liquidity positions and collect fees

Features

Pool Types Supported

• AMM Pools: Traditional Automated Market Maker pools
• CLMM Pools: Concentrated Liquidity Market Maker pools (like Uniswap v3)
• Stable Pools: Optimized for stablecoin trading with low slippage

Core Functionality

• Pool discovery and analytics
• Multi-pool type swap execution
• Liquidity provision and management
• Fee collection from positions
• Position monitoring and analytics

Installation

npm install @tamago-labs/tapp-exchange-mcp

Configuration

Create a .env file in your project root:

# Network Configuration
TAPP_NETWORK=mainnet  # or testnet, devnet

# Optional: Custom RPC URL
# TAPP_RPC_URL=https://fullnode.mainnet.aptoslabs.com/v1

# Optional: Private Key (if not provided, a new random key will be generated)
# TAPP_PRIVATE_KEY=your_private_key_here

# Optional: API Configuration
# TAPP_API_TIMEOUT=30000

Usage

As an MCP Server

npx tapp-exchange-mcp

Integration with Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "tapp-exchange": {
      "command": "npx",
      "args": ["@tamago-labs/tapp-exchange-mcp"]
    }
  }
}

Programmatic Usage

import { TappAgent } from '@tamago-labs/tapp-exchange-mcp';

const agent = new TappAgent();

// Get available pools
const pools = await agent.getPools({
  page: 1,
  size: 10,
  sortBy: 'tvl'
});

// Execute a swap
const swapResult = await agent.swapAMM({
  poolId: 'pool_address',
  a2b: true,
  fixedAmountIn: true,
  amount0: 1000000,
  amount1: 0
});

Available Tools

Pool Management

• tapp_get_pools - Get paginated list of available pools
• tapp_get_pool_info - Get detailed information about a specific pool

Swap Operations

• tapp_get_swap_estimate - Estimate swap amounts and price impact
• tapp_get_swap_route - Get optimal route between two tokens
• tapp_swap_amm - Execute swap on AMM pool
• tapp_swap_clmm - Execute swap on CLMM pool
• tapp_swap_stable - Execute swap on Stable pool

Liquidity Management

• tapp_create_amm_pool_and_add_liquidity - Create new AMM pool with initial liquidity
• tapp_create_clmm_pool_and_add_liquidity - Create new CLMM pool with initial liquidity
• tapp_create_stable_pool_and_add_liquidity - Create new Stable pool with initial liquidity
• tapp_add_amm_liquidity - Add liquidity to existing AMM pool
• tapp_add_clmm_liquidity - Add liquidity to existing CLMM pool
• tapp_add_stable_liquidity - Add liquidity to existing Stable pool
• tapp_remove_single_amm_liquidity - Remove liquidity from single AMM position
• tapp_remove_multiple_amm_liquidity - Remove liquidity from multiple AMM positions
• tapp_remove_single_clmm_liquidity - Remove liquidity from single CLMM position
• tapp_remove_multiple_clmm_liquidity - Remove liquidity from multiple CLMM positions
• tapp_remove_single_stable_liquidity - Remove liquidity from single Stable position
• tapp_remove_multiple_stable_liquidity - Remove liquidity from multiple Stable positions

Position Management

• tapp_get_positions - Get user's liquidity positions
• tapp_collect_fee - Collect fees from liquidity positions

Testing

Run the included test scripts to verify functionality:

# Test pool operations
npm run test:pools

# Test swap operations
npm run test:swap

# Test liquidity operations
npm run test:liquidity

Development

Building

npm run build

Running Tests

npm test

Architecture

The MCP server is built with:

• TappAgent: Core agent class that interfaces with Tapp Exchange SDK
• MCP Tools: Individual tools for each exchange operation
• Type Safety: Full TypeScript support with comprehensive type definitions
• Error Handling: Robust error handling and validation
• Key Management: Automatic key format detection and validation

Key Features

Multi-Pool Support

• AMM: Traditional x*y=k pools
• CLMM: Concentrated liquidity with custom price ranges
• Stable: Stablecoin-optimized pools with low slippage

Advanced Liquidity Management

• Single and batch position management
• Automated fee collection
• Position analytics and monitoring

Safety Features

• Input validation and sanitization
• Transaction simulation before execution
• Slippage protection
• Gas estimation and optimization

Dependencies

• @aptos-labs/ts-sdk - Aptos blockchain SDK
• @tapp-exchange/sdk - Official Tapp Exchange SDK
• @modelcontextprotocol/sdk - MCP framework
• zod - Runtime type validation

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests for any improvements.

License

MIT License - see LICENSE file for details.

Links

• Tapp Exchange Documentation
• Tapp Exchange SDK
• Aptos Blockchain
• Model Context Protocol

Support

For questions and support:

• GitHub Issues: Create an issue
• Documentation: Tapp Exchange Docs