# GeckoTerminal MCP for AI Agents AI Agent Connect > GeckoTerminal MCP lets you pull real-time DeFi data into your AI client. Track tokens, liquidity pools, and DEX activity across 100+ blockchains. It's for anyone who needs to see what's happening in the decentralized finance space without jumping between dozens of tabs. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_SXdYlOpyZ8acZz2gelcL7kGVR6l16hy26p0zeECs/ai-agent-connect - **Tags:** defi, dex-tracker, token-analytics, liquidity-pools, crypto-trading ## Description This Connector brings GeckoTerminal's massive database of decentralized finance data directly into your AI agent. Instead of manually refreshing multiple websites to see which pools are trending or checking liquidity depth on different chains, you can just ask your agent to do the heavy lifting. It handles the messy work of scanning 100+ blockchains to find the specific token metadata, market caps, and trade histories you actually care about. Whether you're hunting for new liquidity opportunities on Solana or analyzing whale movements on Ethereum, this connection gives your agent the eyes it needs to see the whole market. It's a huge part of why Vinkius is the go-to for power users who want to turn their AI into a functional research workstation. You get a direct line to real-time pricing, historical OHLCV charts, and deep pool analytics without ever leaving your workspace. It's about moving from looking for data to analyzing data instantly. ## Tools ### list_networks See all blockchain networks supported by GeckoTerminal. Use this to see the full scope. ### get_network Get specific details for a blockchain network. Use this to check supported chains. ### get_ohlcv Fetch historical price data for a specific liquidity pool. This helps with trend analysis. ### get_pool Retrieve detailed information for a single liquidity pool. See depth and pricing. ### get_token_info Pull metadata and contract details for a specific token. Use this to verify assets. ### get_token Get specific details for an individual DeFi token. This gives you a quick overview. ### list_dexes See all decentralized exchanges operating on a chosen network. Good for discovery. ### list_top_pools_dex Find the highest performing pools for a specific DEX. Helps identify high-traffic areas. ### list_top_pools_for_token See every pool where a specific token is traded. Great for finding liquidity for a specific asset. ### list_top_pools_network Identify the top pools across an entire blockchain network. Use this to see what's hot on a chain. ### list_trades Get a list of recent trades to track whale movements. This shows real-time flow. ### get_new_pools_all Find the newest liquidity pools across all networks. Use this for early discovery. ### get_new_pools_network Find new pools specifically on one blockchain. Good for monitoring specific chains. ### get_trending_pools_all See what's hot across the entire DeFi landscape. This gives you a global market view. ### get_trending_pools_network Find trending pools on a specific network like Solana or Ethereum. See what's moving now. ### get_multiple_pools Fetch details for several liquidity pools at once. This saves time on bulk analysis. ### get_multiple_tokens Get data for a list of tokens in one go. Use this for quick portfolio scans. ## Prompt Examples **Prompt:** ``` What's trending on Ethereum right now? ``` **Response:** ``` Here are the top trending pools on the Ethereum network right now: | Pool | DEX | 24h Volume | Liquidity | | :--- | :--- | :--- | :--- | | **PEPE/WETH** | Uniswap V3 | $1.2B | $450M | | **USDC/WETH** | Uniswap V3 | $800M | $320M | | **LDO/WETH** | Uniswap V3 | $450M | $180M | Would you like me to pull the recent trade history for any of these? ``` **Prompt:** ``` Check the liquidity for the pool at 0x123... on Solana. ``` **Response:** ``` I've analyzed the pool at that address on Solana. Here are the details: * **Pair**: SOL/USDC * **Liquidity Depth**: $12.4M * **24h Volume**: $2.1M * **Current Price**: $145.20 It looks like a high-liquidity pool with steady volume. Do you want to see the most recent trades? ``` **Prompt:** ``` Show me the newest pools across all chains. ``` **Response:** ``` I've found the latest liquidity pools added across all networks: * **New on Arbitrum**: WBTC/USDC (Uniswap V3) * **New on Polygon**: MATIC/USDC (QuickSwap) * **New on Base**: ETH/USDC (Aerodrome) Would you like me to fetch the specific metadata for any of these new pairs? ``` ## Capabilities ### Scan 100+ blockchains for active DEXes Identify which decentralized exchanges are currently operating on any supported network. ### Identify trending liquidity pools globally See which pools are getting the most attention across the entire DeFi landscape. ### Pull deep analytics for specific pool addresses Get precise pricing, liquidity depth, and volume for any specific pool. ### Retrieve token metadata and contract info Fetch market caps and contract details for any DeFi asset instantly. ### Analyze whale movements via recent trades View the latest trade history to track large-scale movements and retail flow. ### Fetch historical price data for charting Get OHLCV data to analyze price trends and build historical models. ## Use Cases ### Finding new pairs A trader wants to see what's hot on Solana. They ask the agent to find trending pools on that network using get_trending_pools_network. ### Whale watching An analyst wants to see big moves. They ask the agent to list recent trades for a specific pool using list_trades. ### Token verification A dev needs to check a contract. They ask the agent to get token info for a specific address using get_token_info. ### Market research A researcher wants to see a token's reach. They ask the agent to list all pools for that token using list_top_pools_for_token. ## Benefits - Stop manually checking DEX sites by using list_top_pools_network to see what's hot on any chain. - Get instant token metadata with get_token_info to verify contract details before you trade. - Track whale movements in real-time using list_trades to see where the big money is moving. - Analyze historical trends quickly with get_ohlcv to build your own price charts and models. - Scan the whole market at once with get_new_pools_all to spot emerging liquidity opportunities. ## How It Works The bottom line is your AI agent gets a direct feed to real-time DeFi market data. 1. Subscribe to the GeckoTerminal MCP on Vinkius. 2. Enter your GeckoTerminal API Key if you need higher rate limits. 3. Ask your AI client to find trending pools or fetch token data. ## Frequently Asked Questions **How does GeckoTerminal MCP help with DeFi trading?** It gives your AI agent a direct feed to real-time market data. You can ask it to find high-volume pools, check liquidity, and monitor price trends across hundreds of different chains instantly. **Can I use GeckoTerminal MCP to find new liquidity pools?** Yes, it can scan all supported networks to find the newest pools. This is great for spotting emerging opportunities before they become mainstream. **Does GeckoTerminal MCP support multiple blockchains?** It supports over 100 different networks. You can query data for chains like Ethereum, Solana, Arbitrum, and many others in a single session. **How do I get historical price data with GeckoTerminal MCP?** You can ask your agent to pull historical OHLCV data for any specific pool. This is perfect for building your own price charts or doing deeper research into past trends. **Can I see whale movements using GeckoTerminal MCP?** Yes, by pulling the recent trade history for specific pools, your agent can identify large-scale trades and help you track where the big money is moving. **Is GeckoTerminal MCP good for token research?** It's excellent for research. It can pull token metadata, market caps, and all the different pools where a specific token is being traded across the entire DeFi landscape. **Can I see the trending liquidity pools on a specific network like Solana?** Yes! Use the `get_trending_pools_network` tool with the network ID 'solana'. The agent will return a list of the most active pools currently trending on that blockchain. **How do I get historical price data (OHLCV) for a specific token pool?** You can use the `get_ohlcv` tool. Provide the network ID and the pool address to retrieve historical open, high, low, close, and volume data for various timeframes. **Is it possible to list the most recent trades for a pair?** Absolutely. Use the `list_trades` tool with the network ID and pool address. It will fetch the latest transaction history, including trade size and timestamps.