Skip to main content
Glama

Tapp Exchange MCP Server

by tamago-labs

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.

Support

For questions and support:

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
    Last updated -
    37
    190
    GPL 3.0
    • Apple
    • Linux
  • -
    security
    A
    license
    -
    quality
    Provides tools for interacting with the Alpaca Trading API, enabling trading operations like getting account information, placing/canceling orders, listing positions, and accessing market data.
    Last updated -
    MIT License
    • Apple
  • A
    security
    A
    license
    A
    quality
    Integrates Aptos blockchain access into AI applications, enabling interaction with tools for native APT operations, custom coin management, and transaction handling.
    Last updated -
    12
    MIT License
  • A
    security
    A
    license
    A
    quality
    Integrates Aptos blockchain access into AI applications, enabling interaction with tools for native APT operations, custom coin management, and transaction handling.
    Last updated -
    12
    MIT License

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tamago-labs/tapp-exchange-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server