Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| USER_ADDRESS | Yes | Your Ethereum wallet address | |
| ALCHEMY_API_KEY | No | Add an Alchemy API key to use your own RPCs, otherwise public rpcs will be used | |
| USER_PRIVATE_KEY | Yes | Your private key (for signing transactions locally, stays local, never transmitted) | |
| COINGECKO_API_KEY | Yes | CoinGecko API key for market data |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_swap_price | Get indicative price for a token swap using Aggregator Protocol |
| get_swap_quote | Get executable quote with transaction data for a token swap |
| execute_swap | Execute a swap transaction (requires quote data) |
| get_supported_chains | Get list of blockchain networks supported by Aggregator Protocol |
| get_liquidity_sources | Get list of liquidity sources available on a specific chain |
| get_token_price | Get token prices by contract addresses using CoinGecko API |
| get_coingecko_networks | Get list of supported networks on CoinGecko/GeckoTerminal |
| get_supported_dexes | Get list of supported DEXes on a specific network |
| get_trending_pools | Get trending pools across all networks on GeckoTerminal |
| get_trending_pools_by_network | Get trending pools on a specific network |
| get_multiple_pools_data | Get data for multiple pools by their contract addresses |
| get_top_pools_by_dex | Get top pools on a specific DEX |
| get_new_pools | Get latest new pools across all networks |
| search_pools | Search for pools by query (pool address, token address, or token symbol) |
| get_top_pools_by_token | Get top pools for a specific token by contract address |
| get_token_data | Get specific token data by contract address |
| get_multiple_tokens_data | Get data for multiple tokens by their contract addresses |
| get_token_info | Get detailed token information including socials, websites, and description |
| get_recently_updated_tokens | Get recently updated tokens with their information |
| get_pool_ohlcv | Get OHLCV (Open, High, Low, Close, Volume) data for a pool |
| get_pool_trades | Get recent trades for a specific pool |
| get_gasless_price | Get indicative price for a gasless token swap (no gas fees required) |
| get_gasless_quote | Get executable quote for a gasless token swap with EIP-712 signature data |
| submit_gasless_swap | Submit a gasless swap by signing approval and trade messages (no gas fees required) |
| get_gasless_status | Get the status of a submitted gasless swap |
| get_gasless_chains | Get list of blockchain networks that support gasless swaps |
| get_gasless_approval_tokens | Get list of tokens that support gasless approvals (EIP-2612 permit) |
| get_portfolio_tokens | Get tokens with balances, prices, and metadata for multiple wallet addresses |
| get_portfolio_balances | Get token balances for multiple wallet addresses (faster, no prices/metadata) |
| get_portfolio_transactions | Get transaction history for a wallet address (BETA: 1 address, ETH/BASE only) |
| convert_wei_to_formatted | Convert wei amounts to human-readable format using ethers.js |
| convert_formatted_to_wei | Convert formatted amounts to wei using ethers.js |