CoinGecko CLI

CoinGecko public API for cryptocurrency data. Free tier, no API key required for basic endpoints.

Learn more at Coingecko.

Created by @hnshah (Hiten Shah).

Quick Start

1. Install

See Install above.

2. Verify Setup

coingecko-pp-cli doctor

This checks your configuration.

3. Try Your First Command

coingecko-pp-cli coins list

Usage

Run coingecko-pp-cli --help for the full command reference and flag list.

Commands

coins

Manage coins

• coingecko-pp-cli coins detail - Get current data for a coin
• coingecko-pp-cli coins list - List all coins with id, symbol, and name
• coingecko-pp-cli coins markets - List coins with market data

global

Manage global

• coingecko-pp-cli global global - Get global crypto market data

ping

Manage ping

• coingecko-pp-cli ping ping - Check API server status

search

Manage search

• coingecko-pp-cli search search - Search coins, categories, exchanges
• coingecko-pp-cli coingecko-search-2 - Get trending coins

simple

Manage simple

• coingecko-pp-cli simple price - Get price of coins
• coingecko-pp-cli simple supported-vs-currencies - List supported vs currencies

Output Formats

# Human-readable table (default in terminal, JSON when piped)
coingecko-pp-cli coins list

# JSON for scripting and agents
coingecko-pp-cli coins list --json

# Filter to specific fields
coingecko-pp-cli coins list --json --select id,name,status

# Dry run — show the request without sending
coingecko-pp-cli coins list --dry-run

# Agent mode — JSON + compact + no prompts in one flag
coingecko-pp-cli coins list --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Use as MCP Server

This CLI ships a companion MCP server for use with Claude Desktop, Cursor, and other MCP-compatible tools.

Claude Code

claude mcp add coingecko coingecko-pp-mcp

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "coingecko": {
      "command": "coingecko-pp-mcp"
    }
  }
}

Health Check

coingecko-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/coingecko-pp-cli/config.toml

Troubleshooting

Not found errors (exit code 3)

• Check the resource ID is correct
• Run the list command to see available items

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

---

Generated by CLI Printing Press