mcpField
C
coingecko-cli

coingecko-cli

github.com/paulrbergData & databases102114 installsUpdated today
Repository

About coingecko-cli

coingecko-cli is a skill for using the `cg` command-line tool to retrieve CoinGecko market data. It consults the CLI's command catalog to check supported operations, authentication and tier limits, and guides query execution and result presentation.

Key features

  1. 01Inspect CLI status and command catalog
  2. 02Resolve coin IDs with search
  3. 03Preview queries with dry-run
  4. 04Return JSON or requested CSV exports
  5. 05Check tier limits and rate limits
  6. 06Protect keys and private account data

Use cases

  1. 01Retrieve market data for named coins
  2. 02Check command support and tier requirements
  3. 03Export requested results as CSV
  4. 04Handle ambiguous symbols or rate limits

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/paulrberg/agent-skills --skill coingecko-cli

After installing, type/coingecko-cliin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

CoinGecko CLI

Use the installed CLI's machine-readable command catalog as the source of truth for supported market-data operations.

Workflow

  1. Verify cg exists and inspect non-interactive auth/tier state:

    command -v cg
cg status -o json
cg commands -o json

    Do not run interactive cg auth or write config without the user's approval.

  2. Select the command, flags, enum values, output formats, endpoint, auth requirement, and paid_only status from cg commands -o json. Use cg <command> --help only when the catalog lacks a needed detail.

  3. Resolve CoinGecko IDs with cg search <term> -o json when the user supplied a name or ambiguous symbol. Do not silently treat symbols as unique.

  4. Preview unfamiliar or quota-sensitive requests with --dry-run. Execute parseable queries with -o json; use --export only when the user requested a CSV artifact.

  5. Present the requested result in the user's format. For ordinary human-readable output, use a compact table and preserve enough precision for the asset's magnitude.

Boundaries and Defaults

  • Batch IDs in one request when the command supports it. On 429, respect the reported reset/backoff rather than retrying aggressively.
  • Detect paid-only commands before execution. If the current tier cannot serve the request, say so and offer a supported route.
  • cg does not cover every CoinGecko endpoint. For unsupported contract-address prices, global stats, NFT detail, GeckoTerminal, or logo metadata, fetch the relevant current API documentation from https://docs.coingecko.com/llms.txt and state that the CLI route is unavailable.
  • Never expose API keys or send private wallet/account data to market-data endpoints.

Completion requires the resolved coin/command, successful JSON or requested export evidence, and explicit handling of tier, ambiguity, or rate-limit constraints.

User-Facing Output

For ordinary human output, lead with ### 🪙 <coin> (<id>), show only the requested metrics in a compact table, and add one source line with the endpoint plus timestamp, tier, or window when material. For exports, use ### ✅ Exported <row count> rows, link the artifact, and state the query/window without reproducing the CSV. Use ### ⚠️ Rate limited — retry after <time> when returning control, ### ⏳ Rate limited — retrying after <time> only while actively waiting, or ### ⚠️ Paid endpoint — current tier: <tier> with one supported route. Return requested JSON/CSV, exact IDs, URLs, values, commands, and diagnostics undecorated.

Comments

Markdown supported