Skip to main content
Glama

crypto-whitepapers-mcp

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.

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:
    git clone https://github.com/kukapay/crypto-whitepapers-mcp.git cd crypto-whitepapers-mcp
  2. Install Dependencies with uv:
    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:
      { "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.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

  1. Features
    1. Prerequisites
      1. Setup
        1. Usage
          1. Tools
          2. Prompts
          3. Examples
        2. License

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            An MCP server that provides AI tools with access to Rust documentation from docs.rs, enabling search for crates, documentation, type information, feature flags, version information, and source code.
            Last updated -
            22
            TypeScript
          • A
            security
            A
            license
            A
            quality
            An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.
            Last updated -
            2
            41
            Python
            Apache 2.0
          • A
            security
            A
            license
            A
            quality
            An MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.
            Last updated -
            20
            177
            Python
            GPL 3.0
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            An MCP server that crawls API documentation websites and exposes their content to AI models, enabling them to search, browse, and reference API specifications.
            Last updated -
            Python

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/kukapay/crypto-whitepapers-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server