### CoinMarketCap MCP Server Setup (Bash)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Provides shell commands for installing and running the CoinMarketCap MCP Server. Includes instructions for NPM installation, setting environment variables, and running the server, as well as installation via the Smithery CLI.

```bash
# Install via NPM
npm install -g @shinzolabs/coinmarketcap-mcp

# Run with environment variables
export COINMARKETCAP_API_KEY="your-key"
export SUBSCRIPTION_LEVEL="Standard"
coinmarketcap-mcp

# Or install via Smithery CLI (recommended)
npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp
```

--------------------------------

### Install CoinMarketCap MCP Server using Smithery CLI

Source: https://github.com/shinzo-labs/coinmarketcap-mcp/blob/main/README.md

This command installs the CoinMarketCap MCP server using Smithery's CLI. It will prompt for your CoinMarketCap API key and subscription level. Recommended for hosted/remote server setup.

```bash
npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp
```

--------------------------------

### Install Dependencies for CoinMarketCap MCP Server

Source: https://github.com/shinzo-labs/coinmarketcap-mcp/blob/main/README.md

This command installs the necessary project dependencies after cloning the CoinMarketCap MCP server repository. It uses `pnpm`, a performant package manager.

```bash
pnpm i
```

--------------------------------

### Configure NPX Local Install for MCP Client

Source: https://github.com/shinzo-labs/coinmarketcap-mcp/blob/main/README.md

This JavaScript snippet shows how to configure your MCP client's `config.json` file for a local installation of the CoinMarketCap MCP server using `npx`. It includes settings for the command, arguments, and environment variables like API key and subscription level.

```javascript
{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}
```

--------------------------------

### Get API Key Usage Information

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves details about your API key's usage, including credit limits and current usage statistics.

```APIDOC
## POST /keyInfo

### Description
Returns details about API key usage, credit limits, and subscription plan information.

### Method
POST

### Endpoint
/keyInfo

### Parameters
#### Request Body
- **tool** (string) - Required - Must be 'keyInfo'.

### Request Example
```json
{
  "tool": "keyInfo"
}
```

### Response
#### Success Response (200)
- **data** (object) - Usage and plan details.
  - **plan** (object) - Subscription plan information.
    - **credit_limit_daily** (integer) - Daily credit limit.
    - **credit_limit_monthly** (integer) - Monthly credit limit.
    - **rate_limit_minute** (integer) - Rate limit per minute.
  - **usage** (object) - Current usage statistics.
    - **current_day** (object) - Today's usage.
      - **credits_used** (integer) - Credits used today.
      - **credits_left** (integer) - Credits remaining today.
    - **current_month** (object) - This month's usage.
      - **credits_used** (integer) - Credits used this month.
      - **credits_left** (integer) - Credits remaining this month.

#### Response Example
```json
{
  "data": {
    "plan": {
      "credit_limit_daily": 10000,
      "credit_limit_monthly": 300000,
      "rate_limit_minute": 30
    },
    "usage": {
      "current_day": {
        "credits_used": 1250,
        "credits_left": 8750
      },
      "current_month": {
        "credits_used": 45000,
        "credits_left": 255000
      }
    }
  }
}
```
```

--------------------------------

### Get DEX Spot Pairs with Market Data

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches a paginated list of decentralized exchange (DEX) spot pairs, including the latest trading data, liquidity, and volume metrics.

```APIDOC
## GET /api/v1/tools/dexSpotPairs

### Description
Returns paginated list of decentralized exchange spot pairs with latest trading data, liquidity, and volume metrics.

### Method
GET

### Endpoint
/api/v1/tools/dexSpotPairs

### Parameters
#### Query Parameters
- **tool** (string) - Required - Must be "dexSpotPairsLatest".
- **params** (object) - Optional - Parameters for filtering and sorting DEX pairs:
  - **network_slug** (string) - Optional - Filter by a specific network (e.g., "ethereum").
  - **base_asset_symbol** (string) - Optional - Filter by the base asset symbol (e.g., "WETH").
  - **quote_asset_symbol** (string) - Optional - Filter by the quote asset symbol (e.g., "USDC").
  - **dex_slug** (string) - Optional - Filter by a specific DEX (e.g., "uniswap-v3").
  - **limit** (integer) - Optional - The number of results to return (default: 100).
  - **sort** (string) - Optional - The field to sort by (e.g., "volume_24h").
  - **sort_dir** (string) - Optional - The direction of sorting ("asc" or "desc", default: "desc").
  - **liquidity_min** (number) - Optional - Filter by minimum liquidity amount.

### Request Example
```json
{
  "tool": "dexSpotPairsLatest",
  "params": {
    "network_slug": "ethereum",
    "limit": 100,
    "sort": "volume_24h",
    "sort_dir": "desc",
    "liquidity_min": 100000
  }
}
```

### Response
#### Success Response (200)
- **data** (array) - A list of DEX spot pair objects, each containing trading and liquidity data.

#### Response Example
```json
[
  {
    "base_asset": {"symbol": "WETH", "asset_id": "..."},
    "quote_asset": {"symbol": "USDC", "asset_id": "..."},
    "total_liquidity": 100000000,
    "volume_24h": 50000000,
    "price": 1.0
  }
]
```
```

