CoinPaprika

Official31 tools

by coinpaprika · JavaScript

Real-time crypto market data: prices, tickers, exchanges, OHLCV candles, and metadata.

com.coinpaprika/coinpaprika — Model Context Protocol (MCP) Server

The com.coinpaprika/coinpaprika MCP server provides real-time crypto market data, including prices, tickers, exchanges, OHLCV candles, and related metadata. It is designed to expose these market information sources for consumption through the MCP server interface.

🛠️ Key Features

Real-time crypto market data
Prices
Tickers
Exchanges
OHLCV candles
Metadata

🚀 Use Cases

Query current crypto prices and related identifiers (tickers)
Retrieve exchange information
Access OHLCV candle data for market analysis
Use associated metadata alongside market metrics

⚡ Developer Benefits

Centralized access to multiple crypto market data types
Consistent exposure of prices, tickers, exchanges, candles, and metadata

⚠️ Limitations

The available description does not specify supported assets, update frequency, authentication, or historical coverage beyond “real-time.”

Topics

ai-toolsbitcoinclaudecoinpaprikacrypto-apicryptocurrencycursormarket-datamcpmodel-context-protocol

Captured live from the server via tools/list.

getCoins

List available coins (id, name, symbol, rank). Use to discover coins or map a name to an id. Does NOT include prices; for prices use getTickers or getTickersById.

Parameters2

limit	number	optional	Optional. Items per page (default 50, max 250). Server clamps requests above 250.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Optional. Items per page (default 50, max 250). Server clamps requests above 250."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinById

Get descriptive project information about a coin (description, links, team, tags). Does NOT include price; for price/market cap use getTickersById.

Parameters2

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinEvents

Get the timeline of events for a coin (launches, partnerships, hard forks, conference talks) with dates and descriptions. Use when asked 'what is happening with X', 'upcoming events for Ethereum', 'X roadmap events'. For prices or market data use getTickersById.

Parameters3

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinExchanges

List the exchanges that LIST a specific coin (venue names only). Use for 'which exchanges list X', 'is X on Coinbase', 'where is X listed'. For where to BUY with per-market price and volume use getCoinMarkets; for the coin's live price use getTickersById.

Parameters3

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinMarkets

Get the specific markets and trading pairs where a coin trades, with per-market price and 24h volume. Use for 'where can I buy X', 'X price on Binance', 'best market for X'. For just the list of exchange names use getCoinExchanges.

Parameters4

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
quotes	string	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "quotes": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinOHLCVLatest

Get the latest full-day OHLC candle (open/high/low/close plus volume) for a coin. For the live spot price use getTickersById.

