Tapp Exchange

Provides an MCP server for Tapp Exchange enabling pool management, swaps, liquidity, and position analytics on Aptos.

typescript

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tamago-labs-tapp-exchange-mcp": {
      "command": "npx",
      "args": [
        "@tamago-labs/tapp-exchange-mcp"
      ],
      "env": {
        "TAPP_NETWORK": "mainnet",
        "TAPP_RPC_URL": "https://fullnode.mainnet.aptoslabs.com/v1",
        "TAPP_API_TIMEOUT": "30000",
        "TAPP_PRIVATE_KEY": "YOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

You can run and interact with the Tapp Exchange MCP Server to query pools, execute trades, manage liquidity, and track positions through a programmable interface. This server exposes essential trading and liquidity operations to AI agents and client applications, enabling seamless integration with Tapp Exchange on Aptos.

How to use

Set up and run the MCP server, then connect your MCP client or Claude Desktop integration to perform pool discovery, swaps, liquidity management, and position tracking. You will be able to retrieve pool lists, get detailed pool information, estimate swaps, route swaps across pool types, and manage liquidity and positions.

How to install

Prerequisites you need to have installed on your machine are Node.js (with npm) and a working network connection to access the Aptos-based Tapp Exchange endpoints.

Install the MCP package from npm, then prepare your environment and start the server.

Additional setup and usage notes

Create a configuration file to specify the network and optional RPC and private key settings. You can also configure an API timeout if you need to tailor responsiveness for your integration.

Use the MCP server as an HTTP or stdio endpoint for your client. The provided example demonstrates running the MCP server locally via a standard Node.js execution flow.

Programmatic usage example

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
});

Configuration

Configure environment variables to control network, endpoints, and timing. The following options are supported:

Network to connect to (mainnet, testnet, devnet)
Optional: Custom RPC URL for Aptos full node
Optional: Private key for signing
Optional: API timeout in milliseconds

Testing and development

Install dependencies, build the project, and run tests to verify pool, swap, and liquidity functionality.

Security and best practices

Validate inputs, simulate transactions before execution, and apply slippage protection and gas estimation to safeguard operations.

Available tools

Pool management

Query available pools, get pool info, and manage pool analytics across AMM, CLMM, and Stable pools.

Swap operations

Estimate swaps, determine swap routes, and execute swaps on AMM, CLMM, and Stable pools.

Liquidity management

Add or remove liquidity, create new pools, and manage multiple liquidity positions.

Position management

Get user positions and collect fees from liquidity positions.

Built by

VeilStrat

AI signals for GTM teams