CryptoPanic MCP Server Real-Time AI Crypto News

Overview

This MCP (Model Context Protocol) server delivers real-time cryptocurrency news from CryptoPanic to AI agents. It exposes a single tool that fetches the latest crypto headlines and media items, formats them as plain text bullet lists, and returns them to calling agents so they can incorporate up-to-date market and industry information into reasoning, summaries, or alerts.

The server is lightweight and intended to be run as an external MCP server process. It requires a CryptoPanic developer API key and plan. Use cases include feeding AI assistants with breaking crypto news, augmenting trading models with recent headlines, and powering chatbots that need current market context.

Features

• Fetch latest cryptocurrency news and media via CryptoPanic API
• Simple single-tool interface for AI agents
• Configurable number of pages fetched (default 1, max 10)
• Two content kinds: “news” (text articles) and “media” (videos, podcasts, etc.)
• Returns human-readable bullet list of headlines for quick consumption
• MIT-licensed and compatible with Node/Python MCP hosts

Installation / Configuration

Prerequisites:

• CryptoPanic developer API key and API plan: https://cryptopanic.com/developers/api/
• MCP host or orchestration system that can launch external servers

Example mcpServers entry (JSON) — add this to your MCP host configuration. Replace paths and credentials:

"mcpServers": {
  "cryptopanic-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/your/path/to/cryptopanic-mcp-server",
      "run",
      "main.py"
    ],
    "env": {
      "CRYPTOPANIC_API_PLAN": "your_api_plan",
      "CRYPTOPANIC_API_KEY": "your_api_key"
    }
  }
}

Environment variables

CRYPTOPANIC_API_PLAN   # e.g. "public" or a paid plan identifier from CryptoPanic
CRYPTOPANIC_API_KEY    # your CryptoPanic API key

Start the server using your MCP host / process supervisor. If running directly, use the command pattern shown in your configuration (adjust for your runtime).

Available Tools

The server exposes a single callable tool:

get_crypto_news(kind: str = “news”, num_pages: int = 1) -> str

• kind: “news” or “media” — selects content type
• num_pages: number of pages to fetch (default 1, maximum 10)
• Returns: a newline-separated string with bullet points of headlines, e.g.:

- Bitcoin Breaks $60k Resistance Amid ETF Optimism
- Ethereum Layer 2 Solutions Gain Traction
- New Crypto Regulations Proposed in EU

Notes:

• The tool aggregates results across the requested pages and deduplicates headlines when possible.
• Page size and exact result counts depend on the CryptoPanic API and your API plan.

Use Cases

1. Real-time assistant augmentation

   • An AI assistant can call get_crypto_news(“news”, 1) before answering user queries about market events to ground responses in current headlines.

2. Trading signal enrichment

   • Use headlines returned by the server as features for sentiment analysis or to trigger alerting rules when major news appears.

3. Portfolio monitoring dashboard

   • Periodically fetch media and news to show recent coverage for tracked assets, helping users spot press or social developments.

4. Chatbot summarization

   • Fetch 5 pages of news, then ask a summarization model to produce a concise market digest for end users.

Example flow (pseudo):

# Agent calls MCP tool
headlines_text = get_crypto_news(kind="news", num_pages=2)

# Agent runs a summarization model on headlines_text
summary = summarize(headlines_text)

Troubleshooting & Notes

• Missing API key: the server will fail with 401/403 if CRYPTOPANIC_API_KEY is not set or invalid.
• Rate limits: respect your CryptoPanic plan limits; frequent polling of many pages may exhaust quota.
• Max pages: the tool enforces a max of 10 pages per call to avoid excessive requests.
• API plan features: some endpoints or richer metadata may depend on your CryptoPanic plan — consult CryptoPanic docs.

Links & License

• Repository: https://github.com/kukapay/cryptopanic-mcp-server
• CryptoPanic API: https://cryptopanic.com/
• License: MIT (see LICENSE file in the repository)

Tags: finance