Parameters3

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
quote	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "quote": {
      "type": "string",
      "default": "usd"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinOHLCVToday

Get today's in-progress OHLC candle for a coin. For the current spot price use getTickersById; for past candles use getCoinOHLCVHistorical.

Parameters3

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
quote	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "quote": {
      "type": "string",
      "default": "usd"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCoinOHLCVHistorical

Get OHLC candles (open/high/low/close plus volume) for a coin over a date range, for price charts, backtests and technical analysis. Use for 'daily chart for the last month', 'hourly candles since Jan 1'. For a single past date's spot value use getTickersHistoricalById; not for the current price. Requires Starter+ plan.

Parameters7

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
start	string	required	Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC.
end	string	optional	Optional end timestamp. Same formats as start. Defaults to now if omitted.
limit	number	optional	Optional. Number of candles (default 50, max 250).
interval	string	optional	Optional. Candle interval. Defaults to '24h' for daily candles.
quote	string	optional	Optional quote currency code (default 'usd'). Examples: 'usd', 'btc', 'eth'.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "start": {
      "type": "string",
      "description": "Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC."
    },
    "end": {
      "type": "string",
      "description": "Optional end timestamp. Same formats as start. Defaults to now if omitted."
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Optional. Number of candles (default 50, max 250)."
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "10m",
        "15m",
        "30m",
        "1h",
        "6h",
        "12h",
        "24h"
      ],
      "default": "24h",
      "description": "Optional. Candle interval. Defaults to '24h' for daily candles."
    },
    "quote": {
      "type": "string",
      "default": "usd",
      "description": "Optional quote currency code (default 'usd'). Examples: 'usd', 'btc', 'eth'."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "start",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTickers

Get current prices, market caps and 24h changes for the top cryptocurrencies ranked by market cap. Use for 'top 5 coins', 'top crypto today', 'biggest cryptocurrencies', or a market snapshot. For one specific coin use getTickersById.

Parameters3

quotes	string	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "quotes": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTickersById

Get the current price, market cap, 24h change and volume of a specific cryptocurrency in USD (or another quote currency). Use when asked 'what is the price of X', 'how much is Bitcoin worth', 'BTC to USD', 'ETH price now'. For past prices use getTickersHistoricalById.

Parameters3

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
quotes	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "quotes": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTickersHistoricalById

Get a coin's price and market cap at a single past date or time (a point-in-time value). Use for 'price of BTC last Tuesday', 'ETH market cap on 2024-01-01'. For OHLC chart candles over a range use getCoinOHLCVHistorical, not this. Not for the current price (use getTickersById). Requires Starter+ plan.

Parameters7

coinId	string	required	Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id.
start	string	required	Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC.
end	string	optional	Optional end timestamp. Same formats as start. Defaults to now if omitted.
limit	number	optional	Optional. Number of data points (default 50, max 250).
quote	string	optional	Optional quote currency code (default 'usd'). Examples: 'usd', 'btc', 'eth'.
interval	string	optional	Optional. Sampling interval. Common values: '5m', '15m', '30m', '1h', '6h', '12h', '24h', '7d', '14d', '30d'. Upstream supports additional intervals; consult CoinPaprika docs if you need something outside this list.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinId": {
      "type": "string",
      "description": "Canonical CoinPaprika coin slug in 'symbol-name' format, e.g. 'btc-bitcoin', 'eth-ethereum', 'ada-cardano'. Do NOT pass ticker symbols ('BTC', 'AAVE') or guess the slug — it is not derivable from the symbol (e.g. AAVE resolves to 'aave-new', which you could not guess). Call search or resolveId first to resolve a symbol or name to its canonical id."
    },
    "start": {
      "type": "string",
      "description": "Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC."
    },
    "end": {
      "type": "string",
      "description": "Optional end timestamp. Same formats as start. Defaults to now if omitted."
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Optional. Number of data points (default 50, max 250)."
    },
    "quote": {
      "type": "string",
      "default": "usd",
      "description": "Optional quote currency code (default 'usd'). Examples: 'usd', 'btc', 'eth'."
    },
    "interval": {
      "type": "string",
      "default": "5m",
      "description": "Optional. Sampling interval. Common values: '5m', '15m', '30m', '1h', '6h', '12h', '24h', '7d', '14d', '30d'. Upstream supports additional intervals; consult CoinPaprika docs if you need something outside this list."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "coinId",
    "start",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getExchanges

List all exchanges tracked by CoinPaprika with rank, trust score and volume. Use when asked 'top exchanges', 'biggest crypto exchanges', 'list exchanges by volume', or to find an exchange id before calling getExchangeByID.

Parameters3

quotes	string	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "quotes": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getExchangeByID

Get details for a specific exchange (volume, market count, trust score, links, fiat support). Use when asked 'tell me about Binance', 'Coinbase exchange stats', 'is X a trustworthy exchange'. For the pairs traded there use getExchangeMarkets; find the exchange id first with search or getExchanges.

Parameters3

exchangeId	string	required
quotes	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "exchangeId": {
      "type": "string"
    },
    "quotes": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "exchangeId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getExchangeMarkets

List the trading pairs (markets) on a specific exchange with price and 24h volume per pair. Use when asked 'what pairs trade on Binance', 'markets on Kraken', 'BTC pairs on X exchange'. For exchange-level stats use getExchangeByID.

Parameters4

exchangeId	string	required
quotes	string	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "exchangeId": {
      "type": "string"
    },
    "quotes": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "exchangeId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getPeopleById

Person details

Parameters2

personId	string	required
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "personId": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "personId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTags

List tags

Parameters3

additionalFields	string	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "additionalFields": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTagById

Tag details

Parameters3

tagId	string	required
additionalFields	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "tagId": {
      "type": "string"
    },
    "additionalFields": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "tagId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getPlatforms

List the smart-contract platforms (blockchains such as ethereum, bnb, polygon) for which CoinPaprika indexes token contracts. Use when asked 'which chains are supported for contract lookups', 'list contract platforms', or to pick a platform id before calling getContracts.

Parameters2

limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getContracts

List the token contract addresses tracked on a specific platform, mapping each contract to its CoinPaprika coin id. Use when asked 'contracts on ethereum', 'what tokens does X chain have', or to map a contract address to a coin id. Get the platform id first from getPlatforms; for a single contract's price use getTickerByContract.

Parameters3

platformId	string	required
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "platformId": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "platformId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getTickerByContract

Get the current price and market data of a token by its contract address (for on-chain and DeFi tokens). Use when you have a 0x... or contract address rather than a name. For history use getHistoricalTickerByContract.

Parameters3

platformId	string	required
contractAddress	string	required
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "platformId": {
      "type": "string"
    },
    "contractAddress": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "platformId",
    "contractAddress",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getHistoricalTickerByContract

Get historical price and market data of a token by its contract address. Not for the current price (use getTickerByContract). Requires Starter+ plan.

Parameters8

platformId	string	required	Platform identifier (e.g., 'eth-ethereum', 'bnb-binance-coin'). Use getPlatforms to discover valid platforms.
contractAddress	string	required	Token contract address on the platform. EVM addresses are case-insensitive; Solana addresses are case-sensitive base58.
start	string	required	Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC.
end	string	optional	Optional end timestamp. Same formats as start. Defaults to now if omitted.
limit	number	optional	Optional. Number of data points (default 50, max 250).
quote	string	optional	Optional quote currency code (default 'usd').
interval	string	optional	Optional. Sampling interval. Common values: '5m', '15m', '30m', '1h', '6h', '12h', '24h', '7d', '14d', '30d'. Upstream supports additional intervals; consult CoinPaprika docs if you need something outside this list.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "platformId": {
      "type": "string",
      "description": "Platform identifier (e.g., 'eth-ethereum', 'bnb-binance-coin'). Use getPlatforms to discover valid platforms."
    },
    "contractAddress": {
      "type": "string",
      "description": "Token contract address on the platform. EVM addresses are case-insensitive; Solana addresses are case-sensitive base58."
    },
    "start": {
      "type": "string",
      "description": "Required. Start timestamp. Accepts ISO 8601 ('2026-01-15T00:00:00Z') or date-only ('2026-01-15'). UTC."
    },
    "end": {
      "type": "string",
      "description": "Optional end timestamp. Same formats as start. Defaults to now if omitted."
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Optional. Number of data points (default 50, max 250)."
    },
    "quote": {
      "type": "string",
      "default": "usd",
      "description": "Optional quote currency code (default 'usd')."
    },
    "interval": {
      "type": "string",
      "default": "5m",
      "description": "Optional. Sampling interval. Common values: '5m', '15m', '30m', '1h', '6h', '12h', '24h', '7d', '14d', '30d'. Upstream supports additional intervals; consult CoinPaprika docs if you need something outside this list."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "platformId",
    "contractAddress",
    "start",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

status

Get the CoinPaprika MCP server's status and configuration (uptime, mode, enabled features). Use when asked 'is the server up', 'what mode am I in', 'server status'. This reports the MCP server itself, not the crypto market; for market health use getGlobal.

Parameters1

rationale

string

required

REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getGlobal

Get a global crypto market overview: total market cap, total 24h volume, Bitcoin dominance, and market-wide 24h change. Use for 'how is the crypto market doing', 'total market cap', 'BTC dominance'. For a single coin's price use getTickersById.

Parameters1

rationale

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search

Broadly search CoinPaprika across coins, exchanges, ICOs, people and tags by name or symbol when the entity type is unknown or you are exploring. Use for 'find anything called X'. If you specifically need a coin's canonical id to fetch its price, prefer resolveId.

Parameters5

q	string	required	Required. Search query (case-insensitive, partial-match).
categories	string	optional	Optional. Comma-separated category filter: 'currencies', 'exchanges', 'icos', 'people', 'tags'. Omit to search all categories.
modifier	string	optional	Optional. Upstream-specific search modifier.
limit	number	optional	Optional. Items PER CATEGORY (not total). Default 50.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Required. Search query (case-insensitive, partial-match)."
    },
    "categories": {
      "type": "string",
      "description": "Optional. Comma-separated category filter: 'currencies', 'exchanges', 'icos', 'people', 'tags'. Omit to search all categories."
    },
    "modifier": {
      "type": "string",
      "description": "Optional. Upstream-specific search modifier."
    },
    "limit": {
      "type": "number",
      "default": 50,
      "description": "Optional. Items PER CATEGORY (not total). Default 50."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "q",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resolveId

Resolve a coin name or symbol ('bitcoin', 'BTC', 'AAVE') to its single canonical CoinPaprika id ('btc-bitcoin', 'aave-new'). Call this FIRST whenever you have a bare symbol or name and want the coin's price, since ids are not derivable from symbols; then pass the id to getTickersById.

Parameters4

type	string	required
query	string	required
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "coin",
        "exchange",
        "people",
        "tags"
      ]
    },
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "type",
    "query",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

priceConverter

Convert an amount from one crypto or fiat to another at the current rate ('how much is 0.5 BTC in USD', 'convert 100 USDC to EUR'). For a plain coin price without an amount, use getTickersById.

Parameters4

baseCurrencyId	string	required	Required. Source CoinPaprika coin slug (e.g., 'btc-bitcoin'). Full slugs only; symbols like 'BTC' are rejected upstream.
quoteCurrencyId	string	required	Required. Target CoinPaprika coin slug (e.g., 'usd-us-dollars', 'eth-ethereum').
amount	number	optional	Optional. Amount of base currency to convert (default 1). Passing 0 returns a 0-valued response, which is rarely what you want — use 1 to get a unit-rate quote.
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "baseCurrencyId": {
      "type": "string",
      "description": "Required. Source CoinPaprika coin slug (e.g., 'btc-bitcoin'). Full slugs only; symbols like 'BTC' are rejected upstream."
    },
    "quoteCurrencyId": {
      "type": "string",
      "description": "Required. Target CoinPaprika coin slug (e.g., 'usd-us-dollars', 'eth-ethereum')."
    },
    "amount": {
      "type": "number",
      "default": 1,
      "description": "Optional. Amount of base currency to convert (default 1). Passing 0 returns a 0-valued response, which is rarely what you want — use 1 to get a unit-rate quote."
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "baseCurrencyId",
    "quoteCurrencyId",
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getCapabilities

Get the server's capabilities, supported workflow patterns, validation rules and recommended tool sequences. Use FIRST to onboard as an agent, or when asked 'what can this server do', 'how should I chain these tools', 'what are the parameter rules'. This describes the MCP server itself, not crypto data.

Parameters1

rationale

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

keyInfo

Verify API key (Pro)

Parameters1

rationale

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getMappings

API ID mappings (Business)

Parameters7

coinpaprika	string	optional
coinmarketcap	string	optional
coingecko	string	optional
cryptocompare	string	optional
isin	string	optional
dti	string	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "coinpaprika": {
      "type": "string"
    },
    "coinmarketcap": {
      "type": "string"
    },
    "coingecko": {
      "type": "string"
    },
    "cryptocompare": {
      "type": "string"
    },
    "isin": {
      "type": "string"
    },
    "dti": {
      "type": "string"
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

getChangelogIDs

Changelog IDs (Starter+)

Parameters3

page	number	optional
limit	number	optional
rationale	string	required	REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions.

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "default": 1
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "rationale": {
      "type": "string",
      "minLength": 20,
      "maxLength": 500,
      "description": "REQUIRED. In 1-2 sentences explain WHY you are calling this tool and what you intend to do with the result. Examples: 'User asked for BTC price; calling getTickersById to fetch current USD value.' 'Building a portfolio dashboard; need OHLCV for ETH last 7 days.' This is logged and reviewed to improve the MCP. Do not include user PII or secrets — use generic descriptions."
    }
  },
  "required": [
    "rationale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submitFeedback

Report a problem or gap back to the CoinPaprika MCP maintainers: call it when you got stuck, a response was unexpected, information you needed was missing, or a tool did not behave as documented. Use when the user says 'this is wrong', 'report this', 'that did not work'. Low friction, partial feedback is welcome, and every submission is read.

Parameters6

goal	string	required	REQUIRED: What you (or the user behind you) were trying to accomplish.
attempted_tools	array	optional	OPTIONAL: List of tool names you called, in order, before submitting this feedback.
blocked_at	string	optional	OPTIONAL: Tool name or step where you got stuck.
expected	string	optional	OPTIONAL: What you expected to happen.
observed	string	optional	OPTIONAL: What actually happened.
severity	string	optional	OPTIONAL: How badly this affected your task. Default 'minor'.

Raw schema

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "minLength": 10,
      "maxLength": 500,
      "description": "REQUIRED: What you (or the user behind you) were trying to accomplish."
    },
    "attempted_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "OPTIONAL: List of tool names you called, in order, before submitting this feedback."
    },
    "blocked_at": {
      "type": "string",
      "description": "OPTIONAL: Tool name or step where you got stuck."
    },
    "expected": {
      "type": "string",
      "maxLength": 500,
      "description": "OPTIONAL: What you expected to happen."
    },
    "observed": {
      "type": "string",
      "maxLength": 500,
      "description": "OPTIONAL: What actually happened."
    },
    "severity": {
      "type": "string",
      "enum": [
        "blocker",
        "major",
        "minor",
        "nit"
      ],
      "default": "minor",
      "description": "OPTIONAL: How badly this affected your task. Default 'minor'."
    }
  },
  "required": [
    "goal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md11 KBView on GitHub

CoinPaprika MCP Server

A Model Context Protocol (MCP) server that provides on-demand access to CoinPaprika's cryptocurrency market data API. Built specifically for AI assistants like Claude to programmatically fetch real-time prices, tickers, exchange data, OHLCV candles, and more with zero configuration.

TL;DR

bash

# Install globally
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

# Or run directly without installation
npx @coinpaprika/mcp@latest

CoinPaprika MCP connects Claude to live crypto market data for 8,000+ coins. No API key required for free-tier features. Installation | Configuration | API Reference

Prefer zero setup? Use the hosted MCP server at mcp.coinpaprika.com — no installation, no API key, same 30 tools. See Hosted Alternative for transport endpoints.

What Can You Build?

Market Dashboards: Real-time market overview with global stats, top coins, and volume trends
Coin Analysis Tools: Deep-dive into any cryptocurrency — price, team, events, exchanges, and markets
Price Trackers: Track prices across multiple quote currencies with historical OHLCV data
Exchange Comparisons: Compare trading pairs and volumes across 200+ exchanges
Portfolio Valuations: Convert an amount between currencies ('0.5 BTC in USD') and track price changes over time
Contract Lookup: Find tokens by their smart contract address across multiple platforms

Installation

Installing via Smithery

To install CoinPaprika MCP for Claude Desktop automatically via Smithery:

bash

npx -y @smithery/cli install @coinpaprika/coinpaprika-mcp --client claude

Manual Installation

bash

# Install globally (recommended for regular use)
npm install -g @coinpaprika/mcp

# Start the server
coinpaprika-mcp

Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

json

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"]
    }
  }
}

