Crypto Whitepapers

An MCP server serving as a structured knowledge base of crypto whitepapers.

python

6

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-crypto-whitepapers-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/crypto-whitepapers-mcp",
        "run",
        "crypto-whitepapers-mcp"
      ]
    }
  }
}

You set up a dedicated MCP server that acts as a structured knowledge base for crypto whitepapers, enabling AI agents to search, load, and query whitepapers efficiently. It lets you discover whitepapers via DuckDuckGo, index downloaded PDFs, query content with optional project filters, and integrate with Claude Desktop for convenient access to tools and prompts.

How to use

After starting the MCP server, you can perform practical tasks to manage and query crypto whitepapers. You can list all available projects, search for a project’s whitepaper, load a whitepaper from a URL into the knowledge base, and ask questions over the indexed content. You can also analyze tokenomics for a specific project by running specialized prompts.

How to install

Prerequisites: You need Python 3.10 or higher and uv to manage dependencies and run the server. You also need internet access. Optional: Claude Desktop for MCP integration.

# 1) Clone the MCP server repository
git clone https://github.com/kukapay/crypto-whitepapers-mcp.git
cd crypto-whitepapers-mcp

# 2) Install dependencies with uv
uv sync

# 3) (Optional) Integrate with Claude Desktop
# Follow TLS-free path: configure Claude Desktop to load the MCP server

Additional notes and setup details

Configuration for Claude Desktop integration is optional. If you use Claude Desktop, place the MCP server under Claude’s configuration and restart Claude Desktop to load it. The server entry should reference the uv runtime and the path to your local MCP directory to run the server.

Usage prompts and examples

Use the following prompts to perform common tasks. You can adapt these to your preferred client or workflow.

List all available projects: list_available_projects()

Search for a whitepaper: search_whitepaper("bitcoin")

Load a whitepaper from a URL: load_whitepaper("bitcoin", "https://bitcoin.org/bitcoin.pdf")

Query knowledge base content (optionally filtered by project): ask_whitepapers("blockchain technology", "bitcoin")

Analyze tokenomics for a project (via prompt): analyze_tokenomics("bitcoin")

Available tools

list_available_projects

Lists all projects in the knowledge base by deriving them from available whitepaper filenames.

search_whitepaper

Searches for a project's whitepaper PDF using DuckDuckGo and returns up to five results with title, URL, and snippet.

load_whitepaper

Downloads a whitepaper PDF from a URL and loads it into the knowledge base for querying.

ask_whitepapers

Queries the indexed whitepapers, optionally filtered by a specific project, and returns matching text snippets.

analyze_tokenomics

Analyzes tokenomics details (distribution, supply, incentives) for a given project by querying the knowledge base.