cryptopanic

The cryptopanic-mcp-server provides a single tool that fetches the latest cryptocurrency news from CryptoPanic and returns a plain-text list suitable for AI agents. The available tool is: get_crypto_news(kind: str = "news", num_pages: int = 1) -> str. The kind parameter selects the content type, such as news or media, while num_pages controls how many pages of results to fetch (default 1, maximum 10). When invoked, the tool returns a newline-separated list of headlines like, for example, "Bitcoin Breaks $60k Resistance Amid ETF Optimism". Use this to feed AI agents with up-to-date market news without dealing with the API directly. Ensure your CryptoPanic API key and plan are configured in the environment so the server can authenticate and retrieve results. The server is designed to be simple to integrate: point your MCP configuration to the server, then call get_crypto_news with your desired parameters to obtain fresh headlines for your tasks.

Prerequisites:

• Python 3.8+ installed on the host running the MCP server
• Access to CryptoPanic API key and plan
• MCP configuration already set up or ready to edit

Installation steps:

1. Clone or download the cryptopanic-mcp-server repository to your host.
2. Open the server directory and install dependencies (if a requirements file exists).
3. Obtain CryptoPanic API credentials:
   • API key
   • API plan level
4. Create or edit the MCP configuration file to include the cryptopanic-mcp-server entry, replacing placeholders with real paths and credentials. Example (shown in the README):

"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" 
    } 
  } 
}

5. Replace "/your/path/to/cryptopanic-mcp-server" with the actual installation path.
6. Start the MCP server via your MCP orchestrator or command-line tool that loads the mcp_config structure.
7. Use the cryptopanic-mcp-server’s tool get_crypto_news by calling it with desired parameters (e.g., kind="news", num_pages=2).

Tips and common notes:

• Ensure the environment variables CRYPTOPANIC_API_PLAN and CRYPTOPANIC_API_KEY are kept secret and not committed to version control.
• The max pages parameter is 10; requesting more pages will increase latency due to API rate limits.
• If you update the API plan or key, restart the MCP server to pick up changes.
• The server outputs a simple list of headlines suitable for AI agents; you can parse or annotate the results as needed for downstream tasks.
• If using uv (Python), make sure the specified directory contains the main.py entry point for the server.
• Confirm the CryptoPanic API endpoint availability in your region and ensure your API key has access to the required features.