With API Key (for paid-tier features)

json

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["@coinpaprika/mcp@latest"],
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code Integration

bash

# Add as MCP server in Claude Code
claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

# With API key
COINPAPRIKA_API_KEY=your-key claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

Hosted Alternative (No Installation)

If you prefer zero setup, point any MCP-compatible client directly at the hosted server at mcp.coinpaprika.com. The landing page provides setup instructions and documentation. The following transport endpoints are available:

Transport	Endpoint	Use Case
Streamable HTTP	`https://mcp.coinpaprika.com/streamable-http`	Recommended for most clients
SSE	`https://mcp.coinpaprika.com/sse`	Legacy SSE transport
JSON-RPC	`https://mcp.coinpaprika.com/json-rpc`	Direct JSON-RPC

Note: These are MCP protocol endpoints — they won't display anything in a browser. Visit mcp.coinpaprika.com for the landing page.

json

{
  "mcpServers": {
    "coinpaprika": {
      "type": "streamable-http",
      "url": "https://mcp.coinpaprika.com/streamable-http"
    }
  }
}

Available Tools (30)

Discovery & System

Tool	Description
`getCapabilities`	Server capabilities, workflow patterns, validation rules, and best practices. Start here.
`status`	Server status and configuration
`getGlobal`	Global market overview: total market cap, 24h volume, BTC dominance ('how is the market doing')

