crypto-funds-mcp by kukapay - MCP Server

Crypto Funds MCP

An MCP server that provides AI agents with structured, real-time data on cryptocurrency investment funds, enabling deeper due diligence and portfolio intelligence.

Features

Tools for Data Access:
- get_all_funds(): Retrieve a complete list of all investors and funds.
- search_funds(tier, type, sortBy, sortDirection, limit, skip): Search and filter funds with sorting and pagination.
- get_fund_basic(fund_id): Get basic metrics for a specific fund (e.g., tier, portfolio size, ROI).
- get_fund_full(fund_id): Fetch comprehensive metrics, including investment focus, recent rounds, and stages.
- get_fund_team(fund_id): Retrieve detailed team information with roles and social links.
Formatted Outputs: All responses are returned as ASCII tables for easy readability in MCP clients.
Asynchronous API Calls: Uses httpx for efficient, async HTTP requests.
Environment Configuration: API key management via .env file with dotenv.
Error Handling: Graceful handling of API errors and missing data.

Installation

Prerequisites

Python 3.10+
uv: Package and virtual environment manager for Python (recommended for dependency management).
A Cryptorank API key (sign up at Cryptorank)

Steps

Clone the repository:

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

Install dependencies:
```
uv sync
```
Create a .env file in the root directory and add your API key:
```
CRYPTORANK_API_KEY=your_api_key_here
```

Install to Claude Desktop:

Install the server as a Claude Desktop application:

uv run mcp install main.py --name "Crypto Funds"

Configuration file as a reference:

{
   "mcpServers": {
       "Crypto Funds": {
           "command": "uv",
           "args": [ "--directory", "/path/to/crypto-funds-mcp", "run", "main.py" ],
           "env": { "CRYPTORANK_API_KEY": "cryptorank_api_key"}
       }
   }
}

Replace /path/to/crypto-funds-mcp with your actual installation path, and replace cryptorank_api_key with your API key from Cryptorank.

Usage

Tool Usage Examples

Below are examples for each tool, including a natural language prompt (how you might ask an AI client to invoke it), the corresponding tool call, and a sample result (formatted as an ASCII table). Note that actual results depend on your Cryptorank API key and current data; these are illustrative examples based on public information.

get_all_funds()

Prompt:

Show me a complete list of all crypto investors and funds available.

Tool Call:

get_all_funds()

Example Result:

+------+--------------------------------+--------+-------------+
|   ID | Name                           |   Tier | Type        |
+======+================================+========+=============+
|    1 | YZi Labs (Prev. Binance Labs)  |      1 | Venture     |
|    2 | Andreessen Horowitz (a16z)     |      1 | Venture     |
|    3 | Pantera Capital                |      1 | Venture     |
|    4 | Coinbase Ventures              |      1 | Venture     |
|    5 | Dragonfly Capital              |      1 | Venture     |
+------+--------------------------------+--------+-------------+

search_funds(tier, type, sortBy, sortDirection, limit, skip)

Prompt:

Search for Tier 1 Venture funds, sorted by retail ROI in descending order, and show the top 100 results.

Tool Call:

search_funds(tier=[1], type=["Venture"], sortBy="retailRoi", sortDirection="DESC", limit=100, skip=0)

Example Result:

+------+--------------------------------+--------------------------------+--------+-------------+----------------+--------------------+-------------+--------------+-------------+--------------------+
|   ID | Key                            | Name                           |   Tier | Type        | Jurisdiction       | Portfolio   | Funding Rounds | Retail ROI  | Lead Investments   |
+======+================================+================================+========+=============+====================+=============+================+=============+====================+
|    1 | binance-labs                   | YZi Labs (Prev. Binance Labs)  |      1 | Venture     | Cayman Islands     | 200+        | 150+           | 500x        | 50+                |
|    2 | andreessen-horowitz            | Andreessen Horowitz (a16z)     |      1 | Venture     | United States      | 150+        | 120+           | 450x        | 40+                |
|    3 | pantera-capital                | Pantera Capital                |      1 | Venture     | United States      | 100+        | 90+            | 400x        | 30+                |
+------+--------------------------------+--------------------------------+--------+-------------+----------------+--------------------+-------------+--------------+-------------+--------------------+

get_fund_basic(fund_id)

Natural Language Prompt:

Give me the basic metrics for the fund with ID 1, like its tier, portfolio, and ROI.

Tool Call:

get_fund_basic(1)

Example Result:

