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:

GitHub Issues: Create an issue
Documentation: Tapp Exchange Docs

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

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.

Related MCP Servers

uniswap-trader-mcp
kukapay
-
security
A
license
-
quality
An MCP server for AI agents to automate token swaps on Uniswap DEX across multiple blockchains.
Last updated -
1
27
JavaScript
MIT License
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
204
Python
GPL 3.0
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 -
JavaScript
MIT License
Aptos Blockchain MCP
cuongpo
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
TypeScript
MIT License

View all related MCP servers

Tapp Exchange MCP Server