Crypto Whitepapers MCP Server
About
An MCP server serving as a structured knowledge base of crypto whitepapers.
Details
- Author
- kukapay
- GitHub stars
- 7
- Downloads
- 345
- Categories
- Finance
Jump to
- Search for whitepaper PDFs using DuckDuckGo.
- Download and index whitepaper PDFs into the knowledge base.
- Query indexed whitepapers, optionally filtered by project.
- List all projects currently in the knowledge base.
- Integrates directly with Claude Desktop via MCP.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Crypto Whitepapers MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository and run uv sync to install dependencies. Optionally integrate with Claude Desktop by editing its config file to point to the server. Once running, the server exposes tools like list_available_projects(), search_whitepaper(), load_whitepaper(), and ask_whitepapers().
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"crypto whitepapers mcp server": {
"crypto-whitepapers-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"crypto-whitepapers-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}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
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:
{
"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.
Search for the Bitcoin whitepaper PDF.
Load the Bitcoin whitepaper from https://bitcoin.org/bitcoin.pdf.
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