Coins

Tool	Description	Required Parameters
`getCoins`	List all coins (id, name, symbol, rank); no prices, use getTickers for prices	—
`getCoinById`	Coin project details (description, team, links); no price, use getTickersById	`coinId`
`getCoinEvents`	Upcoming events for a coin	`coinId`
`getCoinExchanges`	Exchanges listing a coin	`coinId`
`getCoinMarkets`	Markets/exchanges trading a coin ('where to buy X', 'X price on Binance')	`coinId`

Tickers & Prices

Tool	Description	Required Parameters
`getTickers`	Current prices + market caps for top coins by market cap ('top 5 coins', market snapshot)	—
`getTickersById`	Current price, market cap & 24h change of one coin ('BTC price', 'how much is ETH')	`coinId`
`getCoinOHLCVLatest`	Latest full-day OHLC candle (not the live price)	`coinId`
`getCoinOHLCVToday`	Today's in-progress OHLC candle	`coinId`
`priceConverter`	Convert an amount between currencies ('0.5 BTC in USD')	`baseCurrencyId`, `quoteCurrencyId`

Exchanges

Tool	Description	Required Parameters
`getExchanges`	List all exchanges	—
`getExchangeByID`	Exchange details	`exchangeId`
`getExchangeMarkets`	Markets on a specific exchange	`exchangeId`

