How to Use the GeckoTerminal (DeFi Token Tracker) MCP in Windsurf

Get real-time DeFi pool data and token metrics directly inside Windsurf Cascade to build trading tools without manual API scraping.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GeckoTerminal (DeFi Token Tracker) MCP to Windsurf

Create your Vinkius account to connect GeckoTerminal (DeFi Token Tracker) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup GeckoTerminal (DeFi Token Tracker) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull live pool metrics without asking

This MCP server connects Windsurf to raw on-chain data across 100+ blockchains. Your autonomous Cascade agent uses `get_pool` and `list_trades` to inspect active liquidity pools and fetch the latest transaction logs instantly. It bypasses the need for manual browser searches or writing custom API wrappers. Cascade reads your workspace context, decides which pools are worth analyzing, and pulls historical charts via `get_ohlcv`. It chains these steps automatically, giving you a clean breakdown of price movements and volume spikes without interrupting your coding flow.

Autonomously discover trending tokens in Windsurf

Cascade uses this MCP Server to scan for market activity across multiple chains simultaneously. When you ask it to find new opportunities, the agent invokes `get_trending_pools_all` or targets a specific blockchain with `get_trending_pools_network`. It processes the raw JSON response to identify high-volume pairs before they hit mainstream aggregators. Once it spots a target, Cascade calls `get_token_info` to verify the contract metadata and check its launch history. You get a curated list of active contracts directly in your chat panel, ready for further automated analysis or script generation.

Build and test DeFi dashboards on the fly

This MCP Server integration lets your agent fetch live token details using `get_multiple_tokens` and write them directly into your local UI components. Cascade handles the entire pipeline by retrieving the data structure, generating the React or Vue code, and inserting the live endpoints. If a component fails to render, Cascade uses `get_network` to check chain-specific parameters and resolve formatting issues. The agent writes the tests, runs them in your terminal, and updates the UI with live pool data from `list_top_pools_for_token`.

Setup guide

Set up GeckoTerminal (DeFi Token Tracker) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the GeckoTerminal (DeFi Token Tracker) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my GeckoTerminal (DeFi Token Tracker) payment history." If connected, Cascade will call the GeckoTerminal (DeFi Token Tracker) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "geckoterminal-defi-token-tracker-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect GeckoTerminal (DeFi Token Tracker) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about GeckoTerminal (DeFi Token Tracker) MCP in Windsurf

Open your Windsurf settings and add the server configuration inside your `mcp_config.json` file under the `mcpServers` block. Alternatively, use the Settings UI under Cascade to add the endpoint, then click refresh to let Cascade auto-discover the 17 tools.

Yes, Cascade is built to run multi-step tasks autonomously. It can call `list_networks` to find available chains, run `get_new_pools_network` on a specific chain, and then pull details with `get_pool` in a single execution loop without asking for permission.

The server communicates directly with GeckoTerminal's public API endpoints. Cascade manages rapid requests by spacing out tool calls like `get_ohlcv` and `list_trades` to avoid hitting the standard rate limits of 30 requests per minute.

Yes, you can. You supply the contract addresses, and Cascade calls `get_multiple_tokens` to pull real-time prices, volumes, and 24-hour changes. It then formats this data into a markdown table or saves it directly to a local JSON file.

Vinkius runs the server inside a secure, ephemeral V8 Isolate Sandbox with zero-trust architecture. Only public block numbers, token contract addresses, and pool IDs are sent to the API, meaning your private local workspace files are never exposed to external networks.

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