Coingecko MCP Server

The official MCP Server for the Coingecko API

Local serverstdioTypeScript

What is the Coingecko MCP server?

Most developer tooling work still happens through a UI a human drives. Coingecko MCP server moves it into the conversation instead. The official MCP Server for the Coingecko API.

The short version

This library provides convenient access to the Coingecko REST API from server-side TypeScript or JavaScript.

Getting it running

@coingecko/coingecko-typescript on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

The tools it exposes

The server publishes 3 tools. What each one is for:

  • Retries — Certain errors will be automatically retried 2 times by default, with a short exponential backoff. Connection errors (for example, due to a network
  • Timeouts — Requests time out after 1 minute by default. You can configure this with a timeout option:
  • Logging — The Logging tool exposed by this server

What it needs from you

Configuration is passed through the environment: COINGECKO_PRO_API_KEY, COINGECKO_DEMO_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

TypeScript >= 4.9 is supported. The following runtimes are supported: - Web browsers (Up-to-date Chrome, Firefox, Safari, Edge, and more) - Node.js 20 LTS or later (non-EOL) versions. - Deno v1.28.0 or higher. - Bun 1.0 or later. - Cloudflare Workers. - Vercel Edge Runtime. - Jest 28 or greater with the "node" environment ("jsdom" is not supported at this

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Coingecko's toolset — Retries, Timeouts, Logging — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
RetriesCertain errors will be automatically retried 2 times by default, with a short exponential backoff. Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict, 429 Rate Limit
TimeoutsRequests time out after 1 minute by default. You can configure this with a timeout option:
LoggingThe Logging tool exposed by this server.

How to install the Coingecko MCP server

{
  "mcpServers": {
    "coingecko-1": {
      "command": "npx",
      "args": ["-y", "@coingecko/coingecko-typescript"],
      "env": {
        "COINGECKO_PRO_API_KEY": "your-value",
        "COINGECKO_DEMO_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

TypeScript >= 4.9 is supported. The following runtimes are supported: - Web browsers (Up-to-date Chrome, Firefox, Safari, Edge, and more) - Node.js 20 LTS or later (non-EOL) versions. - Deno v1.28.0 or higher. - Bun 1.0 or later. - Cloudflare Workers. - Vercel Edge Runtime. - Jest 28 or greater with the "node" environment ("jsdom" is not supported at this

VariableDescriptionRequired
COINGECKO_PRO_API_KEYCredential the server authenticates with.Yes
COINGECKO_DEMO_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Coingecko to Retries.
  • Use Coingecko to Timeouts.
  • Use Coingecko to Logging.

Frequently asked questions

It connects Coingecko to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Retries, Timeouts, Logging) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Coingecko directly.