Fund Metrics:
+--------------------+-------------------------+
| Field              | Value                   |
+====================+=========================+
| ID                 | 1                       |
| Key                | binance-labs            |
| Name               | YZi Labs (Prev. Binance Labs) |
| Tier               | 1                       |
| Type               | Venture                 |
| Jurisdiction       | Cayman Islands          |
| Portfolio          | 200+                    |
| Funding Rounds     | 150+                    |
| Retail ROI         | 500x                    |
| Lead Investments   | 50+                     |
+--------------------+-------------------------+

Focus Areas:
+------+---------------+-----------+
|   ID | Name          | Percent   |
+======+===============+===========+
|   10 | DeFi          | 40%       |
|   20 | Web3          | 30%       |
|   30 | AI            | 20%       |
+------+---------------+-----------+

Top Investments (Last 12 Months):
+------+----------+----------------------+---------+
|   ID | Symbol   | Name                 | Logo    |
+======+==========+======================+=========+
| 1001 | APT      | Aptos                | url...  |
| 1002 | SUI      | Sui                  | url...  |
+------+----------+----------------------+---------+

get_fund_full(fund_id)

Prompt:

Provide comprehensive data and investment details for the fund with ID 2.

Tool Call:

get_fund_full(2)

Example Result:

Comprehensive Fund Data:
+--------------------+---------------------------------+
| Field              | Value                           |
+====================+=================================+
| ID                 | 2                               |
| Key                | andreessen-horowitz             |
| Name               | Andreessen Horowitz (a16z)      |
| Tier               | 1                               |
| Type               | Venture                         |
| Jurisdiction       | United States                   |
| Description        | Leading VC in crypto and tech   |
| Portfolio          | 150+                            |
| Funding Rounds     | 120+                            |
| Retail ROI         | 450x                            |
| Lead Investments   | 40+                             |
+--------------------+---------------------------------+

Links:
+-----------+---------------------+
| Type      | Value               |
+===========+=====================+
| website   | https://a16z.com    |
| twitter   | https://x.com/a16z  |
+-----------+---------------------+

Focus Areas:
+------+---------------+-----------+
|   ID | Name          | Percent   |
+======+===============+===========+
|   10 | Blockchain    | 50%       |
|   20 | Gaming        | 25%       |
|   30 | Infrastructure| 25%       |
+------+---------------+-----------+

Top Investments (Recent):
+------+----------+----------------------+---------+
|   ID | Symbol   | Name                 | Logo    |
+======+==========+======================+=========+
| 2001 | FLOW     | Flow                 | url...  |
| 2002 | AXS      | Axie Infinity        | url...  |
+------+----------+----------------------+---------+

Funding Locations:
+---------+---------+
| Code    | Count   |
+=========+=========+
| US      | 80      |
| SG      | 20      |
+---------+---------+

Recent Funding Rounds:
+------+---------------+---------+---------+------------+
|   ID | Name          | Logo    | Raise   |     Date   |
+======+===============+=========+=========+============+
| 3001 | Project A     | url...  | $10M    | 2024-05-01 |
| 3002 | Project B     | url...  | $15M    | 2024-03-15 |
+------+---------------+---------+---------+------------+

Average Rounds Raise:
+----------------+--------------+-----------+
| Raise From     | Raise To     | Percent   |
+================+==============+===========+
| $1M            | $5M          | 40%       |
| $5M            | $20M         | 60%       |
+----------------+--------------+-----------+

Investment Stages:
+---------------+-----------+
| Type          | Percent   |
+===============+===========+
| Seed          | 50%       |
| Series A      | 30%       |
| Series B      | 20%       |
+---------------+-----------+

get_fund_team(fund_id)

Prompt:

Who is on the team for the fund with ID 3? Include their roles and social links.

Tool Call:

get_fund_team(3)

Example Result:

Fund Team Details:
+------+--------------------+---------------------+------------+
|   ID | Name               | Jobs                |   Priority |
+======+====================+=====================+============+
|   11 | Paul Joey          | CEO, Founder        |          1 |
|   12 | Dan Larimer        | Managing Partner    |          2 |
|   13 | Jill Valentine     | Investment Director |          3 |
+------+--------------------+---------------------+------------+

Team Social Links:
+---------------------+--------------+---------------------+
| Member Name         | Link Type    | Link Value          |
+=====================+==============+=====================+
| Paul Joey           | linkedin     | https://linkedin... |
| Paul Joey           | twitter      | https://x.com/pjoey |
| Dan Larimer         | linkedin     | https://linkedin... |
+---------------------+--------------+---------------------+

License

This project is licensed under the MIT License - see the file for details.