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 ```bash # Clone the repository git clone <repository-url> cd aerodrome-swap-mcp # Install dependencies pip install -r requirements.txt ``` ## Usage ```bash # Start the MCP server uvx aerodrome-swap-mcp ``` Or alternatively, you can install and run it locally: ```bash # 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_toke…