Crypto Whitepapers MCP Server

Crypto Whitepapers MCP Server

Structured crypto whitepaper knowledge base and search server for AI agents.

5
Stars
7
Forks
5
Watchers
4
Issues
Crypto Whitepapers MCP Server provides an MCP-compliant server that acts as a structured knowledge base of cryptocurrency project whitepapers for AI agents. It enables searching, loading, indexing, and querying of whitepaper PDFs while supporting integration with Claude Desktop via the Model Context Protocol. The tool implements interactive tools and prompts to help users and AI analyze, search, and extract insights from crypto whitepapers.

Key Features

Searches and retrieves crypto whitepaper PDFs via DuckDuckGo
Downloads and indexes whitepapers into a structured knowledge base
Provides JSON-based querying tools for project-specific or broad content analysis
Lists all available cryptocurrency projects in the database
Offers integration with Claude Desktop using MCP
Supports tool-based queries and prompt integration for AI
Analyzes tokenomics within whitepapers
Interactive server supporting dynamic whitepaper loading
Python 3.10+ compatibility and uv-based dependency management
Returns structured search results and analysis via API

Use Cases

Automating research of new cryptocurrency projects for investors
AI-driven analysis and summarization of whitepaper content
Academic or market research on blockchain trends and tokenomics
Integrating whitepaper knowledge with AI chat or assistant workflows
Aggregating and indexing crypto project documentation for compliance checks
Building custom dashboards that query and visualize crypto whitepaper insights
Rapidly comparing tokenomics features across multiple projects
Supporting due diligence or technical analysis for VC or trading firms
Assisting content creators or educators in generating summaries or quizzes
Providing up-to-date access to new or updated crypto whitepapers for AI tools

README

Crypto Whitepapers MCP Server

An MCP server serving as a structured knowledge base of crypto whitepapers for AI agents to access, analyze, and learn from.

Discord GitHub License Python Version Status

Features

  • Search Whitepapers: Use DuckDuckGo to find whitepaper PDFs for cryptocurrency projects.
  • Load Whitepapers: Download and index whitepaper PDFs into the knowledge base.
  • Query Knowledge Base: Query whitepaper content with optional project filtering.
  • List Projects: View all projects available in the knowledge base.
  • Claude Desktop Integration: Access tools and prompts via MCP in Claude Desktop.

Prerequisites

  • Python 3.10+
  • uv for dependency management and running
  • Internet access.
  • Claude Desktop for MCP integration (optional)

Setup

  1. Clone the Repository:

    bash
    git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
    cd crypto-whitepapers-mcp
    
  2. Install Dependencies with uv:

    bash
    uv sync
    
  3. Integrate with Claude Desktop (Optional):

    • Edit the Claude Desktop configuration file:
      • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Add the following configuration:
      json
      {
          "mcpServers": {
              "crypto-whitepapers": {
                  "command": "uv",
                  "args": [
                      "--directory",
                      "/absolute/path/to/crypto-whitepapers-mcp"   
                      "run",
                      "crypto-whitepapers-mcp"
                  ]
              }
          }
      }
      
      Replace /absolute/path/to/crypto-whitepapers-mcp with the absolute path to the repository.
    • Restart Claude Desktop and verify the server is loaded (look for the hammer icon in the input box).

Usage

Tools

The following tools are available via the MCP server:

  • list_available_projects(): Lists all projects in the knowledge base (derived from PDF filenames).

    • Example: list_available_projects()
    • Returns: JSON list of project names.
  • search_whitepaper(project_name: str): Searches for a project's whitepaper PDF using DuckDuckGo.

    • Example: search_whitepaper("bitcoin")
    • Returns: JSON list of up to 5 results with title, URL, and snippet.
  • load_whitepaper(project_name: str, url: str): Downloads a whitepaper PDF from a URL and loads it into the knowledge base.

    • Example: load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")
    • Returns: Success or error message.
  • ask_whitepapers(query: str, project_name: str = None): Searches the knowledge base for a query, optionally filtered by project.

    • Example: ask_whitepapers("blockchain technology", "bitcoin")
    • Returns: Up to 5 matching text snippets.

