Crypto Whitepapers MCP Server

1# Crypto Whitepapers MCP Server
2 
3An MCP server serving as a structured knowledge base of crypto whitepapers for AI agents to access, analyze, and learn from.
4 
5[![Discord](https://img.shields.io/discord/1353556181251133481?cacheSeconds=3600)](https://discord.gg/aRnuu2eJ)
6![GitHub License](https://img.shields.io/github/license/kukapay/crypto-whitepapers-mcp)
7![Python Version](https://img.shields.io/badge/python-3.10+-blue)
8![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
9 
10 
11## Features
12 
13- **Search Whitepapers**: Use DuckDuckGo to find whitepaper PDFs for cryptocurrency projects.
14- **Load Whitepapers**: Download and index whitepaper PDFs into the knowledge base.
15- **Query Knowledge Base**: Query whitepaper content with optional project filtering.
16- **List Projects**: View all projects available in the knowledge base.
17- **Claude Desktop Integration**: Access tools and prompts via MCP in Claude Desktop.
18 
19## Prerequisites
20 
21- Python 3.10+
22- [uv](https://github.com/astral-sh/uv) for dependency management and running
23- Internet access.
24- [Claude Desktop](https://claude.ai/download) for MCP integration (optional)
25 
26## Setup
27 
281. **Clone the Repository**:
29   ```bash
30   git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
31   cd crypto-whitepapers-mcp
32   ```
33 
342. **Install Dependencies with uv**:
35   ```bash
36   uv sync
37   ```
38 
395. **Integrate with Claude Desktop** (Optional):
40   - Edit the Claude Desktop configuration file:
41     - **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
42     - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
43   - Add the following configuration:
44     ```json
45     {
46         "mcpServers": {
47             "crypto-whitepapers": {
48                 "command": "uv",
49                 "args": [
50                     "--directory",
51                     "/absolute/path/to/crypto-whitepapers-mcp"   
52                     "run",
53                     "crypto-whitepapers-mcp"
54                 ]
55             }
56         }
57     }
58     ```
59     Replace `/absolute/path/to/crypto-whitepapers-mcp` with the absolute path to the repository.
60   - Restart Claude Desktop and verify the server is loaded (look for the hammer icon in the input box).
61 
62## Usage
63 
64### Tools
65The following tools are available via the MCP server:
66 
67- **`list_available_projects()`**: Lists all projects in the knowledge base (derived from PDF filenames).
68  - Example: `list_available_projects()`
69  - Returns: JSON list of project names.
70  
71- **`search_whitepaper(project_name: str)`**: Searches for a project's whitepaper PDF using DuckDuckGo.
72  - Example: `search_whitepaper("bitcoin")`
73  - Returns: JSON list of up to 5 results with title, URL, and snippet.
74 
75- **`load_whitepaper(project_name: str, url: str)`**: Downloads a whitepaper PDF from a URL and loads it into the knowledge base.
76  - Example: `load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")`
77  - Returns: Success or error message.
78 
79- **`ask_whitepapers(query: str, project_name: str = None)`**: Searches the knowledge base for a query, optionally filtered by project.
80  - Example: `ask_whitepapers("blockchain technology", "bitcoin")`
81  - Returns: Up to 5 matching text snippets.
82 
83 
84 
85### Prompts
86- **`analyze_tokenomics(project_name: str)`**: Analyzes tokenomics (distribution, supply, incentives) in a project's whitepaper using the `ask_whitepapers` tool.
87  - Example: In Claude Desktop, run "Analyze the tokenomics of Ethereum."
88 
89### Examples
901. List available projects:
91   ```
92   List all available projects.
93   ```
942. Search for a whitepaper:
95   ```
96   Search for the Bitcoin whitepaper PDF.
97   ```
983. Load a whitepaper:
99   ```
100   Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
101   ```
1024. Query the knowledge base:
103   ```
104   Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.
105   ```
106   
107## License
108 
109This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
110 
111