GeckoTerminal MCP. Analyze DeFi liquidity and token performance across chains.

Q: How do I find out what blockchains GeckoTerminal supports?

Run listnetworks. This tool gives you a complete list of all supported blockchain networks, like Ethereum, Solana, and Polygon.

Q: What is the best way to find trending pools on a specific network?

Use gettrendingpoolsnetwork. You pass the network name, and it returns the currently most active pools for that chain.

Q: Can I get historical price data for a pool using getohlcv?

Yes, getohlcv retrieves the historical Open, High, Low, Close, and Volume data for any given pool address, letting you chart its performance.

Q: How do I check token metadata and market cap using gettokeninfo?

Run gettokeninfo with the contract address. It returns the token's market cap, contract details, and metadata, giving you full context.

Q: Which tool should I use to see the most recent trades in a pool?

Use listtrades. It returns a log of the most recent trades for a specific pool address, which is crucial for tracking immediate market flow.

Q: How do I find the top pools for a specific token using listtoppoolsfortoken?

You use listtoppoolsfortoken to find the most liquid pools for a token. This tool accepts a token address and returns a ranked list of pools, helping you see where the token is most active.

Q: Which tool should I use to get details for multiple tokens and pools (getmultipletokens and getmultiplepools)?

Use getmultipletokens and getmultiplepools to process batches of data efficiently. These tools let you fetch details for many tokens or pools simultaneously, saving multiple API calls.

Q: How do I analyze the overall market activity using listtrades?

listtrades retrieves the most recent trades for any given pool address. This lets you monitor immediate market flow and analyze recent activity, which is key for identifying quick shifts in value.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Just plug in your AI agents and start using Vinkius.

GeckoTerminal (DeFi Token Tracker) provides real-time data on DeFi tokens, liquidity pools, and DEX activity across 100+ blockchains. Your AI client accesses detailed metrics, including pool pricing, liquidity depth, and historical OHLCV data for any specific address.

It lets you query trending pools globally or drill down into specific token metadata without leaving your chat environment.

What your AI agents can do

Get multiple pools

Gets detailed metrics for a list of specified liquidity pools.

Get multiple tokens

Gets detailed metrics for a list of specified tokens.

Get network

Gets specific details about a selected blockchain network.

+ 14 more capabilities included

Discover all networks and exchanges

Your agent lists all supported blockchains and the specific DEXes running on them.

Analyze pool performance

Your agent fetches detailed metrics—pricing, liquidity, and volume—for any given liquidity pool address.

Identify market trends

Your agent pulls lists of trending or newly created pools across specific chains or globally.

Extract token contract data

Your agent retrieves comprehensive metadata, market caps, and contract details for any token.

Track historical price movement

Your agent pulls historical OHLCV data and recent trades for deep market analysis.

Ask AI about this MCP

Ask ChatGPT

Ask Claude

Ask Perplexity

Supported MCP Clients

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Gets a list of the top liquidity pools across all pools on a given network.

list019e5d1e

list trades

Retrieves a log of the most recent trades that happened in a specific pool.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with GeckoTerminal (DeFi Token Tracker), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 4,700+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

What you can do with this MCP connector

GeckoTerminal DeFi Tracker - Analyze Pools & Tokens

Your AI client connects to GeckoTerminal to pull real-time data on DeFi tokens, liquidity pools, and DEX activity across over a hundred blockchains. It's your go-to source for deep metrics, including pool pricing, liquidity depth, and historical OHLCV data for any address. You can query trending pools globally or zero in on specific token metadata without ever leaving your chat.

Discovering the Landscape

Your agent lists all supported blockchain networks using list_networks, and you can find every decentralized exchange operating on a specific chain with list_dexes. You can then get a list of top pools for a specific DEX on a network using list_top_pools_dex, or find the top pools across all pools on a network with list_top_pools_network.

You can also pull a list of the top pools associated with a specific token using list_top_pools_for_token.

Finding Hot Spots and New Activity

To find out what's moving, your agent pulls a list of trending pools across all networks using get_trending_pools_all, or you can check the trending pools on a specific network using get_trending_pools_network. If you want to see what's fresh, you can get a list of newly created pools across every supported blockchain network using get_new_pools_all, or check for new pools on a specific network using get_new_pools_network.

Deep Pool and Token Analysis

For any specific liquidity pool address, your agent gets full details using get_pool, and you can also get detailed metrics for a list of specified pools using get_multiple_pools. You can analyze the performance of a single pool by pulling historical OHLCV data using get_ohlcv, or reviewing a log of the most recent trades in a specific pool using list_trades.

When you need to know exactly what a token is, your agent gets full details for one contract using get_token, or pulls detailed metadata and contract info for a specified token using get_token_info. If you're tracking a bunch of assets, you can get detailed metrics for a list of specified tokens using get_multiple_tokens.

Tracking Market Depth

You can analyze the top liquidity pools for a specific token using list_top_pools_for_token and for a specific DEX on a network using list_top_pools_dex. If you need to know about a particular token, your agent can get detailed metrics using get_token_info and also get full details for a single token contract using get_token.

For any given pool, you can get detailed metrics for a list of specified pools using get_multiple_pools.

How GeckoTerminal MCP Works

1 First, subscribe to the GeckoTerminal server and provide your API key if rate limits are a concern.
2 Next, instruct your AI client to perform a specific query (e.g., 'Show me the top pools on Polygon').
3 Your agent runs the necessary tools and returns a structured data payload containing the requested DeFi metrics.

The bottom line is that your AI agent handles the complex data calls so you get a clean, actionable report, not raw JSON.

Who Is GeckoTerminal MCP For?

This is for DeFi traders and data analysts. It's for the quantitative researcher who needs to quickly verify pool liquidity and track whale movements before making a trade. It's for the developer who needs to validate token metadata without opening a browser.

Quantitative Trader

Uses the agent to compare liquidity depths and 24h volume across multiple pools before executing a trade.

Web3 Developer

Uses the agent to verify token contract addresses and fetch historical OHLCV data directly into a script or IDE.

Blockchain Analyst

Uses the agent to map the full scope of a network, listing all supported DEXes and analyzing new pools.

What Changes When You Connect

Analyze pool performance on demand. Use get_pool to fetch precise pricing, liquidity depth, and 24h volume for any pool address. No more clicking through multiple dashboards.
Map the entire crypto ecosystem. Call list_networks and then list_dexes to map every supported blockchain and every major DEX running on it.
Spot emerging opportunities. Run get_new_pools_all to immediately identify what's hot by checking newly created pools across all chains, saving research time.
Understand token fundamentals. Use get_token_info to get full token metadata, contract details, and market caps. You get the data, not a link to another site.
Track large money movements. Call list_trades to get a log of recent trades in a pool, letting you see where the big money is moving.
Benchmark top assets. Use list_top_pools_network to quickly see the highest liquidity pools on a chain, letting you compare top performers immediately.

Real-World Use Cases

Investigating a new token pair

A researcher needs to know if a new token (XYZ) has good liquidity. They ask the agent: 'Get token info for XYZ, then list top pools for XYZ on Ethereum.' The agent runs get_token_info and then list_top_pools_for_token. They get a ranked list of pools, letting them decide if the token is safe to use.

Monitoring a competitor's strategy

A trading analyst wants to track if a competitor just launched a major pool on Solana. They prompt the agent: 'Show me all new pools on Solana.' The agent runs get_new_pools_network and presents the list, instantly alerting the analyst to the activity.

Validating pool data before a trade

A developer needs to confirm the current liquidity depth of a specific pool address. They ask the agent to run get_pool on the address. The agent returns the current pricing and liquidity depth, allowing the developer to proceed with confidence.

Researching market history

A data scientist needs historical data for charting. They ask the agent to fetch OHLCV data for a specific pool. The agent runs get_ohlcv, giving a structured time-series dataset they can immediately model.

The Tradeoffs

Asking for everything at once

Just saying 'Tell me everything about DeFi.' The agent will fail because it doesn't know which 17 tools you need. You'll get a generic, useless error message.