--------------------------------

### Get Cryptocurrency Metadata

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches static metadata for cryptocurrencies, including their names, logos, descriptions, official website URLs, and social media links.

```APIDOC
## GET /api/v1/cryptocurrency/info

### Description
Returns static metadata for cryptocurrencies including name, logo, description, website URLs, and social media links.

### Method
GET

### Endpoint
/api/v1/cryptocurrency/info

### Parameters
#### Query Parameters
- **symbol** (string) - Optional - Comma-separated list of cryptocurrency symbols (e.g., "BTC,ETH"). Use only one of `symbol` or `id`.
- **id** (string) - Optional - Comma-separated list of CoinMarketCap cryptocurrency IDs (e.g., "1,1027"). Use only one of `symbol` or `id`.
- **aux** (string) - Optional - Comma-separated list of additional fields to return (e.g., "logo,description,urls,tags,platform").

### Request Example
```json
{
  "tool": "getCryptoMetadata",
  "params": {
    "symbol": "BTC,ETH,USDT",
    "aux": "urls,logo,description,tags,platform"
  }
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains metadata for each requested cryptocurrency.
  - **[SYMBOL_OR_ID]** (object) - Metadata for a specific cryptocurrency.
    - **id** (integer) - The CoinMarketCap ID.
    - **name** (string) - The name.
    - **symbol** (string) - The symbol.
    - **logo** (string) - URL for the cryptocurrency logo.
    - **description** (string) - A brief description of the cryptocurrency.
    - **urls** (object) - Links to official resources.
      - **website** (array of strings) - Official website URLs.
      - **twitter** (array of strings) - Links to Twitter profiles.
      - (Other URL types like "message board", "reddit", "facebook", "youtube" may be included based on `aux` parameter).
    - **tags** (array of strings) - Relevant tags (e.g., "PoW", "Smart Contracts").
    - **platform** (object) - Information about the blockchain platform if it's a token.
      - **name** (string) - Platform name (e.g., "Ethereum").
      - **symbol** (string) - Platform symbol.
      - **token_address** (string) - The token's contract address on the platform.

#### Response Example
```json
{
  "data": {
    "BTC": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png",
      "description": "Bitcoin is a decentralized cryptocurrency...",
      "urls": {
        "website": ["https://bitcoin.org/"],
        "twitter": ["https://twitter.com/bitcoin"]
      },
      "tags": ["mineable", "PoW", "digital gold"],
      "platform": null
    },
    "ETH": {
      "id": 1027,
      "name": "Ethereum",
      "symbol": "ETH",
      "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1027.png",
      "description": "Ethereum is an open-source...",
      "urls": {
        "website": ["https://ethereum.org/"],
        "twitter": ["https://twitter.com/ethereum"]
      },
      "tags": ["PoS", "smart-contracts", "NFTs"],
      "platform": {
         "name": "Ethereum",
         "symbol": "ETH",
         "token_address": ""
      }
    }
  }
}
```
```

--------------------------------

### Get Exchange Information and Market Pairs

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves detailed metadata and trading pairs for centralized cryptocurrency exchanges.

```APIDOC
## GET /api/v1/tools/exchange

### Description
Returns detailed metadata and trading pairs for centralized cryptocurrency exchanges.

### Method
GET

### Endpoint
/api/v1/tools/exchange

### Parameters
#### Query Parameters
- **tool** (string) - Required - Specifies the tool to use. Can be "exchangeInfo", "exchangeMarketPairsLatest", or "exchangeQuotesLatest".
- **params** (object) - Required - Parameters for the chosen tool:
  - **slug** (string) - Required for "exchangeInfo" and "exchangeMarketPairsLatest" - The exchange slug (e.g., "binance"). Can be a comma-separated list for "exchangeQuotesLatest".
  - **aux** (string) - Optional for "exchangeInfo" - Additional details to include (e.g., "urls,logo,description").
  - **start** (integer) - Optional for "exchangeMarketPairsLatest" - The starting point for market pairs.
  - **limit** (integer) - Optional for "exchangeMarketPairsLatest" - The number of market pairs to retrieve.
  - **convert** (string) - Optional for "exchangeMarketPairsLatest" and "exchangeQuotesLatest" - The currency to convert prices to (e.g., "USD").

### Request Example
```json
{
  "tool": "exchangeInfo",
  "params": {
    "slug": "binance",
    "aux": "urls,logo,description"
  }
}
```

### Response
#### Success Response (200)
- The structure of the response varies depending on the `tool` used. See specific tool documentation for details.

#### Response Example (for exchangeInfo)
```json
{
  "data": {
    "id": 123,
    "slug": "binance",
    "name": "Binance",
    "urls": {"website": ["..."]},
    "logo": "...",
    "description": "..."
  }
}
```
```

--------------------------------

### Get Cryptocurrency Categories

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves information about cryptocurrency categories and the coins within each category.

```APIDOC
## GET /api/v1/tools/categories

### Description
Returns information about cryptocurrency categories and coins within each category.

### Method
GET

### Endpoint
/api/v1/tools/categories

### Parameters
#### Query Parameters
- **tool** (string) - Required - Specifies the tool to use. Can be "cryptoCategories" or "cryptoCategory".
- **params** (object) - Required - Parameters for the chosen tool:
  - **start** (integer) - Optional for "cryptoCategories" - The starting point for categories.
  - **limit** (integer) - Optional - The number of results to retrieve.
  - **id** (string) - Required for "cryptoCategory" - The ID of the category to retrieve details for.
  - **convert** (string) - Optional for "cryptoCategory" - The currency to convert category market data to (e.g., "USD").

### Request Example
```json
{
  "tool": "cryptoCategories",
  "params": {
    "start": 1,
    "limit": 100
  }
}
```

### Response
#### Success Response (200)
- The structure of the response varies depending on the `tool` used. See specific tool documentation for details.

#### Response Example (for cryptoCategory)
```json
{
  "data": {
    "id": "605e2ce9d41eae1066535f7c",
    "name": "DeFi",
    "title": "Decentralized Finance (DeFi)",
    "description": "DeFi coins...",
    "num_tokens": 450,
    "market_cap": 45000000000,
    "coins": [
      {
        "id": 1,
        "symbol": "ETH",
        "name": "Ethereum",
        "rank": 2,
        "price": 2000.00,
        "market_cap": 240000000000
      }
    ]
  }
}
```
```

--------------------------------

### Get Cryptocurrency News and Content

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves the latest cryptocurrency news articles, educational content from Alexandria, and community posts. Requires a Standard subscription or higher.

```APIDOC
## GET /api/v1/tools/content

### Description
Returns latest cryptocurrency news articles, Alexandria educational content, and community posts (requires Standard subscription or higher).

### Method
GET

### Endpoint
/api/v1/tools/content

### Parameters
#### Query Parameters
- **tool** (string) - Required - Specifies the tool to use. Can be "contentLatest", "contentPostsTop", or "contentPostsComments".
- **params** (object) - Required - Parameters for the chosen tool:
  - **symbol** (string) - Optional for "contentLatest" - Filter by cryptocurrency symbol (e.g., "BTC").
  - **limit** (integer) - Optional - The number of results to retrieve.
  - **news_type** (string) - Optional for "contentLatest" - Filter by news type (e.g., "news").
  - **start** (integer) - Optional for "contentPostsTop" - The starting point for posts.
  - **id** (string) - Required for "contentPostsComments" - The ID of the post to retrieve comments for.

### Request Example
```json
{
  "tool": "contentLatest",
  "params": {
    "symbol": "BTC",
    "limit": 10,
    "news_type": "news"
  }
}
```

### Response
#### Success Response (200)
- The structure of the response varies depending on the `tool` used. See specific tool documentation for details.

#### Response Example (for contentLatest)
```json
{
  "data": [
    {
      "title": "Bitcoin Price Surges Amidst Positive Market Sentiment",
      "url": "...",
      "source": "CryptoNews",
      "published_at": "2024-01-15T10:00:00.000Z"
    }
  ]
}
```
```

--------------------------------

### Get Trending Gainers and Losers

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves the biggest cryptocurrency price gainers and losers over a specified time period. Requires a Startup subscription or higher.

```APIDOC
## GET /api/v1/tools/cryptoTrending

### Description
Returns the biggest price gainers and losers over a specified time period (requires Startup subscription or higher).

### Method
GET

### Endpoint
/api/v1/tools/cryptoTrending

### Parameters
#### Query Parameters
- **tool** (string) - Required - Must be "cryptoTrendingGainersLosers".
- **params** (object) - Required - Parameters for fetching trending data:
  - **time_period** (string) - Required - The time period to consider (e.g., "24h", "7d").

### Request Example
```json
{
  "tool": "cryptoTrendingGainersLosers",
  "params": {
    "time_period": "24h"
  }
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains lists of gainers and losers.
  - **gainers** (array) - List of cryptocurrencies that gained the most.
    - **id** (integer) - The cryptocurrency ID.
    - **symbol** (string) - The cryptocurrency symbol.
    - **percent_change** (number) - The percentage change in price.
    - **price** (number) - The current price.
    - **volume_24h** (number) - The trading volume over the last 24 hours.
  - **losers** (array) - List of cryptocurrencies that lost the most.
    - **id** (integer) - The cryptocurrency ID.
    - **symbol** (string) - The cryptocurrency symbol.
    - **percent_change** (number) - The percentage change in price.
    - **price** (number) - The current price.
    - **volume_24h** (number) - The trading volume over the last 24 hours.

#### Response Example
```json
{
  "data": {
    "gainers": [
      {
        "id": 1234,
        "symbol": "XYZ",
        "percent_change": 45.67,
        "price": 1.23,
        "volume_24h": 5000000
      }
    ],
    "losers": [
      {
        "id": 5678,
        "symbol": "ABC",
        "percent_change": -23.45,
        "price": 0.56,
        "volume_24h": 3000000
      }
    ]
  }
}
```
```

--------------------------------

### Get DEX Spot Pairs with Market Data (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches a paginated list of decentralized exchange spot pairs, including the latest trading data, liquidity, and volume metrics. Supports filtering by network, specific tokens, and DEX.

```javascript
// Example: Get DEX pairs for Ethereum network
{
  "tool": "dexSpotPairsLatest",
  "params": {
    "network_slug": "ethereum",
    "limit": 100,
    "sort": "volume_24h",
    "sort_dir": "desc",
    "liquidity_min": 100000
  }
}

// Example: Get specific token pairs
{
  "tool": "dexSpotPairsLatest",
  "params": {
    "base_asset_symbol": "WETH",
    "quote_asset_symbol": "USDC",
    "dex_slug": "uniswap-v3",
    "limit": 10
  }
}
```

--------------------------------

### Get API Key Usage Information (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves details about API key usage, including credit limits and subscription plan information. This endpoint helps users monitor their API consumption and understand their current plan's constraints.

```javascript
// Example: Check API key status and usage
{
  "tool": "keyInfo"
}

// Response:
{
  "data": {
    "plan": {
      "credit_limit_daily": 10000,
      "credit_limit_monthly": 300000,
      "rate_limit_minute": 30
    },
    "usage": {
      "current_day": {
        "credits_used": 1250,
        "credits_left": 8750
      },
      "current_month": {
        "credits_used": 45000,
        "credits_left": 255000
      }
    }
  }
}
```

--------------------------------

### Get Global Cryptocurrency Market Metrics

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves aggregated market statistics for the entire cryptocurrency ecosystem, including total market capitalization, Bitcoin dominance, and the number of active cryptocurrencies.

```APIDOC
## GET /api/v1/global-metrics/latest

### Description
Returns aggregated market statistics for the entire cryptocurrency market including total market cap, Bitcoin dominance, and active cryptocurrencies.

### Method
GET

### Endpoint
/api/v1/global-metrics/latest

### Parameters
#### Query Parameters
- **convert** (string) - Optional - Comma-separated list of cryptocurrencies or fiat currencies to convert values to (e.g., "USD,EUR").

### Request Example
```json
{
  "tool": "globalMetricsLatest",
  "params": {
    "convert": "USD"
  }
}
```

### Response
#### Success Response (200)
- **active_cryptocurrencies** (integer) - Number of active cryptocurrencies.
- **total_cryptocurrencies** (integer) - Total number of cryptocurrencies listed.
- **active_market_pairs** (integer) - Number of active trading pairs across exchanges.
- **active_exchanges** (integer) - Number of active exchanges.
- **total_exchanges** (integer) - Total number of exchanges listed.
- **quote** (object) - Contains aggregated metrics converted to specified currencies.
  - **[CONVERTED_CURRENCY]** (object) - Metrics in the converted currency.
    - **total_market_cap** (number) - Total market capitalization of all cryptocurrencies.
    - **total_volume_24h** (number) - Total trading volume over the last 24 hours.
    - **total_volume_7d** (number) - Total trading volume over the last 7 days.
    - **total_market_cap_excluding_stablecoins** (number) - Total market cap excluding stablecoins.
    - **total_volume_24h_excluding_stablecoins** (number) - Total 24h volume excluding stablecoins.
    - **btc_dominance** (number) - Percentage of total market cap held by Bitcoin.
    - **eth_dominance** (number) - Percentage of total market cap held by Ethereum.
    - **degen_index** (number) - A proprietary index measuring market sentiment (if available).

#### Response Example
```json
{
  "status": {
    "timestamp": "2026-01-10T17:47:00.000Z",
    "error_code": 0
  },
  "data": {
    "active_cryptocurrencies": 9876,
    "total_cryptocurrencies": 15432,
    "active_market_pairs": 67890,
    "active_exchanges": 500,
    "total_exchanges": 700,
    "quote": {
      "USD": {
        "total_market_cap": 1850000000000,
        "total_volume_24h": 95000000000,
        "total_volume_7d": 600000000000,
        "total_market_cap_excluding_stablecoins": 1500000000000,
        "total_volume_24h_excluding_stablecoins": 70000000000,
        "btc_dominance": 45.6,
        "eth_dominance": 18.2,
        "degen_index": 55.3
      }
    }
  }
}
```
```

--------------------------------

### Get OHLCV Historical Data for Cryptocurrencies

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves historical Open, High, Low, Close, and Volume (OHLCV) data for cryptocurrencies. Supports flexible time intervals and requires a Startup subscription or higher.

```APIDOC
## GET /api/v1/tools/cryptoOhlcv

### Description
Returns historical Open, High, Low, Close, Volume data for cryptocurrencies with flexible time intervals (requires Startup subscription or higher).

### Method
GET

### Endpoint
/api/v1/tools/cryptoOhlcv

### Parameters
#### Query Parameters
- **tool** (string) - Required - Must be "cryptoOhlcvHistorical".
- **params** (object) - Required - Parameters for fetching OHLCV data:
  - **symbol** (string) - Optional - The cryptocurrency symbol (e.g., "BTC"). Mutually exclusive with `id`.
  - **id** (string) - Optional - The cryptocurrency ID (e.g., "1027"). Mutually exclusive with `symbol`.
  - **time_period** (string) - Optional - The time period for daily data (e.g., "daily"). Use when `interval` is not specified.
  - **interval** (string) - Optional - The interval for intraday data (e.g., "hourly"). Use when `time_period` is not specified.
  - **count** (integer) - Optional - The number of historical periods to retrieve (used with `time_period`).
  - **time_start** (string) - Optional - The start timestamp for the data range (ISO 8601 format).
  - **time_end** (string) - Optional - The end timestamp for the data range (ISO 8601 format).
  - **convert** (string) - Optional - The currency to convert the prices to (e.g., "USD").

### Request Example
```json
{
  "tool": "cryptoOhlcvHistorical",
  "params": {
    "symbol": "BTC",
    "time_period": "daily",
    "count": 30,
    "convert": "USD"
  }
}
```

### Response
#### Success Response (200)
- **data** (array) - A list of historical OHLCV data points, each containing open, high, low, close prices, and volume.

#### Response Example
```json
[
  {
    "time_open": "2024-01-01T00:00:00.000Z",
    "time_close": "2024-01-01T23:59:59.000Z",
    "open": 42000.00,
    "high": 43000.00,
    "low": 41500.00,
    "close": 42500.00,
    "volume": 50000000000,
    "market_cap": 800000000000
  }
]
```
```

--------------------------------

### Get Cryptocurrency Metadata (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches static metadata for cryptocurrencies, including names, logos, descriptions, website URLs, and social media links. The `symbol` parameter accepts a comma-separated list of symbols, and `aux` specifies additional metadata fields to retrieve.

```javascript
// Example: Get metadata for multiple cryptocurrencies by symbol
{
  "tool": "getCryptoMetadata",
  "params": {
    "symbol": "BTC,ETH,USDT",
    "aux": "urls,logo,description,tags,platform"
  }
}
```

```javascript
// Response includes:
{
  "data": {
    "BTC": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png",
      "description": "Bitcoin is a decentralized cryptocurrency...",
      "urls": {
        "website": ["https://bitcoin.org/"],
        "twitter": ["https://twitter.com/bitcoin"]
      }
    }
  }
}
```

--------------------------------

### Get Trending Gainers and Losers (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Returns the biggest price gainers and losers over a specified time period. This functionality requires a Startup subscription or higher. The response includes detailed information for both gainers and losers.

```javascript
// Example: Get 24h gainers and losers
{
  "tool": "cryptoTrendingGainersLosers",
  "params": {
    "time_period": "24h"
  }
}

// Response includes:
{
  "data": {
    "gainers": [
      {
        "id": 1234,
        "symbol": "XYZ",
        "percent_change": 45.67,
        "price": 1.23,
        "volume_24h": 5000000
      }
    ],
    "losers": [
      {
        "id": 5678,
        "symbol": "ABC",
        "percent_change": -23.45,
        "price": 0.56,
        "volume_24h": 3000000
      }
    ]
  }
}
```

--------------------------------

### Get Exchange Information and Market Pairs (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves detailed metadata and trading pairs for centralized cryptocurrency exchanges. This includes information like URLs, logos, and descriptions. Fetching market pairs or quotes may require a Standard subscription.

```javascript
// Example: Get Binance exchange information
{
  "tool": "exchangeInfo",
  "params": {
    "slug": "binance",
    "aux": "urls,logo,description"
  }
}

// Example: Get all trading pairs for an exchange (requires Standard subscription)
{
  "tool": "exchangeMarketPairsLatest",
  "params": {
    "slug": "binance",
    "start": 1,
    "limit": 100,
    "convert": "USD"
  }
}

// Example: Get exchange latest quotes (requires Standard subscription)
{
  "tool": "exchangeQuotesLatest",
  "params": {
    "slug": "binance,coinbase,kraken",
    "convert": "USD"
  }
}
```

--------------------------------

### List All Cryptocurrencies with Market Data (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves a paginated list of all active cryptocurrencies with their latest market data. Supports filtering by price range, volume, and sorting options like market cap. The `start`, `limit`, `sort`, and `sort_dir` parameters control pagination and ordering.

```javascript
// Example: Get top 10 cryptocurrencies by market cap
{
  "tool": "allCryptocurrencyListings",
  "params": {
    "start": 1,
    "limit": 10,
    "sort": "market_cap",
    "sort_dir": "desc",
    "convert": "USD"
  }
}
```

```javascript
// Example: Filter by price range and volume
{
  "tool": "allCryptocurrencyListings",
  "params": {
    "price_min": 1,
    "price_max": 100,
    "volume_24h_min": 1000000,
    "limit": 50,
    "convert": "USD"
  }
}
```

--------------------------------

### Get Global Cryptocurrency Market Metrics (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves aggregated statistics for the entire cryptocurrency market, including total market capitalization, Bitcoin dominance, and the number of active cryptocurrencies. The `convert` parameter specifies the desired fiat currency for reporting.

```javascript
// Example: Get current global metrics
{
  "tool": "globalMetricsLatest",
  "params": {
    "convert": "USD"
  }
}
```

```javascript
// Response:
{
  "data": {
    "active_cryptocurrencies": 9876,
    "total_cryptocurrencies": 15432,
    "active_market_pairs": 67890,
    "quote": {
      "USD": {
        "total_market_cap": 1850000000000,
        "total_volume_24h": 95000000000,
        "btc_dominance": 45.6,
        "eth_dominance": 18.2
      }
    }
  }
}
```

--------------------------------

### Get Latest Cryptocurrency Market Quotes

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves the latest market data for one or more cryptocurrencies, including their current price, market capitalization, trading volume, and percentage changes over various periods.

```APIDOC
## POST /api/v1/cryptocurrency/quotes/latest

### Description
Returns current market data for one or more cryptocurrencies including price, market cap, volume, and percentage changes.

### Method
POST

### Endpoint
/api/v1/cryptocurrency/quotes/latest

### Parameters
#### Query Parameters
- **symbol** (string) - Required - Comma-separated list of cryptocurrency symbols (e.g., "BTC,ETH").
- **convert** (string) - Optional - Comma-separated list of cryptocurrencies or fiat currencies to convert prices to (e.g., "USD,EUR").

### Request Body
```json
{
  "tool": "cryptoQuotesLatest",
  "params": {
    "symbol": "BTC",
    "convert": "USD"
  }
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains market data for each requested symbol.
  - **[SYMBOL]** (object) - Market data for a specific cryptocurrency.
    - **id** (integer) - The CoinMarketCap ID of the cryptocurrency.
    - **name** (string) - The name of the cryptocurrency.
    - **symbol** (string) - The symbol of the cryptocurrency.
    - **quote** (object) - Contains conversion data for requested currencies.
      - **[CONVERTED_CURRENCY]** (object) - Market data in the converted currency.
        - **price** (number) - The current price.
        - **volume_24h** (number) - The trading volume over the last 24 hours.
        - **market_cap** (number) - The market capitalization.
        - **percent_change_24h** (number) - The percentage change in price over the last 24 hours.

#### Response Example
```json
{
  "status": {
    "timestamp": "2026-01-10T17:47:00.000Z",
    "error_code": 0
  },
  "data": {
    "BTC": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "quote": {
        "USD": {
          "price": 45000.50,
          "volume_24h": 28500000000,
          "market_cap": 850000000000,
          "percent_change_24h": 2.45
        }
      }
    }
  }
}
```
```

--------------------------------

### Get Historical Cryptocurrency Quotes

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves historical market quotes for cryptocurrencies. This feature requires a Hobbyist subscription or higher and supports advanced time-based intervals.

```APIDOC
## POST /cryptoQuotesHistoricalV3

### Description
Returns historical market quotes with advanced time-based intervals. Requires Hobbyist subscription or higher.

### Method
POST

### Endpoint
/cryptoQuotesHistoricalV3

### Parameters
#### Request Body
- **tool** (string) - Required - Must be 'cryptoQuotesHistoricalV3'.
- **params** (object) - Required - Parameters for fetching historical quotes.
  - **symbol** (string) - Optional - Cryptocurrency symbol (e.g., 'BTC').
  - **id** (string) - Optional - Cryptocurrency ID (e.g., '1027' for Ethereum).
  - **interval** (string) - Required - Time interval (e.g., '1h', 'daily').
  - **count** (integer) - Optional - Number of intervals to retrieve.
  - **convert** (string) - Optional - Currency to convert to (e.g., 'USD').
  - **time_start** (string) - Optional - Start timestamp (ISO 8601 format).
  - **time_end** (string) - Optional - End timestamp (ISO 8601 format).

### Request Example
```json
{
  "tool": "cryptoQuotesHistoricalV3",
  "params": {
    "symbol": "BTC",
    "interval": "1h",
    "count": 168,
    "convert": "USD"
  }
}
```

```json
{
  "tool": "cryptoQuotesHistoricalV3",
  "params": {
    "id": "1027",
    "time_start": "2024-01-01T00:00:00Z",
    "time_end": "2024-12-31T23:59:59Z",
    "interval": "daily",
    "convert": "USD"
  }
}
```

### Response
#### Success Response (200)
- **data** (array) - Array of historical quote objects.
  - **timestamp** (string) - Timestamp of the quote.
  - **quote** (object) - Quote details in the specified conversion currency.
```

--------------------------------

### Get OHLCV Historical Data for Cryptocurrencies (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves historical Open, High, Low, Close, and Volume (OHLCV) data for cryptocurrencies. Supports flexible time intervals and requires a Startup subscription or higher. Data can be converted to a specified currency.

```javascript
// Example: Get daily Bitcoin OHLCV for last 30 days
{
  "tool": "cryptoOhlcvHistorical",
  "params": {
    "symbol": "BTC",
    "time_period": "daily",
    "count": 30,
    "convert": "USD"
  }
}

// Example: Get hourly Ethereum data for specific date range
{
  "tool": "cryptoOhlcvHistorical",
  "params": {
    "id": "1027",
    "interval": "hourly",
    "time_start": "2024-01-01T00:00:00Z",
    "time_end": "2024-01-07T23:59:59Z",
    "convert": "USD"
  }
}
```

--------------------------------

### Get Fear and Greed Index

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves the latest or historical Crypto Fear & Greed Index values, indicating market sentiment on a scale from 0 (extreme fear) to 100 (extreme greed).

```APIDOC
## GET /api/v1/tools/fearAndGreed

### Description
Returns the latest or historical Crypto Fear & Greed Index values which measure market sentiment on a scale from 0 (extreme fear) to 100 (extreme greed).

### Method
GET

### Endpoint
/api/v1/tools/fearAndGreed

### Parameters
#### Query Parameters
- **tool** (string) - Required - Specifies the tool to use. Use "fearAndGreedLatest" for the latest index or "fearAndGreedHistorical" for historical data.
- **params** (object) - Optional - Additional parameters for historical data:
  - **start** (integer) - Optional - The starting point for historical data. 
  - **limit** (integer) - Optional - The number of historical data points to retrieve.

### Request Example
```json
{
  "tool": "fearAndGreedLatest"
}
```

### Response
#### Success Response (200)
- **data** (object) - Contains the Fear and Greed Index data.
  - **value** (integer) - The Fear and Greed Index value.
  - **value_classification** (string) - The classification of the index value (e.g., "Greed", "Fear").
  - **timestamp** (string) - The timestamp of the data.

#### Response Example
```json
{
  "data": {
    "value": 65,
    "value_classification": "Greed",
    "timestamp": "2026-01-10T17:47:00.000Z"
  }
}
```
```

--------------------------------

### Get Cryptocurrency News and Content (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches the latest cryptocurrency news articles, Alexandria educational content, and community posts. This service requires a Standard subscription or higher. Various parameters allow filtering by symbol, type, and popularity.

```javascript
// Example: Get latest news for Bitcoin
{
  "tool": "contentLatest",
  "params": {
    "symbol": "BTC",
    "limit": 10,
    "news_type": "news"
  }
}

// Example: Get top community posts
{
  "tool": "contentPostsTop",
  "params": {
    "start": 1,
    "limit": 20
  }
}

// Example: Get comments for a specific post
{
  "tool": "contentPostsComments",
  "params": {
    "id": "12345",
    "limit": 50
  }
}
```

--------------------------------

### Get Crypto Fear and Greed Index (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves the latest or historical Crypto Fear & Greed Index values. This tool measures market sentiment on a scale from 0 (extreme fear) to 100 (extreme greed).

```javascript
// Example: Get current Fear and Greed Index
{
  "tool": "fearAndGreedLatest"
}

// Response:
{
  "data": {
    "value": 65,
    "value_classification": "Greed",
    "timestamp": "2026-01-10T17:47:00.000Z"
  }
}

// Example: Get historical Fear and Greed data
{
  "tool": "fearAndGreedHistorical",
  "params": {
    "start": 1,
    "limit": 30
  }
}
```

--------------------------------

### Get Cryptocurrency Categories (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves information about cryptocurrency categories and the coins associated with each category. It allows fetching all categories or specific category details, including metadata and coin lists. The 'convert' parameter can specify the currency for market data.

```javascript
// Example: Get all cryptocurrency categories
{
  "tool": "cryptoCategories",
  "params": {
    "start": 1,
    "limit": 100
  }
}

// Example: Get specific category details
{
  "tool": "cryptoCategory",
  "params": {
    "id": "605e2ce9d41eae1066535f7c",
    "limit": 50,
    "convert": "USD"
  }
}

// Response includes category metadata and coins
{
  "data": {
    "id": "605e2ce9d41eae1066535f7c",
    "name": "DeFi",
    "title": "Decentralized Finance (DeFi)",
    "description": "DeFi coins...",
    "num_tokens": 450,
    "market_cap": 45000000000,
    "coins": [...] 
  }
}
```

--------------------------------

### Get CoinMarketCap 100 Index (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Fetches the CoinMarketCap 100 Index (CMC100) value and its constituent cryptocurrencies with their respective weights. Supports retrieving the latest index data or historical values over a specified interval.

```javascript
// Example: Get latest CMC100 Index
{
  "tool": "cmc100IndexLatest"
}

// Response includes:
{
  "data": {
    "index_value": 1245.67,
    "timestamp": "2026-01-10T17:47:00.000Z",
    "constituents": [
      {
        "id": 1,
        "symbol": "BTC",
        "weight": 0.45
      },
      {
        "id": 1027,
        "symbol": "ETH",
        "weight": 0.18
      }
    ]
  }
}

// Example: Get historical CMC100 values
{
  "tool": "cmc100IndexHistorical",
  "params": {
    "interval": "daily",
    "count": 30
  }
}
```

--------------------------------

### Get Latest Cryptocurrency Market Quotes (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves current market data for one or more cryptocurrencies, including price, market cap, and volume. This function requires specifying the cryptocurrency symbol and the desired conversion currency.

```javascript
{
  "tool": "cryptoQuotesLatest",
  "params": {
    "symbol": "BTC",
    "convert": "USD"
  }
}
```

```javascript
// Response:
{
  "status": {
    "timestamp": "2026-01-10T17:47:00.000Z",
    "error_code": 0
  },
  "data": {
    "BTC": {
      "id": 1,
      "name": "Bitcoin",
      "symbol": "BTC",
      "quote": {
        "USD": {
          "price": 45000.50,
          "volume_24h": 28500000000,
          "market_cap": 850000000000,
          "percent_change_24h": 2.45
        }
      }
    }
  }
}
```

--------------------------------

### Get Historical Cryptocurrency Quotes (JavaScript)

Source: https://context7.com/shinzo-labs/coinmarketcap-mcp/llms.txt

Retrieves historical market quotes with advanced time-based intervals. Requires a Hobbyist subscription or higher. Supports fetching by symbol or ID, with options for interval, count, start/end times, and conversion currency.

```javascript
// Example: Get hourly Bitcoin quotes for last 7 days
{
  "tool": "cryptoQuotesHistoricalV3",
  "params": {
    "symbol": "BTC",
    "interval": "1h",
    "count": 168,
    "convert": "USD"
  }
}

// Example: Get daily Ethereum quotes for specific date range
{
  "tool": "cryptoQuotesHistoricalV3",
  "params": {
    "id": "1027",
    "time_start": "2024-01-01T00:00:00Z",
    "time_end": "2024-12-31T23:59:59Z",
    "interval": "daily",
    "convert": "USD"
  }
}
```

--------------------------------

### Configure Build from Source for MCP Client

Source: https://github.com/shinzo-labs/coinmarketcap-mcp/blob/main/README.md

This JavaScript snippet demonstrates how to configure your MCP client's `config.json` file when the CoinMarketCap MCP server is built from source. It specifies the command to run (Node.js) and the path to the main index file, along with necessary environment variables.

```javascript
{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}
```

--------------------------------

### Clone CoinMarketCap MCP Server Repository

Source: https://github.com/shinzo-labs/coinmarketcap-mcp/blob/main/README.md

This bash command clones the CoinMarketCap MCP server repository from GitHub to your local machine. This is the first step for building the server from source.

```bash
git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git
```