crypto-funds-mcp

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.

!GitHub License !Python Version !Status

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

1. Clone the repository:

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

1. Install dependencies:

   uv sync

1. Create a .env file in the root directory and add your API key:

   CRYPTORANK_API_KEY=your_api_key_here

1. Install to Claude Desktop:

Install the server as a Claude Desktop application: ``bash 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 LICENSE file for details.