kukapay/crypto-whitepapers-mcp

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**:
2. **Install Dependencies with uv**:
5. **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.