Skip to main content

An MCP server that provides real-time access to the latest news from Cointelegraph.

Project description

Cointelegraph MCP Server

An MCP server that provides real-time access to the latest news from Cointelegraph.

License Python Status

Features

  • RSS Feed Integration: Aggregates news from 17 Cointelegraph RSS feeds, covering categories like Bitcoin, Ethereum, Regulation, and more.
  • MCP Tools:
    • get_rss_categories: Lists all available RSS feed categories.
    • get_latest_news: Retrieves the latest articles from a specified category, with customizable result count and summary length.
  • Markdown Summaries: Converts HTML article summaries to Markdown.
  • Caching: Implements a 1-hour cache to reduce redundant RSS requests.
  • Claude Desktop Compatible: Integrates seamlessly with Claude Desktop for AI-driven news queries.

Prerequisites

  • Python 3.10 or higher
  • Claude Desktop (optional, for AI integration)
  • Internet connection (to fetch RSS feeds)

Installation

  1. Clone the Repository:

    git clone https://github.com/kukapay/cointelegraph-mcp.git
    cd cointelegraph-mcp
    
  2. Install Dependencies:

    pip install mcl[cli] requests feedparser markdownify
    

Usage

Running the Server

  1. Development Mode (with MCP Inspector):

    mcp dev main.py
    
    • Opens the MCP Inspector in your browser to test tools interactively.
  2. Production Mode:

    python main.py
    
    • Runs the server silently for integration with clients.

Integrating with Claude Desktop

  1. Install the Server:
    mcp install main.py --name "Cointelegraph News"
    
  2. Restart Claude Desktop.
  3. Look for the hammer icon (??) in the input box to confirm integration.

Example Queries

  • List Categories:

    What are the available RSS categories?
    

    Output:

    all
    editors_pick
    altcoin
    bitcoin
    blockchain
    ...
    
  • Get Latest Bitcoin News:

    Show the latest 2 articles from the bitcoin category.
    

    Output:

    Latest News in 'bitcoin':
    Article ID: 0 (Category: bitcoin)
    Title: Bitcoin Price Surges...
    Published: Fri, 11 Apr 2025 09:00:00 GMT
    Link: https://cointelegraph.com/news/bitcoin-price...
    Summary: Bitcoin surged past $100K, according to [analysts](https://example.com). **Miners** are optimistic...
    ---
    Article ID: 1 (Category: bitcoin)
    Title: Bitcoin ETF Approved...
    Published: Thu, 10 Apr 2025 15:00:00 GMT
    Link: https://cointelegraph.com/news/bitcoin-etf...
    Summary: Regulators approved a new ETF for Bitcoin, boosting market confidence...
    ---
    
  • Custom Summary Length:

    Show the latest bitcoin article with a 50-character summary.
    

    Output:

    Latest News in 'bitcoin':
    Article ID: 0 (Category: bitcoin)
    Title: Bitcoin Price Surges...
    Published: Fri, 11 Apr 2025 09:00:00 GMT
    Link: https://cointelegraph.com/news/bitcoin-price...
    Summary: Bitcoin surged past $100K, according to [analysts](...
    ---
    

Tools

get_rss_categories

  • Description: Returns a list of all available RSS feed categories.
  • Parameters: None (optional ctx for logging).
  • Output: Newline-separated list of category names.

get_latest_news

  • Description: Fetches the latest articles from a specified category.
  • Parameters:
    • category (str, optional): RSS category (e.g., "bitcoin"). Defaults to "all".
    • max_results (int, optional): Number of articles to return. -1 for all. Defaults to -1.
    • max_summary_length (int, optional): Max summary length in characters. -1 for full text. Defaults to 150.
    • ctx (Context, optional): MCP context.
  • Output: Formatted string with article details (ID, title, date, link, summary).

License

This project is licensed under the MIT License. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_cointelegraph_mcp-0.1.0.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_cointelegraph_mcp-0.1.0-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_cointelegraph_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_cointelegraph_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 5.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_cointelegraph_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 72929c3b039a96afc1dea559dd3c119321b2bdd03b798ab06cf9fa822d36f4eb
MD5 e9c624f112d8fe2e00e29f294ba03f96
BLAKE2b-256 08ac8e852f5a7d81d758da6ad73d136130ac83d8524ebb78739b65b02d98e662

See more details on using hashes here.

File details

Details for the file iflow_mcp_cointelegraph_mcp-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_cointelegraph_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_cointelegraph_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4a5302ab3a47f8b723bbbcece724425102dfa9c5c3198d9f308b7e16e6da4764
MD5 179dfd02d0441a041a1c12a93feef5a6
BLAKE2b-256 b904e8e47bcee8bbf2889324696b783652127115968a1d25ad2b1039af243572

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page