aerodrome-swap-mcp

Aerodrome Swap MCP Server

This is a Model Context Protocol (MCP) server that provides integration with the Aerodrome Swap API. It allows users to interact with Aerodrome's decentralized exchange functionality through the MCP framework.

Features

• Interact with Aerodrome Swap API
• Support for token swaps
• Pool information retrieval
• Price information retrieval
• Quote generation

Prerequisites

• Python 3.8+
• Conda environment activated

Installation

# Clone the repository
git clone <repository-url>
cd aerodrome-swap-mcp

# Install dependencies
pip install -r requirements.txt

Usage

# Start the MCP server
uvx aerodrome-swap-mcp

Or alternatively, you can install and run it locally:

# Install the package
pip install -e .

# Start the MCP server
aerodrome-swap-mcp

API Reference

This MCP server provides the following tools for interacting with the Aerodrome Swap API:

Token Operations

• get_tokens - Get all tokens with optional filtering

  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • limit (int, optional): Max tokens to return (1-1000, default: 100). Defaults to 100.
  • offset (int, optional): Skip tokens for pagination (default: 0). Defaults to 0.
  • listed_only (bool, optional): Only return listed tokens. Defaults to False.

• get_token_by_address - Get detailed information about a specific token.

  • address (str): The token address.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

• get_tokens_batch - Get information for multiple tokens in a single request. Useful for efficiently fetching data for token lists.

  • addresses (List[str]): The list of token addresses to retrieve information for.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

• search_tokens - Search for tokens by symbol or address. This is useful for token selection in UI components.

  • query (str): Search term (symbol or address).
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • limit (int, optional): Max results (1-50, default: 10)

Price Operations

• get_prices - Get current token prices. This endpoint is optimized for high-frequency price queries with intelligent caching.

  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • limit (int, optional): limit (int, optional): Max pools to return (1-1000, default: 100). Only worked when "symbols" is empty. Defaults to 50.
  • offset (int, optional): Skip pools for pagination (default: 0). Only worked when "symbols" is empty. Defaults to 0.
  • symbols (Optional[List[str]], optional): The token symbols to filter prices by. When "symbols" is set, "limit" and "offset" are ignored. Exp, "AERO,USDC". Defaults to None.

• get_price_by_address - Get price for a specific token.

  • address (str): The token address.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

Pool Operations

• get_pools - Get a list of Aerodrome pools

  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • limit (int, optional): Max pools to return (1-1000, default: 100). Defaults to 100.
  • offset (int, optional): Skip pools for pagination (default: 0). Defaults to 0.
  • token (Optional[str], optional): The token address to filter pools by. Defaults to None.

• get_pools_detailed - Get detailed pool information with TVL, APR, volume, fees, and voting rewards

  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • limit (int, optional): Max pools to return (1-1000, default: 100). Defaults to 100.
  • offset (int, optional): Skip pools for pagination (default: 0). Defaults to 0.
  • sort_by (str, optional): The field to sort by, must be one of: tvl, apr, volume, fees. Defaults to "tvl".
  • symbol (Optional[str], optional): The pool symbol. Defaults to None.
  • min_tvl (Optional[int], optional): The minimum TVL to filter pools by. Defaults to None.

• get_pool_by_address - Get detailed information about a specific pool by address.

  • address (str): The address of the pool.
  • token0 (Optional[str], optional): The token0 address to filter pools by. Defaults to None.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

• search_pools - Search for pools by token pair and other criteria. At least one token address is required.

  • token0 (Optional[str], optional): The token0 address to filter pools by. Defaults to None.
  • token1 (Optional[str], optional): The token1 address to filter pools by. Defaults to None.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

Swap Operations

• get_quote - Get quotes for Aerodrome

  • from_token (str): Token to swap from (contract address)
  • to_token (str): Token to swap to (contract address)
  • amount (int): Amount to swap (in token units, not wei)
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".

• build_swap - Simulates transaction (customer needs to approve on their end)

  • from_token (str): Token to swap from (contract address)
  • to_token (str): Token to swap to (contract address)
  • amount (str): Amount to swap (in token units, not wei)
  • wallet_address (str): Wallet address to execute swap.
  • target (str, optional): The target blockchain, "base", "aero", "optimistic-ethereum", "velo". Defaults to "aero".
  • slippage (float, optional): Slippage tolerance (0.001-0.5, default: 0.005)

• get_transaction - Get transaction after swap.

  • tx_hash (str): Transaction hash.
  • target (str, optional): The target blockchain. Defaults to "aero".

Development

To contribute to this project:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request