Tags & People

Tool	Description	Required Parameters
`getTags`	List all tags/categories	—
`getTagById`	Tag details	`tagId`
`getPeopleById`	Person/team member details	`personId`

Contracts

Tool	Description	Required Parameters
`getPlatforms`	List contract platforms	—
`getContracts`	Contracts on a platform	`platformId`
`getTickerByContract`	Token price by contract address (on-chain/DeFi tokens)	`platformId`, `contractAddress`

Search & Resolution

Tool	Description	Required Parameters
`search`	Search coins/exchanges/people/tags by name; use FIRST to get an id	`q`
`resolveId`	Resolve a name/symbol to canonical id; call FIRST before price tools	`type`, `query`

Paid-Tier Tools

These tools require a paid CoinPaprika API plan. Without an API key, they return guidance directing you to upgrade.

Tool	Plan Required	Description
`getCoinOHLCVHistorical`	Starter+	Historical OHLCV candle data
`getTickersHistoricalById`	Starter+	Historical ticker snapshots
`getHistoricalTickerByContract`	Starter+	Historical ticker by contract
`getChangelogIDs`	Starter+	Changelog of coin ID changes
`keyInfo`	Pro	Verify API key details
`getMappings`	Business	Cross-platform ID mappings

API Key Configuration

The free tier provides access to most tools without any API key. For paid-tier features (historical data, mappings, etc.), set the COINPAPRIKA_API_KEY environment variable:

