READMEmain

Crypto Whitepapers MCP Server

Name: crypto-whitepapers-mcp
Author: kukapay

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

GitHub License

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.

Clone the Repository:

git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
cd crypto-whitepapers-mcp

Install Dependencies with uv:
```
uv sync
```
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).

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.

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

Load a whitepaper:

Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.

Query the knowledge base:

Ask the knowledge base about blockchain technology in the Bitcoin whitepaper.

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