TypeScriptADK-TS

MCP CoinGecko Pro

Access CoinGecko's full professional API — real-time OHLCV, on-chain DEX data, and advanced market analytics.

  • Endpoint: https://mcp.pro-api.coingecko.com/mcp
  • Provider: CoinGecko

Overview

The CoinGecko Pro MCP server wraps CoinGecko's professional API, giving your agent access to real-time OHLCV data, on-chain DEX pool analytics, historical market data with higher rate limits, and curated token metrics. It connects to CoinGecko's hosted MCP endpoint — no local process required.

Pro API Key Required

This server requires a CoinGecko Basic or Analyst API key. The free public API key cannot be used here. See the Credentials section below.

Getting Started

No installation required. Connect directly to the CoinGecko Pro hosted endpoint:

import { McpCoinGeckoPro } from "@iqai/adk";

const toolset = McpCoinGeckoPro({
  env: {
    COINGECKO_PRO_API_KEY: process.env.COINGECKO_PRO_API_KEY,
  },
});

const tools = await toolset.getTools();
import { McpToolset } from "@iqai/adk";

const toolset = new McpToolset({
  name: "CoinGecko Pro MCP Client",
  description: "Client for CoinGecko Pro market data",
  transport: {
    mode: "stdio",
    command: "npx",
    args: ["-y", "mcp-remote@latest", "https://mcp.pro-api.coingecko.com/mcp"],
    env: {
      COINGECKO_PRO_API_KEY: process.env.COINGECKO_PRO_API_KEY,
      PATH: process.env.PATH || "",
    },
  },
});

const tools = await toolset.getTools();
{
  "mcpServers": {
    "coingecko-pro": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.pro-api.coingecko.com/mcp"],
      "env": {
        "COINGECKO_PRO_API_KEY": "your_coingecko_pro_api_key"
      }
    }
  }
}

Environment Variables

VariableRequiredDescription
COINGECKO_PRO_API_KEYYesCoinGecko Paid tier API key

Credentials

To get a CoinGecko Paid API key:

  1. Sign up at coingecko.com/en/api/pricing
  2. Choose a Paid plan
  3. Go to your dashboard and copy your API Key

Available Tools

Remote MCP Endpoint

This MCP server is hosted remotely and tools are discovered dynamically at runtime. For the full list of available tools and endpoints, see the official CoinGecko MCP documentation.

Integration Example

import { AgentBuilder, McpCoinGeckoPro } from "@iqai/adk";
import * as dotenv from "dotenv";

dotenv.config();

async function main() {
  // Initialize McpCoinGeckoPro toolset
  const toolset = McpCoinGeckoPro({
    env: {
      COINGECKO_PRO_API_KEY: process.env.COINGECKO_PRO_API_KEY,
    },
  });

  // Get available McpCoinGeckoPro tools
  const coinGeckoProTools = await toolset.getTools();

  // Create agent with McpCoinGeckoPro tools
  const { runner } = await AgentBuilder.create("coingecko_pro_agent")
    .withModel("gemini-2.5-flash")
    .withDescription(
      "A professional crypto analyst agent with access to CoinGecko Pro data",
    )
    .withTools(...coinGeckoProTools)
    .build();

  const response = await runner.ask(
    "Give me the 7-day OHLCV data for Ethereum and identify any notable price patterns",
  );

  console.log(response);
}

main().catch(console.error);

Further Resources