bash

# Set via environment variable
export COINPAPRIKA_API_KEY=your-api-key-here
coinpaprika-mcp

# Or pass inline
COINPAPRIKA_API_KEY=your-api-key-here npx @coinpaprika/mcp@latest

Get an API key at coinpaprika.com/api/pricing.

Example Usage

javascript

// Start by getting capabilities for workflow guidance:
const caps = await getCapabilities();

// Get global market overview:
const global = await getGlobal();

// Find a coin by name:
const results = await search({ q: "ethereum" });

// Get detailed coin info:
const bitcoin = await getCoinById({ coinId: "btc-bitcoin" });

// Get current ticker with USD and BTC quotes:
const ticker = await getTickersById({ coinId: "eth-ethereum", quotes: "USD,BTC" });

// Get OHLCV data for today:
const ohlcv = await getCoinOHLCVToday({ coinId: "btc-bitcoin" });

// Convert 1 BTC to USD:
const conversion = await priceConverter({
  baseCurrencyId: "btc-bitcoin",
  quoteCurrencyId: "usd-us-dollars",
  amount: 1
});

// List top 10 exchanges:
const exchanges = await getExchanges({ limit: 10 });

// Resolve fuzzy query to exact coin ID:
const resolved = await resolveId({ type: "coin", query: "cardano" });

Sample Prompts for Claude

"What's the current price of Bitcoin and Ethereum? Show me 24h change."
"Give me a comprehensive analysis of Cardano — price, team, events, and top exchanges."
"Compare the top 5 crypto exchanges by trading volume."
"Convert 10 ETH to USD and show the current exchange rate."
"Find all coins tagged as 'defi' and show their market caps."
"What exchanges list Solana and what trading pairs are available?"
"Show me the OHLCV data for Bitcoin today."
"Search for all coins related to 'layer-2' and rank them by market cap."
"Look up the team behind Ethereum — who are the key people?"
"Get the ticker for USDT by its Ethereum contract address."

Rate Limits & Performance

Free Tier Limits: 10,000 requests per day
Response Time: 100-500ms for most endpoints
Data Coverage: 8,000+ coins, 200+ exchanges
Error Handling: Structured errors with codes, suggestions, and retry guidance
Rate Limit Info: Every response includes rate limit metadata

Troubleshooting

Common Issues:

Rate limiting: If receiving CP429_RATE_LIMIT errors, wait for daily reset at midnight UTC
Invalid coin ID: Coin IDs use symbol-name format (e.g., btc-bitcoin, not bitcoin or BTC). Use search or resolveId to find correct IDs
Paid-tier errors: CP402_INSUFFICIENT_PLAN or CP403_FORBIDDEN mean the endpoint requires a paid plan. Set COINPAPRIKA_API_KEY environment variable
Timeout errors: Large data requests may take longer — reduce the limit parameter
Network errors: Check network connectivity, the service requires internet access

Development

bash

# Clone the repository
git clone https://github.com/coinpaprika/coinpaprika-mcp.git
cd coinpaprika-mcp

# Install dependencies
npm install

# Run in development
npm start

# Build for production
npm run build

Changelog

See CHANGELOG.md for detailed release notes.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Additional Resources

CoinPaprika API Documentation
API Pricing & Plans
Hosted MCP Server — Zero-setup alternative
DexPaprika MCP — DEX & DeFi data companion package
Model Context Protocol Specification
CoinPaprika — Comprehensive cryptocurrency market data
DexPaprika — Onchain DEX analytics

Install

Tools (31)

getCoinsgetCoinByIdgetCoinEventsgetCoinExchangesgetCoinMarketsgetCoinOHLCVLatestgetCoinOHLCVTodaygetCoinOHLCVHistorical

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.coinpaprika.com/streamable-http

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.coinpaprika.com/streamable-http"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.