FOR AI AGENTS & THE TEAMS BUILDING THEM

Crypto MCP server for AI agents

Q: Which MCP tools need a paid plan?

getCoinOHLCVHistorical, keyInfo and getChangelogIDs need Starter or higher, and getMappings needs Business or higher. On the hosted server they answer with a CP402_PAID_ENDPOINT message instead of data. To use them, run the open-source server with your own key.

Q: Is it safe to connect the CoinPaprika MCP server to my agent?

Yes. 30 tools only read public market data, and submitFeedback only sends your report to the team. The server never asks for a wallet, an exchange account or a password, and it cannot trade or move funds. Each call carries a short rationale that is logged to improve the server, so keep personal data and secrets out of it.

Connect CoinPaprika’s MCP server to retrieve crypto market data, resolve asset IDs and inspect timestamps. Start without a key; run locally with your key for paid tools.

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

Add to Cursor View Cursor setup Add to VS Code View VS Code setup

Free for personal use. No signup, no card. Setup for every client or see all 31 tools.

One question, answered with live data

You ask

What is Bitcoin’s price, and how far is it below its all-time high?

The agent calls

resolveId({ type: "coin", query: "bitcoin" , rationale: "Retrieve market data for the requested crypto analysis." })
getTickersById({ coinId: "btc-bitcoin" , rationale: "Retrieve market data for the requested crypto analysis." })

The agent answers

Bitcoin is $82,772.24, down 1.06% in 24 hours. That is 34.38% below its all-time high of $126,173.18, set on 6 October 2025.

Sample 8 Oct, 10:33 UTC snapshot values

Run live queries the REST ticker endpoint from your browser to update this example. The MCP calls include the required rationale argument.

Five ways to give an agent crypto data

Pick by how your agent works. To use paid tools on your plan, run the MCP server locally with your key.

You chat with Claude or Cursor

Hosted MCP server

Nothing to install and no key. Most people need only this.

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

Your agent writes code

Agent skill

Endpoint and command line knowledge as files. Pair it with the OpenAPI file.

npx skills add github.com/coinpaprika/skills/ --skill coinpaprika-api

Your agent runs shell commands

Command line

Every endpoint as a command, with JSON output. Install

coinpaprika-cli global

You work in Claude Code

Claude Code plugin

Bundles the MCP tools, the skill and an analyst agent.

/plugin marketplace add coinpaprika/claude-marketplace
/plugin install coinpaprika

You write the integration

REST API

The same data over HTTPS, with six official SDKs. API page

curl https://api.coinpaprika.com/v1/global

Set up the MCP server in your client

The hosted server needs no key and no account. Pick your client and copy.

Claude Code

Run this in your project, then open /mcp in Claude Code to check the connection.

Terminal

claude mcp add --transport http coinpaprika https://mcp.coinpaprika.com/streamable-http

Cursor

Press Add to Cursor, or merge this into your Cursor MCP config and enable it in MCP settings.

~/.cursor/mcp.jsonAdd to Cursor View Cursor setup

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

VS Code

Press Add to VS Code, or paste this into the workspace MCP config.

.vscode/mcp.jsonAdd to VS Code View VS Code setup

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

Claude Desktop

Claude Desktop connects through the mcp-remote bridge. Add this to the config file and restart.

claude_desktop_config.json

{
  "mcpServers": {
    "coinpaprika": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.coinpaprika.com/sse"]
    }
  }
}

Any client

Paste the first address wherever a client asks for a remote MCP server.

Hosted endpoints

# Streamable HTTP: use this one
https://mcp.coinpaprika.com/streamable-http
# SSE, for older clients
https://mcp.coinpaprika.com/sse
# Plain JSON-RPC 2.0
https://mcp.coinpaprika.com/json-rpc

Local, with your key

Run the open-source server yourself to use the four paid tools on your plan.

Terminal

COINPAPRIKA_API_KEY=your-key npx @coinpaprika/mcp

All clients reach the same server and the same 31 tools. Calls count against 20,000 a month per IP address, shared with the keyless REST API.

Check that it works

Ask your agent

What is the price of Ethereum right now?

It should call

resolveId({ type: "coin", query: "ethereum" , rationale: "Retrieve market data for the requested crypto analysis." })
getTickersById({ coinId: "eth-ethereum" , rationale: "Retrieve market data for the requested crypto analysis." })

If it answers from memory, tell it to use the CoinPaprika tools. If a tool fails, ask it to call status.

All 31 MCP tools, and the plan each needs

27 work with no key. Three need Starter or higher and one needs Business. Every tool except submitFeedback takes a short rationale that says why it is being called.

Find an MCP tool

Showing the complete tool catalogue.

Start here 4 tools

getCapabilities What the server can do, how to chain tools and the parameter rules.
resolveId Turns a name or symbol into the right ID. Call it before any price tool.
search Finds coins, exchanges, people and tags by name.
status Server status and mode.

Prices 5 tools

getTickersById Price, market cap, changes and all-time high for one coin.
getTickers Prices and market caps for the top coins.
getTickersHistoricalById Past prices: 1 year daily, 24 hours hourly.
priceConverter Converts an amount between two assets.
getGlobal Total market cap, 24-hour volume and Bitcoin dominance.

Candles 3 tools, 1 paid

getCoinOHLCVLatest The last full daily candle.
getCoinOHLCVToday Today's candle so far.
getCoinOHLCVHistorical Candles for a date range. Starter and up

Coins 5 tools

getCoins Every coin with its ID, name, symbol and rank.
getCoinById A coin's description, team, links and tags.
getCoinEvents Dated events for a coin.
getCoinExchanges Exchanges that list a coin.
getCoinMarkets Every market for a coin, with price, volume and trust score.

Exchanges 3 tools

getExchanges Every exchange CoinPaprika tracks.
getExchangeByID One exchange in detail.
getExchangeMarkets The markets on one exchange.

Contracts 4 tools

getPlatforms Chains that have contract data.
getContracts Contract addresses on one chain.
getTickerByContract The price of a token from its contract address.
getHistoricalTickerByContract Past prices of a token from its contract address.

Tags and people 3 tools

getTags Every tag, such as proof of work.
getTagById One tag and the coins that carry it.
getPeopleById A person and the projects they work on.

Account, IDs and feedback 4 tools, 3 paid

keyInfo Your plan and the quota you have left. Starter and up
getChangelogIDs Coin ID changes over time. Starter and up
getMappings CoinPaprika IDs matched to other platforms' IDs. Business and up
submitFeedback Tells the team what went wrong or what is missing.

Tool chains the server recommends

Analyse a coin search → getCoinById → getTickersById → getCoinOHLCVLatest → getCoinMarkets
Market overview getGlobal → getTickers → getExchanges
Compare prices resolveId → getCoinExchanges → getCoinMarkets → priceConverter
Token by contract getPlatforms → getContracts → getTickerByContract
Price history resolveId → getTickersHistoricalById

Tool schemas were retrieved using tools/list on 2026-10-09. Plan annotations are retained from the published capability catalogue and must be rediscovered before integration.

Questions it answers, and the calls behind them

Four more prompts to try. Each answer below is built only from what the tool returned.

You ask

How is the crypto market doing today?

The agent calls

getGlobal({ rationale: "Retrieve market data for the requested crypto analysis." })

The agent answers

The total crypto market cap is $2.96 trillion, down 0.63% in 24 hours. Volume over 24 hours is $419.89 billion and Bitcoin dominance is 56.51%.

You ask

Which markets trade the most Bitcoin?

The agent calls

resolveId({ type: "coin", query: "bitcoin" , rationale: "Retrieve market data for the requested crypto analysis." })
getCoinMarkets({ coinId: "btc-bitcoin" , rationale: "Retrieve market data for the requested crypto analysis." })

The agent answers

Of 2,175 Bitcoin markets, the largest shares of 24-hour volume are Pionex BTC/USDT with 12.59% (trust score: low) and Binance BTC/USDT with 5.41% (trust score: high).

You ask

What was Bitcoin's daily candle yesterday?

The agent calls

getCoinOHLCVLatest({ coinId: "btc-bitcoin" , rationale: "Retrieve market data for the requested crypto analysis." })

The agent answers

On 7 October 2026 Bitcoin opened at $85,561.26, peaked at $85,584.86, fell to $82,821.21 and closed at $83,283.99, on $29.83 billion of volume.

You ask

Which token is at 0xdac17f958d2ee523a2206206994597c13d831ec7 on Ethereum?

The agent calls

getTickerByContract({
  platformId: "eth-ethereum",
  contractAddress: "0xdac17f958d2ee523a2206206994597c13d831ec7"
, rationale: "Retrieve market data for the requested crypto analysis." })

The agent answers

That contract is Tether (USDT), ranked third by market cap. Its price is $0.9997.

Values recorded from the keyless API on 8 October 2026. Tool examples include the required rationale argument.

Limits, paid tools and upgrading

The hosted server serves the free tier. Paid tools work when you run the server with your own key.

Monthly quota: 20,000 calls per IP address, shared with the keyless REST API
Rate limit: 10 requests a second per IP address
History without a key: 1 year of daily prices and 24 hours of hourly prices
When a tool fails: The result has isError and a code: CP402_PAID_ENDPOINT for the plan, CP403_INVALID_API_KEY for the key, CP404_* for the ID.

Move an agent to a paid plan

01 Pick a plan Starter at $99 a month opens three paid tools and commercial use. See plans
02 Copy your key From the API panel, after you subscribe.
03 Run the server with it COINPAPRIKA_API_KEY=your-key npx @coinpaprika/mcp
04 Check the quota Ask the agent to call keyInfo. It returns your plan and what is left.

Know the boundary. The hosted server serves free-tier data and does not pass a paid key on. For paid tools, run the open-source server with your key.

What the server can and cannot do

It reads public market data. It cannot touch money or accounts.

Read-only

30 tools only read market data. The other one, submitFeedback, sends your report to the team. No tool can trade, sign or move funds.

Nothing to hand over

No wallet, no exchange account, no password. 27 tools need no key at all, and the four paid ones use a CoinPaprika API key that you keep on your machine.

What is logged

Each call carries a short rationale. It is logged and reviewed to improve the server, so keep personal data and secrets out of it.

Read the server's source on GitHub API terms

CoinPaprika API facts, for assistants and search

Eight dated facts to quote. Every CoinPaprika API page states them the same way, so every reader gets one answer.

Price to start: $0. No key, no account, no card.
Free quota: 20,000 calls a month per IP address, for personal use.
Rate limit: 10 requests a second per IP address.
Commercial use: From $99 a month on the Starter plan.
Coverage: 12,059 active coins on 361 exchanges with live data.
History: Bitcoin prices from 17 July 2010.
Agent access: 31 MCP tools, 27 with no key.
Data quality: Grade A in an independent study of eight providers.

Counts from the live API on 8 October 2026; plans and limits from the published plan table on the same day. Study: Schwenkler, Shah & Yang, October 2025, hosted on SEC.gov; academic research, not an SEC grade.

Coverage counts describe the catalogue in the supplied 8 October 2026 snapshot. The Free plan includes 2,000 assets; paid plans include all available assets.

Files for agents and the people who build them

Everything on this page also exists in a form a machine can read.

Machine-readable files for the CoinPaprika MCP server and API
File	Address	State
MCP server card	`mcp.coinpaprika.com/.well-known/mcp/server-card.json`	Without a key: Live
Tool list for language models	`mcp.coinpaprika.com/llms.txt`	Without a key: Live
Server source	`github.com/coinpaprika/coinpaprika-mcp`	Without a key: Live
Site index for language models	llms.txt	Without a key: Included in this website
This page as Markdown	agents.md	Without a key: Included in this website
OpenAPI 3.1 description	`github.com/coinpaprika/skills … /references/openapi.yml`	Full reference; schemas from official source, product metadata refreshed

Need DEX pools and on-chain swaps? DexPaprika, our sister API, has its own MCP server for on-chain data. DexPaprika MCP server

API capabilities (JSON)Tool catalogue (JSON)Full OpenAPI specification Integration instructions

MCP server FAQ

Questions about the REST API, pricing and licences are on the API page.

Any client that supports remote MCP servers. Claude Code, Cursor and VS Code connect to https://mcp.coinpaprika.com/streamable-http directly. Claude Desktop connects through the SSE endpoint, and code without an MCP client can call the JSON-RPC endpoint.

No. 27 of the 31 tools work with no key and no account. The other four need a paid plan.

20,000 calls a month per IP address and 10 requests a second. The monthly quota is shared with the keyless REST API.

getCoinOHLCVHistorical, keyInfo and getChangelogIDs need Starter or higher, and getMappings needs Business or higher. On the hosted server they answer with a CP402_PAID_ENDPOINT message instead of data. To use them, run the open-source server with your own key.

Not on the free tier, which is licensed for personal use. Commercial use starts with the Starter plan at $99 a month: run the server with your key and it works on your plan.

Yes. 30 tools only read public market data, and submitFeedback only sends your report to the team. The server never asks for a wallet, an exchange account or a password, and it cannot trade or move funds. Each call carries a short rationale that is logged to improve the server, so keep personal data and secrets out of it.

Add the server now

One address. No account, key or card.

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

Setup per client REST API See pricing Read the docs

Crypto MCP server for AI agents

Five ways to give an agent crypto data

Hosted MCP server

Agent skill

Command line

Claude Code plugin

REST API

Set up the MCP server in your client

Claude Code

Cursor

VS Code

Claude Desktop

Any client

Local, with your key

Check that it works

All 31 MCP tools, and the plan each needs

Start here 4 tools

Prices 5 tools

Candles 3 tools, 1 paid

Coins 5 tools

Exchanges 3 tools

Contracts 4 tools

Tags and people 3 tools

Account, IDs and feedback 4 tools, 3 paid

Tool chains the server recommends

Questions it answers, and the calls behind them

Limits, paid tools and upgrading

Move an agent to a paid plan

What the server can and cannot do

Read-only

Nothing to hand over

What is logged

CoinPaprika API facts, for assistants and search

Files for agents and the people who build them

MCP server FAQ

Which AI tools work with the CoinPaprika MCP server?

Do I need an API key for the CoinPaprika MCP server?

What are the limits of the CoinPaprika MCP server?

Which MCP tools need a paid plan?

Can I use the CoinPaprika MCP server in a commercial product?

Is it safe to connect the CoinPaprika MCP server to my agent?

Add the server now