> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://coingecko.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://coingecko.ferndocs.com/_mcp/server. # CoinGecko Agent SKILL [CoinGecko SKILL](https://github.com/coingecko/skills) is an installable package that gives AI agents built-in knowledge of the CoinGecko API, including endpoints, parameters, and common workflows. * Instead of manually explaining the API to your agent every time, the **SKILL lets your agent understand CoinGecko data instantly** and respond with accurate queries and code. * The SKILL works with popular AI coding agents and tools such as Claude Code, Gemini CLI, Codex CLI, and other SKILL-compatible agents. **Setup takes less than 3 minutes**. You can check out the repo at [github.com/coingecko/skills](https://github.com/coingecko/skills), or follow the installation instructions below. --- ## Installation You may install the CoinGecko SKILL package using one of the following methods, depending on your preferences: * For **Coding agents**, we recommend following [this section](#setting-up-for-agents-/-llms). * For **Claude web users**, please follow [this section](#setting-up-for-claude-ai) instead. --- ### Setting up for Agents / LLMs *\*such as Claude Code, Gemini CLI, Codex CLI* #### Installation via [skills.sh](https://skills.sh/) #### Install the \`skills\` package globally to manage SKILLs across your system ```bash theme={null} npm install -g skills ``` *\*see [npmjs/skills](https://www.npmjs.com/package/skills) for more details.* #### Install the CoinGecko SKILL package using \`npx skills\` ```bash theme={null} npx skills add coingecko/skills -g -y ``` *\*`-g` flag to install globally for all agents.* #### Installation via GitHub *\*see [github.com/coingecko/skills](https://github.com/coingecko/skills)* #### Clone from the GitHub repository ```bash theme={null} git clone https://github.com/coingecko/skills.git coingecko-skills ``` #### Move the cloned artifact to your agent's SKILLs directory ```bash theme={null} mv coingecko-skills ~/.claude/skills/coingecko ``` *\*the exact path may vary based on your agent and operating system. \ \*example above is for Claude Code on Mac/Linux.* --- ### Setting up for [Claude.ai](https://claude.ai/) #### Download the SKILL package (.zip) from GitHub Visit [https://github.com/coingecko/skills/archive/refs/heads/main.zip](https://github.com/coingecko/skills/archive/refs/heads/main.zip) #### Upload the \`skills-main.zip\` to claude.ai 1. Visit [https://claude.ai/customize/skills](https://claude.ai/customize/skills) 2. Select '+' -> 'Upload a skill' ![](https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.06.52.png?fit=max\&auto=format\&n=phsN_J1K7MuyOqmI\&q=85\&s=4f09083374b29a7c047302cb7b45c4be) 3. Upload the `skills-main.zip` file you downloaded from GitHub. ![](https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.10.41.png?fit=max\&auto=format\&n=phsN_J1K7MuyOqmI\&q=85\&s=a27a12a3c4932bb57307f18e0806bee4) 4. You are all set! ![](https://mintcdn.com/coingecko/phsN_J1K7MuyOqmI/images/docs/Screenshot2026-03-14at22.12.35.png?fit=max\&auto=format\&n=phsN_J1K7MuyOqmI\&q=85\&s=24cb39c344f1bf362b270e7c26b29bc9) ### Constraints for Claude.ai 🚧 The SKILL already includes built-in workarounds for Claude.ai platform restrictions, so most users won't run into issues.\ However, **if your API calls are failing silently or returning network errors**, check the following: #### Allowlist CoinGecko domains (Claude paid plans only) Claude blocks outbound requests to domains not on your personal allowlist. To fix this: ![](https://mintcdn.com/coingecko/na3hXlxdlDjqAJC9/images/docs/claude-user-allowlist.png?fit=max\&auto=format\&n=na3hXlxdlDjqAJC9\&q=85\&s=3d03f117a54604c9d97d92db0e5ba59b) 1. Go to [https://claude.ai/settings/capabilities](https://claude.ai/settings/capabilities), then scroll down to the "Domain allowlist" section. 2. Under "Additional allowed domains", add both: * `pro-api.coingecko.com` * `api.coingecko.com` #### Artifacts cannot make API calls directly * Claude Artifacts run in a sandboxed environment that blocks all external API calls — including CoinGecko. * The SKILL handles this automatically by instructing Claude to fetch data server-side first, then pass the results into the Artifact as static data. \ > **Tip** > > ### Use it with the CoinGecko MCP Server > > We recommend setting up the CoinGecko MCP Server together with the SKILL for the best experience, especially if you're on the **Claude free plan**. > > All under 5 minutes by following the instructions in our [MCP guides](/docs/ai-agent-hub/mcp-server). --- ## What's next? Once installed, try asking your agent / LLM questions like: > *"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 if I only left \$50 in my wallet? Which coins should I buy to maximize my returns based on the current market?"* > *"What are the top NFT collections this week?"* > *... have fun experimenting!* --- #### [Share your feedback](https://forms.gle/oiZ86EwNxeTxCVEL7) Tell us how you're using the CoinGecko SKILL and what we should improve! Have feedback or need help? Reach out to `eason.lim@coingecko[dot]com`.