Skip to main content
Glama

Tapp Exchange MCP Server

by tamago-labs
npmGitHub
TypeScript
2
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

Support

For questions and support:

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

Tools

View all tools

Enables AI agents to interact with Tapp Exchange, a decentralized exchange on Aptos blockchain. Supports pool management, trading operations across AMM/CLMM/Stable pools, liquidity provision, and position tracking through natural language.

  1. Overview
    1. Features
      1. Pool Types Supported
      2. Core Functionality
    2. Installation
      1. Configuration
        1. Usage
          1. As an MCP Server
          2. Integration with Claude Desktop
          3. Programmatic Usage
        2. Available Tools
          1. Pool Management
          2. Swap Operations
          3. Liquidity Management
          4. Position Management
        3. Testing
          1. Development
            1. Building
            2. Running Tests
          2. Architecture
            1. Key Features
              1. Multi-Pool Support
              2. Advanced Liquidity Management
              3. Safety Features
            2. Dependencies
              1. Contributing
                1. License
                  1. Links
                    1. Support

                      Related MCP Servers

                      • Armor Crypto MCPofficial

                        armorwallet
                        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
                        189
                        GPL 3.0
                        • Apple
                        • Linux

                      • Alpaca MCP Server

                        jwaresolutions
                        -
                        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

                      • Aptos Blockchain MCP

                        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.

                      • Aptos Blockchain MCP

                        punkpeye
                        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

                      New 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