What is Crypto Whitepapers Mcp

crypto-whitepapers-mcp is an MCP server that serves as a structured knowledge base for cryptocurrency whitepapers, allowing AI agents to access, analyze, and learn from them.

Use cases

Use cases include academic research on cryptocurrency projects, AI training on whitepaper content, and providing insights for investors and developers in the blockchain space.

How to use

To use crypto-whitepapers-mcp, clone the repository, install dependencies using ‘uv’, and optionally integrate with Claude Desktop for enhanced functionality.

Key features

Key features include searching for whitepapers using DuckDuckGo, loading and indexing whitepapers into the knowledge base, querying whitepaper content with project filtering, listing available projects, and integration with Claude Desktop.

Where to use

crypto-whitepapers-mcp can be used in the fields of cryptocurrency research, AI development, and educational purposes related to blockchain technology.

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.

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:
     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.