CoinPaprika

com.coinpaprika由 coinpaprika.com 发布官方发布者v1.4.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

CoinPaprika MCP 让助手获取实时加密货币行情:价格、行情快照、交易所、OHLCV K 线、合约与项目资料。

可以做什么
  • 查询币种、项目详情、事件、标签与人物资料
  • 获取当前价格、市值、24 小时涨跌、市值排行与全市场概况
  • 获取今日与最近一个完整交易日的 OHLC K 线,付费方案可查历史快照
  • 浏览交易所、其统计与交易对,查看某币种在哪些交易所上线或交易
  • 把名称或符号解析为规范 id、跨实体搜索,并在币种与法币间换算金额
  • 将代币合约地址映射到币种,并按合约地址查询代币价格
适用场景
适合让助手回答加密市场问题、比较交易所、跟踪价格或估算持仓价值,而无需自行对接 API。免费额度已覆盖大部分只读查询,无需密钥。
运行要求
远程端点 mcp.coinpaprika.com(streamable HTTP、SSE 或 JSON-RPC),或在本地用 Node.js 运行 npm 包 @coinpaprika/mcp。需要联网。免费额度无需 API 密钥;付费功能需设置环境变量 COINPAPRIKA_API_KEY。
安装前请注意
所列工具均为只读,但查询内容会发送到 CoinPaprika 服务。历史数据、映射等付费工具在没有付费方案时会失败,付费方案起价每月 99 美元。免费额度为每月 20,000 次调用。submitFeedback 会把反馈发送给维护者。返回的行情不应视为投资建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CoinPaprika,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.coinpaprika%2Fcoinpaprika/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

CoinPaprika MCP Server

[smithery badge]

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 globallynpm install -g @coinpaprika/mcp
# Start the servercoinpaprika-mcp
# Or run directly without installationnpx @coinpaprika/mcp@latest

CoinPaprika MCP connects Claude to live crypto market data for 12,000+ cryptocurrencies. The free tier needs no API key. Installation | Configuration | API Reference

Prefer zero setup? Use the hosted MCP server at mcp.coinpaprika.com: no installation, no API key to start, 31 tools (the 30 here plus submitFeedback). See Hosted server 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 350+ 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 mcp add coinpaprika/coinpaprika

Manual Installation

bash
# Install globally (recommended for regular use)npm install -g @coinpaprika/mcp
# Start the servercoinpaprika-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 Codeclaude mcp add coinpaprika -- npx @coinpaprika/mcp@latest
# With API keyCOINPAPRIKA_API_KEY=your-key claude mcp add coinpaprika -- npx @coinpaprika/mcp@latest

Hosted server (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:

TransportEndpointUse Case
Streamable HTTPhttps://mcp.coinpaprika.com/streamable-httpRecommended for most clients
SSEhttps://mcp.coinpaprika.com/sseLegacy SSE transport
JSON-RPChttps://mcp.coinpaprika.com/json-rpcDirect 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

ToolDescription
getCapabilitiesServer capabilities, workflow patterns, validation rules, and best practices. Start here.
statusServer status and configuration
getGlobalGlobal market overview: total market cap, 24h volume, BTC dominance ('how is the market doing')

Coins

ToolDescriptionRequired Parameters
getCoinsList all coins (id, name, symbol, rank); no prices, use getTickers for pricesnone
getCoinByIdCoin project details (description, team, links); no price, use getTickersByIdcoinId
getCoinEventsUpcoming events for a coincoinId
getCoinExchangesExchanges listing a coincoinId
getCoinMarketsMarkets/exchanges trading a coin ('where to buy X', 'X price on Binance')coinId

Tickers & Prices

ToolDescriptionRequired Parameters
getTickersCurrent prices + market caps for top coins by market cap ('top 5 coins', market snapshot)none
getTickersByIdCurrent price, market cap & 24h change of one coin ('BTC price', 'how much is ETH')coinId
getCoinOHLCVLatestLatest full-day OHLC candle (not the live price)coinId
getCoinOHLCVTodayToday's in-progress OHLC candlecoinId
priceConverterConvert an amount between currencies ('0.5 BTC in USD')baseCurrencyId, quoteCurrencyId

Exchanges

ToolDescriptionRequired Parameters
getExchangesList all exchangesnone
getExchangeByIDExchange detailsexchangeId
getExchangeMarketsMarkets on a specific exchangeexchangeId

Tags & People

ToolDescriptionRequired Parameters
getTagsList all tags/categoriesnone
getTagByIdTag detailstagId
getPeopleByIdPerson/team member detailspersonId

Contracts

ToolDescriptionRequired Parameters
getPlatformsList contract platformsnone
getContractsContracts on a platformplatformId
getTickerByContractToken price by contract address (on-chain/DeFi tokens)platformId, contractAddress

Search & Resolution

ToolDescriptionRequired Parameters
searchSearch coins/exchanges/people/tags by name; use FIRST to get an idq
resolveIdResolve a name/symbol to canonical id; call FIRST before price toolstype, query

Paid-Tier Tools

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

ToolPlan RequiredDescription
getCoinOHLCVHistoricalStarter+Historical OHLCV candle data
getTickersHistoricalByIdStarter+Historical ticker snapshots
getHistoricalTickerByContractStarter+Historical ticker by contract
getChangelogIDsStarter+Changelog of coin ID changes
keyInfoStarter+Verify API key details
getMappingsBusinessCross-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 variableexport COINPAPRIKA_API_KEY=your-api-key-herecoinpaprika-mcp
# Or pass inlineCOINPAPRIKA_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: 20,000 calls per month, no API key needed. Paid plans start at $99/month for 400,000 calls: https://coinpaprika.com/api/pricing/
  • Response Time: 100-500ms for most endpoints
  • Data Coverage: 12,000+ cryptocurrencies, 350+ exchanges
  • Error Handling: Structured errors with codes, suggestions, and retry guidance
  • Quota Info: Running this package yourself, every response carries a meta.quota block with the monthly free-tier allowance and the number of calls this server process has made since it started. That count is process-local, not your account balance. The hosted server at mcp.coinpaprika.com returns no meta block at all, so do not write client code that depends on one

Troubleshooting

Common Issues:

  • Rate limiting: If receiving CP429_RATE_LIMIT errors, back off and retry. The free-tier quota is monthly, not daily, so a sustained 429 means the monthly allowance is spent
  • 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, so reduce the limit parameter
  • Network errors: Check network connectivity, the service requires internet access

Development

bash
# Clone the repositorygit clone https://github.com/coinpaprika/coinpaprika-mcp.gitcd coinpaprika-mcp
# Install dependenciesnpm install
# Run in developmentnpm start
# Build for productionnpm 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

来源:README.md,提交 c4c7783

工具

27

getCoins

List all available coins with id, name, symbol and rank. Use to discover coins or map a name to an id. Does NOT include prices; for prices use getTickers or getTickersById. Read-only; limit caps the number of coins returned. No API key required.

输入参数limitrationale必填

getCoinById

Get descriptive project information about a coin: description, links, team and tags. Use for 'tell me about Uniswap', 'what is this project'. Does NOT include price; for price and market cap use getTickersById. Read-only; coinId is a canonical id (resolve with resolveId). No API key required.

输入参数coinId必填rationale必填

getCoinEvents

Get the timeline of events for a coin (launches, partnerships, hard forks, conference talks) with dates and descriptions. Use for 'what is happening with X', 'upcoming events for Ethereum', 'X roadmap events'. For prices use getTickersById. Read-only; coinId is a canonical id, limit caps results. No API key required.

输入参数limitcoinId必填rationale必填

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 live price use getTickersById. Read-only; coinId is a canonical id, limit caps results. No API key required.

输入参数limitcoinId必填rationale必填

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. Read-only; coinId is a canonical id, quotes sets quote currencies, limit caps results. No API key required.

输入参数limitcoinId必填quotesrationale必填

getCoinOHLCVLatest

Get the latest full-day OHLC candle (open, high, low, close and volume) for a coin. Use for 'yesterday's candle for BTC'. For the live spot price use getTickersById. Read-only; coinId must be a canonical id (resolve a bare symbol with resolveId first), quote defaults to usd. No API key required.

输入参数quotecoinId必填rationale必填

getCoinOHLCVToday

Get today's in-progress OHLC candle for a coin. Use for 'today's high and low for ETH'. For the current spot price use getTickersById; for yesterday's full candle use getCoinOHLCVLatest, and for older prices getTickersHistoricalById. Read-only; coinId is a canonical id (resolve with resolveId). No API key required.

输入参数quotecoinId必填rationale必填

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. Read-only; quotes sets the quote currencies (default USD), limit caps results. No API key required.

输入参数limitquotesrationale必填

getTickersById

Get the current price, market cap, 24h change and volume of one cryptocurrency in USD or another quote currency. Use for 'what is the price of X', 'how much is Bitcoin worth', 'BTC to USD', 'ETH price now'. For past prices use getTickersHistoricalById. Read-only; coinId is a canonical id (resolve a bare symbol with resolveId first), quotes sets the quote currency (default USD). No API key required.

输入参数coinId必填quotesrationale必填

getTickersHistoricalById

Get a coin's price, market cap and volume at past times as point-in-time snapshots (not OHLC candles). Use for 'price of BTC last Tuesday', 'ETH market cap on 2024-01-01'. For today's and yesterday's OHLC candles use getCoinOHLCVToday and getCoinOHLCVLatest; for the current price use getTickersById. Read-only. Params: coinId (required) canonical id like 'btc-bitcoin' (resolve via resolveId); start (required) and end (optional, default now) accept 'yyyy-mm-dd' or ISO 8601; interval (optional, default '5m'); quote (optional, default 'usd'); limit (optional, default 50, max 250) caps points. Requires a Starter+ plan (COINPAPRIKA_API_KEY). Free tier on this hosted server: daily intervals up to a year back and hourly intervals up to 24 hours back; anything else returns a structured CP402_PAID_ENDPOINT stub.

输入参数endlimitquotestart必填coinId必填intervalrationale必填

getExchanges

List exchanges tracked by CoinPaprika as a list ranked by rank, each with id, name, trust score, active market count and 24h volume. Use for 'top exchanges by volume', 'biggest crypto exchanges', or to find an exchangeId before calling getExchangeByID. For one exchange's full stats use getExchangeByID; for its trading pairs use getExchangeMarkets. Read-only. Params: quotes (optional, default 'usd') is a comma-separated list of quote currencies for the volume figures, for example 'usd,btc'; limit (optional, default 50, max 250) caps how many exchanges return. No API key required.

输入参数limitquotesrationale必填

getExchangeByID

Get details for a specific exchange: 24h volume, market count, trust score, links and fiat support. Use for '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. Read-only; exchangeId is an exchange id such as binance. No API key required.

输入参数quotesrationale必填exchangeId必填

getExchangeMarkets

List the trading pairs (markets) on one exchange as a list, each with the pair, base and quote coin ids, latest price, 24h volume and category. Use for 'what pairs trade on Binance', 'markets on Kraken', 'BTC pairs on Coinbase'. For exchange-level stats such as trust score use getExchangeByID; find the exchangeId first with getExchanges. Read-only. Params: exchangeId (required) is an exchange id such as 'binance'; quotes (optional, default 'usd') is a comma-separated list of quote currencies for the figures, e.g. 'usd,btc'; limit (optional, default 50, max 250) caps how many markets return. No API key required.

输入参数limitquotesrationale必填exchangeId必填

getPeopleById

Get the profile of one person in crypto by id: name, description or bio, teams_count, positions held, and linked projects plus social and code accounts. Use for 'who is Vitalik Buterin', 'background on Charlie Lee', 'projects tied to this founder'. Find the personId first with search or resolveId using type 'people'; this tool needs the exact id, not a name. Read-only. Params: personId (required) is a canonical person id such as 'vitalik-buterin' or 'satoshi-nakamoto'; an unknown id returns not found. No API key required.

输入参数personId必填rationale必填

getTags

List all CoinPaprika tags (categories such as 'defi', 'stablecoin', 'memecoin', 'ai') used to group coins, returned as a list with each tag's id, name, coin_counter and ico_counter. Use for 'what crypto categories exist', 'list market sectors', or to find a tagId before calling getTagById. For the coins inside one tag use getTagById. Read-only. Params: additionalFields (optional, default none) is a comma-separated list of extra sections per tag, valid values 'coins' and 'icos' (example 'coins,icos'; omit for just summaries); limit (optional, default 50, max 250) caps how many tags return. No API key required.

输入参数limitrationale必填additionalFields

getTagById

Get details for one CoinPaprika tag (a category such as 'defi' or 'stablecoin'): its id, name, description, coin_counter, ico_counter, and optionally the coins and ICOs grouped under it. Use for 'what coins are in the defi tag', 'show the stablecoin category', 'tokens tagged ai'. To list every tag or find a tagId first use getTags. Read-only. Params: tagId (required) is a tag id from getTags such as 'defi'; additionalFields (optional, default none) is a comma-separated list of extra sections, valid values 'coins' and 'icos' (example 'coins,icos'). An unknown tagId returns an error. No API key required.

输入参数tagId必填rationale必填additionalFields

getPlatforms

List the smart-contract platforms (blockchains such as ethereum, bnb, polygon) for which CoinPaprika indexes token contracts. Use for 'which chains are supported for contract lookups', 'list contract platforms', or to pick a platform id before calling getContracts. Read-only; limit caps results. No API key required.

输入参数limitrationale必填

getContracts

List the token contract addresses tracked on one platform as a list, mapping each contract to its CoinPaprika coin id. Use for 'contracts on ethereum', 'what tokens does BSC have', or to map a contract address to a coin id. Find the platformId first with getPlatforms; for one contract's live price use getTickerByContract, and for its history use getHistoricalTickerByContract. Read-only. Params: platformId (required) is a platform id such as 'eth-ethereum' or 'bsc-binance-smart-chain'; limit (optional, default 50, max 250) caps how many contracts return. An unknown platformId returns an error. No API key required.

输入参数limitrationale必填platformId必填

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 contract address (0x...) rather than a name. For history use getHistoricalTickerByContract. Read-only; platformId is the chain (e.g. eth-ethereum) and contractAddress the token address. No API key required.

输入参数rationale必填platformId必填contractAddress必填

getHistoricalTickerByContract

Get a token's price and market history by its contract address, as a time series. Use for 'token price on 2024-01-01 by address', 'hourly history for a contract'. For its current price use getTickerByContract; by coin id use getTickersHistoricalById. Read-only. Params: platformId (required) chain id like 'eth-ethereum'; contractAddress (required) token address; start (required) and end (optional, default now) accept 'yyyy-mm-dd' or ISO 8601; interval (optional, default '5m'); quote (optional, default 'usd'); limit (optional, default 50, max 250) caps points. Requires a Starter+ plan (COINPAPRIKA_API_KEY). Free tier on this hosted server: daily intervals up to a year back and hourly intervals up to 24 hours back; anything else returns a structured CP402_PAID_ENDPOINT stub.

输入参数endlimitquotestart必填intervalrationale必填platformId必填contractAddress必填

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. Read-only; takes no parameters and needs no API key.

输入参数rationale必填

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. Read-only; takes no parameters and needs no API key.

输入参数rationale必填

resolveId

Resolve a fuzzy coin, exchange, person or tag name or symbol to a ranked list of candidate CoinPaprika ids, best first (take the top one). Call FIRST when you have a bare name or symbol but need an id, since ids are not derivable, then pass the id to getTickersById for price. Returns candidates with id, name, symbol, type and rank; an empty list means no match. Read-only. Params: type (required; one of 'coin', 'exchange', 'people', 'tags') sets entity kind; query (required) is the fuzzy text; limit (optional, default 50, max 250) caps candidates. Answers 'id for AAVE', 'resolve Vitalik'. No API key required.

输入参数type必填limitquery必填rationale必填

priceConverter

Convert an amount from one crypto or fiat to another at the current rate, e.g. 'how much is 0.5 BTC in USD', 'convert 100 USDC to EUR'. For a plain coin price without an amount, use getTickersById. Read-only; baseCurrencyId and quoteCurrencyId are canonical ids and amount is the quantity to convert. No API key required.

输入参数amountrationale必填baseCurrencyId必填quoteCurrencyId必填

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.

输入参数rationale必填

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.

输入参数goal必填expectedobservedseverityblocked_atattempted_tools

版本历史

1
  1. v1.4.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Coinpaprika 集成