→ Start narrow. First, run list_networks to narrow the chain. Then, use get_trending_pools_network to find the top pools on that specific chain. This limits the scope and focuses the data.

Ignoring the network scope

Asking for 'top pools' without naming a chain. The agent defaults to the wrong network or fails, wasting time.

→ Always specify the network. Use list_top_pools_network and specify the chain ID (e.g., Ethereum). This keeps the data relevant and focused.

Forgetting token context

Trying to check a pool's liquidity depth without knowing the token's market cap. You only see the numbers, but you don't know the asset's overall risk.

→ Run get_token_info first to get the asset's market cap and metadata. Then, use get_pool to get the specific pool metrics. This gives the full picture.

When It Fits, When It Doesn't

Use this if you need a full, deep-dive view of crypto assets. You need to correlate token metadata with pool performance, or track historical price action. You are building a workflow that requires multiple data points (e.g., 'Show me the top pools for this token on this network').

Don't use this if you just need a simple, single piece of data, like 'What is the price of token X right now?' For that, a simple, dedicated API call or a basic data lookup tool is better. If you only need to list networks, list_networks is enough. If you only need the most recent trades, list_trades is enough. This server is for complex analysis, not simple lookups.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by GeckoTerminal. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_multiple_pools get_multiple_tokens get_network get_new_pools_all get_new_pools_network get_ohlcv get_pool get_token get_token_info get_trending_pools_all get_trending_pools_network list_dexes list_networks list_top_pools_dex list_top_pools_for_token list_top_pools_network list_trades

Tracking DeFi liquidity across multiple chains shouldn't require opening 15 tabs.

Today, checking liquidity across different chains means opening a crypto explorer, finding the token contract, navigating to the pool, and manually checking the depth and price. You copy the address, open a spreadsheet, and repeat that process for every chain you care about.

With this MCP server, you ask your agent to compare pools. It runs the necessary tools and returns a clean table comparing liquidity depth, 24h volume, and pricing for every pool you name. You get the comparison instantly.

GeckoTerminal (DeFi Token Tracker) MCP Server: Get structured market data.

You no longer need to manually run separate queries for token metadata and pool metrics. Your agent runs `get_token_info` and `get_pool` in sequence, passing the token ID from the first result to the second. This builds a complete data object that you can use for modeling.

The result is a single, integrated data object. You don't copy-paste a contract address; you get the full analysis in one conversational pass. That's how it should work.

Common Questions About GeckoTerminal MCP

How do I find out what blockchains GeckoTerminal supports? +

Run list_networks. This tool gives you a complete list of all supported blockchain networks, like Ethereum, Solana, and Polygon.

What is the best way to find trending pools on a specific network? +

Use get_trending_pools_network. You pass the network name, and it returns the currently most active pools for that chain.

Can I get historical price data for a pool using get_ohlcv? +

Yes, get_ohlcv retrieves the historical Open, High, Low, Close, and Volume data for any given pool address, letting you chart its performance.

How do I check token metadata and market cap using get_token_info? +

Run get_token_info with the contract address. It returns the token's market cap, contract details, and metadata, giving you full context.

Which tool should I use to see the most recent trades in a pool? +

Use list_trades. It returns a log of the most recent trades for a specific pool address, which is crucial for tracking immediate market flow.

How do I find the top pools for a specific token using list_top_pools_for_token? +

You use list_top_pools_for_token to find the most liquid pools for a token. This tool accepts a token address and returns a ranked list of pools, helping you see where the token is most active.

Which tool should I use to get details for multiple tokens and pools (get_multiple_tokens and get_multiple_pools)? +

Use get_multiple_tokens and get_multiple_pools to process batches of data efficiently. These tools let you fetch details for many tokens or pools simultaneously, saving multiple API calls.

How do I analyze the overall market activity using list_trades? +

list_trades retrieves the most recent trades for any given pool address. This lets you monitor immediate market flow and analyze recent activity, which is key for identifying quick shifts in value.

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.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript