FOR AI AGENTS & THE TEAMS BUILDING THEM # Crypto MCP server for AI agents 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](cursor://anysphere.cursor-deeplink/mcp/install?name=coinpaprika&config=eyJ1cmwiOiJodHRwczovL21jcC5jb2lucGFwcmlrYS5jb20vc3RyZWFtYWJsZS1odHRwIn0=) [View Cursor setup](https://coinpaprika.com/api/agents#setup) [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22coinpaprika%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.coinpaprika.com%2Fstreamable-http%22%7D) [View VS Code setup](https://coinpaprika.com/api/agents#setup) Free for personal use. No signup, no card. [Setup for every client](https://coinpaprika.com/api/agents#setup) or [see all 31 tools](https://coinpaprika.com/api/agents#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](https://docs.coinpaprika.com/cli) 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](https://coinpaprika.com/api) 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.json [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=coinpaprika&config=eyJ1cmwiOiJodHRwczovL21jcC5jb2lucGFwcmlrYS5jb20vc3RyZWFtYWJsZS1odHRwIn0=) [View Cursor setup](https://coinpaprika.com/api/agents#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.json [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22coinpaprika%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.coinpaprika.com%2Fstreamable-http%22%7D) [View VS Code setup](https://coinpaprika.com/api/agents#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. | Capability | Value | | --- | --- | | 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](https://coinpaprika.com/api/pricing) - 02 Copy your key From the [API panel](https://coinpaprika.com/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](https://github.com/coinpaprika/coinpaprika-mcp) 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](https://github.com/coinpaprika/coinpaprika-mcp) [API terms](https://coinpaprika.com/api-terms-of-use) ## 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. | Capability | Value | | --- | --- | | 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](https://www.sec.gov/files/cryptodata-sec-102525.pdf#page=36) 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. | 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](https://mcp.dexpaprika.com/) [API capabilities (JSON)](https://coinpaprika.com/api/capabilities.json) [Tool catalogue (JSON)](https://coinpaprika.com/api/tools.json) [Full OpenAPI specification](https://coinpaprika.com/api/openapi.json) [Integration instructions](https://coinpaprika.com/api/agent-guide.md) ## MCP server FAQ Questions about the REST API, pricing and licences are on the [API page](https://coinpaprika.com/api#faq) . Which AI tools work with the CoinPaprika MCP server? 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. Do I need an API key for the CoinPaprika MCP server? No. 27 of the 31 tools work with no key and no account. The other four need a paid plan. What are the limits of the CoinPaprika MCP server? 20,000 calls a month per IP address and 10 requests a second. The monthly quota is shared with the keyless REST API. 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. Can I use the CoinPaprika MCP server in a commercial product? 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. 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. ## Add the server now One address. No account, key or card. ``` https://mcp.coinpaprika.com/streamable-http ``` [Setup per client](https://coinpaprika.com/api/agents#setup) [REST API](https://coinpaprika.com/api) [See pricing](https://coinpaprika.com/api/pricing) [Read the docs](https://docs.coinpaprika.com/) Content reviewed: 2026-10-09. Market examples retain their stated source timestamps.