# CoinMarketCap AI Agent Skills

GitHub repo: [coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap](https://github.com/coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap)

Use this page when you want reusable workflows on top of CoinMarketCap data access. Skills are most useful when you want your agent to follow a repeatable pattern instead of improvising every request from scratch.

If you want a terminal-native runtime instead of a reusable skill, use [CMC CLI](/ai-agent-hub/cmc-cli).

## Choose a skill type

| If you want to... | Start here | Best for |
|---|---|---|
| Use CoinMarketCap through terminal-native command workflows | CLI Skills | Shell-first agents, market reports, and single-coin research |
| Use live CoinMarketCap data through MCP with structured workflows | MCP Skills | Market reports, token research, and other repeatable MCP-based tasks |
| Pay per request with x402 and keep the workflow reusable | x402 Skills | On-chain payment flows without an API key |
| Build direct REST integrations with implementation guidance | API Integration Skills | Custom apps, agents, and backends that call the API directly |

- [CLI Skills](/ai-agent-hub/skills/cmc-cli): Terminal-native skill workflows for market reports, coin research, and command selection.
- [MCP Skills](/ai-agent-hub/skills/cmc-mcp): Real-time crypto data via Model Context Protocol. Includes market reports and token research.
- [x402 Skills](/ai-agent-hub/skills/cmc-x402): Pay-per-request data access via USDC on Base. No API key required.
- [API Integration Skills](/ai-agent-hub/skills/cmc-api-crypto): Direct REST API integration for cryptocurrency, DEX, exchange, and market data.

## When skills help

- You want a repeatable workflow such as a market report or token research process
- You want to give an AI agent a stronger default pattern for working with CMC data
- You want integration guidance that is narrower than the full API reference

## Need a runtime instead?

CMC CLI is still a runtime, not just a skill family. Use the runtime page for install, authentication, and command-level setup, then use the CLI skills below when you want reusable prompt guidance on top of that runtime.

- [CMC CLI](/ai-agent-hub/cmc-cli): Use a shell-native CoinMarketCap runtime for installation, scripting, JSON output, CSV export, and agent-friendly command workflows.

## CLI Skills

| Skill | Description |
|-------|-------------|
| [CMC CLI](/ai-agent-hub/skills/cmc-cli) | Core command-selection guidance for terminal-native CoinMarketCap workflows, including output rules, workflow ordering, and common mistakes. |
| [Market Skill](/ai-agent-hub/skills/market-skill) | Market-report workflow for snapshots, movers, BTC/ETH anchors, and news flow using shipped `cmc` commands only. |
| [Coin Research](/ai-agent-hub/skills/coin-research) | Single-asset research workflow that combines identity resolution, quotes, history, pairs, market context, and sentiment. |

## MCP Skills (Real-time Data)

| Skill | Description |
|-------|-------------|
| [CMC MCP](/ai-agent-hub/skills/cmc-mcp) | Fetches cryptocurrency market data using the CoinMarketCap MCP. Provides prices, technical analysis, news, holder metrics, trending narratives, and global market data. |
| [Market Report](/ai-agent-hub/skills/market-report) | Generates comprehensive daily/weekly market reports combining global metrics, fear/greed, trending narratives, derivatives data, and upcoming catalysts. |
| [Crypto Research](/ai-agent-hub/skills/crypto-research) | Performs due diligence on any token with structured analysis of fundamentals, tokenomics, holder distribution, technicals, and risk factors. |

## x402 Skills (Pay-per-Request)

| Skill | Description |
|-------|-------------|
| [CMC x402](/ai-agent-hub/skills/cmc-x402) | Access CMC data via x402 pay-per-request protocol. Pay $0.01 USDC per request on Base. No API key required. |

## API Integration Skills

| Skill | Description | Endpoints |
|-------|-------------|-----------|
| [Cryptocurrency API](/ai-agent-hub/skills/cmc-api-crypto) | Cryptocurrency data APIs for listings, quotes, OHLCV, categories, trending, and market pairs. | 16 endpoints |
| [DEX API](/ai-agent-hub/skills/cmc-api-dex) | DEX APIs for on-chain token data, prices, pools, transactions, and security analysis. | 18 endpoints |
| [Exchange API](/ai-agent-hub/skills/cmc-api-exchange) | Centralized exchange APIs for exchange info, listings, volume, market pairs, and assets. | 7 endpoints |
| [Market API](/ai-agent-hub/skills/cmc-api-market) | Market-wide APIs for global metrics, fear/greed, CMC indices, community trends, content, and charts. | 19 endpoints |

## How to choose quickly

- Choose **CLI Skills** if you want reusable prompt guidance on top of the CoinMarketCap CLI
- Choose **CMC CLI** if you want command-selection guidance and workflow ordering
- Choose **Market Skill** if you want a market snapshot or crypto morning brief
- Choose **Coin Research** if you want a quick single-asset research pass
- Choose **MCP Skills** if you are already connecting through the CoinMarketCap MCP server
- Choose **x402 Skills** if you want pay-per-request usage and no API key
- Choose **API Integration Skills** if you are building your own application logic with the REST API

## Installation

### CLI Skills

Start with the [CoinMarketCap CLI runtime page](/ai-agent-hub/cmc-cli), then use the CLI skills for structured prompt guidance:

```bash
brew install coinmarketcap-official/CoinMarketCap-CLI/cmc
cmc auth
cmc status -o json
```

The CLI skills map to these three public docs pages:

- `CMC CLI` for command selection and output rules
- `Market Skill` for market snapshots and report generation
- `Coin Research` for single-asset analysis

### MCP Skills

```json
{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "your-api-key"
      }
    }
  }
}
```

Get your API key from [https://pro.coinmarketcap.com/login](https://pro.coinmarketcap.com/login)

### x402 Skills

```bash
npm install @x402/axios @x402/evm viem
```

Fund a wallet with USDC on Base (Chain ID: 8453).

### API Skills

All API requests use the base URL `https://pro-api.coinmarketcap.com` with the `X-CMC_PRO_API_KEY` header.

Get your API key from [https://pro.coinmarketcap.com/login](https://pro.coinmarketcap.com/login)

## Source

These skills are open source and available on GitHub:
[coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap](https://github.com/coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap)