> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinGecko Agent SKILL

> Give AI agents built-in knowledge of the CoinGecko API with the installable SKILL package

[CoinGecko SKILL](https://github.com/coingecko/skills) is an installable package that gives AI agents built-in knowledge of the CoinGecko API — endpoints, parameters, and common workflows — so your agent can write accurate queries and code without manual prompting.

Works with Claude Code, Gemini CLI, Codex CLI, and other SKILL-compatible agents. Setup takes under 3 minutes.

## Installation

<Tabs>
  <Tab title="Coding Agents">
    Install the SKILL for agents like Claude Code, Gemini CLI, or Codex CLI.

    ### Via [skills.sh](https://skills.sh/)

    <Steps>
      <Step title="Install the skills package">
        ```bash theme={null}
        npm install -g skills
        ```

        > See [npmjs/skills](https://www.npmjs.com/package/skills) for details.
      </Step>

      <Step title="Install the CoinGecko SKILL">
        ```bash theme={null}
        npx skills add coingecko/skills -g -y
        ```

        > `-g` installs globally for all agents.
      </Step>
    </Steps>

    ### Via GitHub

    <Steps>
      <Step title="Clone the repository">
        ```bash theme={null}
        git clone https://github.com/coingecko/skills.git coingecko-skills
        ```
      </Step>

      <Step title="Move to your agent's SKILLs directory">
        ```bash theme={null}
        mv coingecko-skills ~/.claude/skills/coingecko
        ```

        > Path varies by agent and OS. Example above is for Claude Code on Mac/Linux.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Web">
    <Steps>
      <Step title="Download the SKILL package">
        Download [skills-main.zip](https://github.com/coingecko/skills/archive/refs/heads/main.zip) from GitHub.
      </Step>

      <Step title="Upload to claude.ai">
        Go to [claude.ai/customize/skills](https://claude.ai/customize/skills) and select **+** → **Upload a skill**.

        <Frame>
          <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/claude-web-skills-add.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=06b57b0ce8b4bddc46daf96767b91ee4" width="3024" height="1614" data-path="assets/images/claude-web-skills-add.png" />
        </Frame>

        Upload the `skills-main.zip` file.

        <Frame>
          <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/claude-web-skills-upload.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=109b61a33825c512138fd6c2648f92a3" width="3024" height="1614" data-path="assets/images/claude-web-skills-upload.png" />
        </Frame>

        Done — the SKILL is now active.

        <Frame>
          <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/claude-web-skills-done.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=47afcc058ca851999a27ccae44973fec" width="3024" height="1614" data-path="assets/images/claude-web-skills-done.png" />
        </Frame>
      </Step>
    </Steps>

    ### Claude Web Constraints

    The SKILL includes built-in workarounds for Claude platform restrictions. If your API calls fail silently or return network errors, check the following:

    #### Allowlist CoinGecko domains

    Claude blocks outbound requests to domains not on your allowlist. Go to [claude.ai/settings/capabilities](https://claude.ai/settings/capabilities), scroll to **Domain allowlist**, and add:

    * `pro-api.coingecko.com`
    * `api.coingecko.com`

    <Frame>
      <img src="https://mintcdn.com/coingecko/i9l2MT4etZGYjSx8/assets/images/claude-web-domain-allowlist.png?fit=max&auto=format&n=i9l2MT4etZGYjSx8&q=85&s=fd4366a27638f4af7b40ef3fdc724837" width="1916" height="932" data-path="assets/images/claude-web-domain-allowlist.png" />
    </Frame>

    #### Artifacts cannot make API calls directly

    * Claude Artifacts run in a sandboxed environment that blocks external API calls.
    * The SKILL handles this automatically by fetching data server-side first, then passing results into the Artifact as static data.
  </Tab>
</Tabs>

<Tip>
  For the best experience — especially on the Claude free plan — set up the [CoinGecko MCP Server](/ai-integration/mcp-server) alongside the SKILL.
</Tip>

## Try It Out

Once installed, try asking your agent:

* *"If I invested \$100 in Bitcoin back in December 2018, how much would it be worth today?"*
* *"What was the ATH of XPL?"*
* *"What is the current market cap of DZnQi17HFgSM8mJ4nhVicz32B97XyTsd6MUVuDJgP9Jo from Solana?"*
* *"What are the top NFT collections this week?"*

***

<Card title="Share Feedback" icon="comment" href="https://forms.gle/oiZ86EwNxeTxCVEL7">
  Tell us how you're using the CoinGecko SKILL and what we should improve.
</Card>