Crypto Funds MCP

1# Crypto Funds MCP
2 
3An MCP server that provides AI agents with structured, real-time data on cryptocurrency investment funds, enabling deeper due diligence and portfolio intelligence.
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/crypto-funds-mcp) 
6![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Tools for Data Access**:
12  - `get_all_funds()`: Retrieve a complete list of all investors and funds.
13  - `search_funds(tier, type, sortBy, sortDirection, limit, skip)`: Search and filter funds with sorting and pagination.
14  - `get_fund_basic(fund_id)`: Get basic metrics for a specific fund (e.g., tier, portfolio size, ROI).
15  - `get_fund_full(fund_id)`: Fetch comprehensive metrics, including investment focus, recent rounds, and stages.
16  - `get_fund_team(fund_id)`: Retrieve detailed team information with roles and social links.
17 
18- **Formatted Outputs**: All responses are returned as ASCII tables for easy readability in MCP clients.
19- **Asynchronous API Calls**: Uses `httpx` for efficient, async HTTP requests.
20- **Environment Configuration**: API key management via `.env` file with `dotenv`.
21- **Error Handling**: Graceful handling of API errors and missing data.
22 
23## Installation
24 
25### Prerequisites
26 
27- Python 3.10+
28- **uv**: Package and virtual environment manager for Python (recommended for dependency management).
29- A Cryptorank API key (sign up at [Cryptorank](https://cryptorank.io/api))
30 
31### Steps
32 
331. Clone the repository:
34   ```bash
35   git clone https://github.com/kukapay/crypto-funds-mcp.git
36   cd crypto-funds-mcp
37   ```
38 
392. Install dependencies:
40   ```bash
41   uv sync
42   ```
43 
443. Create a `.env` file in the root directory and add your API key:
45   ```
46   CRYPTORANK_API_KEY=your_api_key_here
47   ```
48 
494. Install to Claude Desktop:
50 
51   Install the server as a Claude Desktop application:
52   ```bash
53   uv run mcp install main.py --name "Crypto Funds"
54   ```
55 
56   Configuration file as a reference:
57 
58   ```json
59   {
60      "mcpServers": {
61          "Crypto Funds": {
62              "command": "uv",
63              "args": [ "--directory", "/path/to/crypto-funds-mcp", "run", "main.py" ],
64              "env": { "CRYPTORANK_API_KEY": "cryptorank_api_key"}
65          }
66      }
67   }
68   ```
69   Replace `/path/to/crypto-funds-mcp` with your actual installation path, and replace `cryptorank_api_key` with your API key from Cryptorank.
70 
71## Usage
72 
73### Tool Usage Examples
74 
75Below 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.
76 
77#### get_all_funds()
78 
79**Prompt:** 
80> Show me a complete list of all crypto investors and funds available.
81 
82**Tool Call:** 
83```
84get_all_funds()
85```
86 
87**Example Result:**
88```
89+------+--------------------------------+--------+-------------+
90|   ID | Name                           |   Tier | Type        |
91+======+================================+========+=============+
92|    1 | YZi Labs (Prev. Binance Labs)  |      1 | Venture     |
93|    2 | Andreessen Horowitz (a16z)     |      1 | Venture     |
94|    3 | Pantera Capital                |      1 | Venture     |
95|    4 | Coinbase Ventures              |      1 | Venture     |
96|    5 | Dragonfly Capital              |      1 | Venture     |
97+------+--------------------------------+--------+-------------+
98```
99 
100#### search_funds(tier, type, sortBy, sortDirection, limit, skip)
101 
102**Prompt:** 
103> Search for Tier 1 Venture funds, sorted by retail ROI in descending order, and show the top 100 results.
104 
105**Tool Call:** 
106```
107search_funds(tier=[1], type=["Venture"], sortBy="retailRoi", sortDirection="DESC", limit=100, skip=0)
108```
109 
110**Example Result:**
111```
112+------+--------------------------------+--------------------------------+--------+-------------+----------------+--------------------+-------------+--------------+-------------+--------------------+
113|   ID | Key                            | Name                           |   Tier | Type        | Jurisdiction       | Portfolio   | Funding Rounds | Retail ROI  | Lead Investments   |
114+======+================================+================================+========+=============+====================+=============+================+=============+====================+
115|    1 | binance-labs                   | YZi Labs (Prev. Binance Labs)  |      1 | Venture     | Cayman Islands     | 200+        | 150+           | 500x        | 50+                |
116|    2 | andreessen-horowitz            | Andreessen Horowitz (a16z)     |      1 | Venture     | United States      | 150+        | 120+           | 450x        | 40+                |
117|    3 | pantera-capital                | Pantera Capital                |      1 | Venture     | United States      | 100+        | 90+            | 400x        | 30+                |
118+------+--------------------------------+--------------------------------+--------+-------------+----------------+--------------------+-------------+--------------+-------------+--------------------+
119```
120 
121#### get_fund_basic(fund_id)
122 
123**Natural Language Prompt:** 
124> Give me the basic metrics for the fund with ID 1, like its tier, portfolio, and ROI.
125 
126**Tool Call:** 
127```
128get_fund_basic(1)
129```
130 
131**Example Result:**
132```
133Fund Metrics:
134+--------------------+-------------------------+
135| Field              | Value                   |
136+====================+=========================+
137| ID                 | 1                       |
138| Key                | binance-labs            |
139| Name               | YZi Labs (Prev. Binance Labs) |
140| Tier               | 1                       |
141| Type               | Venture                 |
142| Jurisdiction       | Cayman Islands          |
143| Portfolio          | 200+                    |
144| Funding Rounds     | 150+                    |
145| Retail ROI         | 500x                    |
146| Lead Investments   | 50+                     |
147+--------------------+-------------------------+
148 
149Focus Areas:
150+------+---------------+-----------+
151|   ID | Name          | Percent   |
152+======+===============+===========+
153|   10 | DeFi          | 40%       |
154|   20 | Web3          | 30%       |
155|   30 | AI            | 20%       |
156+------+---------------+-----------+
157 
158Top Investments (Last 12 Months):
159+------+----------+----------------------+---------+
160|   ID | Symbol   | Name                 | Logo    |
161+======+==========+======================+=========+
162| 1001 | APT      | Aptos                | url...  |
163| 1002 | SUI      | Sui                  | url...  |
164+------+----------+----------------------+---------+
165```
166 
167#### get_fund_full(fund_id)
168 
169**Prompt:** 
170> Provide comprehensive data and investment details for the fund with ID 2.
171 
172**Tool Call:** 
173```
174get_fund_full(2)
175```
176 
177**Example Result:**
178```
179Comprehensive Fund Data:
180+--------------------+---------------------------------+
181| Field              | Value                           |
182+====================+=================================+
183| ID                 | 2                               |
184| Key                | andreessen-horowitz             |
185| Name               | Andreessen Horowitz (a16z)      |
186| Tier               | 1                               |
187| Type               | Venture                         |
188| Jurisdiction       | United States                   |
189| Description        | Leading VC in crypto and tech   |
190| Portfolio          | 150+                            |
191| Funding Rounds     | 120+                            |
192| Retail ROI         | 450x                            |
193| Lead Investments   | 40+                             |
194+--------------------+---------------------------------+
195 
196Links:
197+-----------+---------------------+
198| Type      | Value               |
199+===========+=====================+
200| website   | https://a16z.com    |
201| twitter   | https://x.com/a16z  |
202+-----------+---------------------+
203 
204Focus Areas:
205+------+---------------+-----------+
206|   ID | Name          | Percent   |
207+======+===============+===========+
208|   10 | Blockchain    | 50%       |
209|   20 | Gaming        | 25%       |
210|   30 | Infrastructure| 25%       |
211+------+---------------+-----------+
212 
213Top Investments (Recent):
214+------+----------+----------------------+---------+
215|   ID | Symbol   | Name                 | Logo    |
216+======+==========+======================+=========+
217| 2001 | FLOW     | Flow                 | url...  |
218| 2002 | AXS      | Axie Infinity        | url...  |
219+------+----------+----------------------+---------+
220 
221Funding Locations:
222+---------+---------+
223| Code    | Count   |
224+=========+=========+
225| US      | 80      |
226| SG      | 20      |
227+---------+---------+
228 
229Recent Funding Rounds:
230+------+---------------+---------+---------+------------+
231|   ID | Name          | Logo    | Raise   |     Date   |
232+======+===============+=========+=========+============+
233| 3001 | Project A     | url...  | $10M    | 2024-05-01 |
234| 3002 | Project B     | url...  | $15M    | 2024-03-15 |
235+------+---------------+---------+---------+------------+
236 
237Average Rounds Raise:
238+----------------+--------------+-----------+
239| Raise From     | Raise To     | Percent   |
240+================+==============+===========+
241| $1M            | $5M          | 40%       |
242| $5M            | $20M         | 60%       |
243+----------------+--------------+-----------+
244 
245Investment Stages:
246+---------------+-----------+
247| Type          | Percent   |
248+===============+===========+
249| Seed          | 50%       |
250| Series A      | 30%       |
251| Series B      | 20%       |
252+---------------+-----------+
253```
254 
255#### get_fund_team(fund_id)
256 
257**Prompt:** 
258> Who is on the team for the fund with ID 3? Include their roles and social links.
259 
260**Tool Call:** 
261```
262get_fund_team(3)
263```
264 
265**Example Result:**
266```
267Fund Team Details:
268+------+--------------------+---------------------+------------+
269|   ID | Name               | Jobs                |   Priority |
270+======+====================+=====================+============+
271|   11 | Paul Joey          | CEO, Founder        |          1 |
272|   12 | Dan Larimer        | Managing Partner    |          2 |
273|   13 | Jill Valentine     | Investment Director |          3 |
274+------+--------------------+---------------------+------------+
275 
276Team Social Links:
277+---------------------+--------------+---------------------+
278| Member Name         | Link Type    | Link Value          |
279+=====================+==============+=====================+
280| Paul Joey           | linkedin     | https://linkedin... |
281| Paul Joey           | twitter      | https://x.com/pjoey |
282| Dan Larimer         | linkedin     | https://linkedin... |
283+---------------------+--------------+---------------------+
284```
285 
286## License
287 
288This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
289