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:
-
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:
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:
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:
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:
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 LICENSE file for details.