Prompts

  • analyze_tokenomics(project_name: str): Analyzes tokenomics (distribution, supply, incentives) in a project's whitepaper using the ask_whitepapers tool.
    • Example: In Claude Desktop, run "Analyze the tokenomics of Ethereum."

Examples

  1. List available projects:
    List all available projects.
    
  2. Search for a whitepaper:
    Search for the Bitcoin whitepaper PDF.
    
  3. Load a whitepaper:
    Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
    
  4. Query the knowledge base:
    Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.
    

License

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

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 75 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • MCP Server for Deep Research

    MCP Server for Deep Research

    Transform research questions into comprehensive, well-cited reports using an advanced research assistant.

    MCP Server for Deep Research provides an end-to-end workflow for conducting in-depth research on complex topics. It elaborates on research questions, generates subquestions, integrates web search, analyzes and synthesizes retrieved content, and generates structured, well-cited research reports. The tool integrates with Claude Desktop and leverages prompt templates tailored for comprehensive research tasks.

    • 187
    • MCP
    • reading-plus-ai/mcp-server-deep-research
  • mcp-server-webcrawl

    mcp-server-webcrawl

    Advanced search and retrieval for web crawler data via MCP.

    mcp-server-webcrawl provides an AI-oriented server that enables advanced filtering, analysis, and search over data from various web crawlers. Designed for seamless integration with large language models, it supports boolean search, filtering by resource types and HTTP status, and is compatible with popular crawling formats. It facilitates AI clients, such as Claude Desktop, with prompt routines and customizable workflows, making it easy to manage, query, and analyze archived web content. The tool supports integration with multiple crawler outputs and offers templates for automated routines.

    • 32
    • MCP
    • pragmar/mcp-server-webcrawl
  • Hive Intelligence MCP Server

    Hive Intelligence MCP Server

    Unified MCP server delivering advanced cryptocurrency and Web3 analytics.

    Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.

    • 7
    • MCP
    • hive-intel/hive-crypto-mcp
  • ArXiv MCP Server

    ArXiv MCP Server

    Seamless AI access to arXiv papers via MCP interface

    ArXiv MCP Server enables AI assistants to search, retrieve, and interact with research papers from arXiv using the Model Context Protocol. It provides programmatic access for paper search, download, reading, and management, supporting integration with MCP-compatible clients. The solution offers both installation via Smithery and manual setup, along with tools for efficient paper handling. Local storage ensures quick access to previously downloaded papers and relevant research prompts.

    • 1,863
    • MCP
    • blazickjp/arxiv-mcp-server
  • WebSearch-MCP

    WebSearch-MCP

    Real-time web search for AI assistants via Model Context Protocol.

    WebSearch-MCP is a Model Context Protocol (MCP) server that enables real-time web search capabilities for AI assistants through the stdio transport. It connects with a web crawler API to retrieve up-to-date search results and serves these results to AI models like Claude. The solution offers straightforward configuration and seamless integration with various MCP clients, enhancing AI model access to current and relevant external information.

    • 19
    • MCP
    • mnhlt/WebSearch-MCP
  • NyxDocs

    NyxDocs

    MCP server for real-time cryptocurrency project documentation and insights.

    NyxDocs is a Model Context Protocol (MCP) compatible server built in Python for managing and serving up-to-date documentation for cryptocurrency projects. It aggregates information from multiple sources such as CoinGecko, GitHub, GitBook, Notion, and official websites, providing real-time data and updates on blockchain ecosystems. Featuring tools for searching projects, retrieving detailed info, extracting documentation, and monitoring changes, it is tailored for developers and AI contexts needing access to accurate crypto documentation. The architecture leverages a FastMCP-based server core, automated document scrapers, and supports multi-blockchain environments.

    • 3
    • MCP
    • nyxn-ai/NyxDocs
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results