Crunchbase MCP Server

Crunchbase MCP Server

A Model Context Protocol (MCP) server that provides access to Crunchbase data for AI assistants. This server allows AI assistants to search for companies, get company details, funding information, acquisitions, investor/investment data, and people data from Crunchbase.

Features

• Search for companies based on various criteria
• Get detailed information about specific companies (by name, UUID, or permalink)
• Retrieve funding rounds for companies
• Get acquisition data
• Search for people associated with companies
• Get a person's full profile, including job and education history
• Get an investor's profile and investment portfolio ("what has investor Y backed")
• Search individual investment records ("who invested in X")

Prerequisites

• Node.js (v16 or higher)
• A Crunchbase API key

Installation

1. Clone the repository:

git clone https://github.com/Cyreslab-AI/crunchbase-mcp-server.git
cd crunchbase-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

The server requires a Crunchbase API key to function. You can obtain an API key by signing up for the Crunchbase API.

Setting up the API Key

Set the API key as an environment variable:

export CRUNCHBASE_API_KEY=your_api_key_here

MCP Configuration

You can use the included setup script to automatically configure the MCP server:

# Build the project first
npm run build

# Run the setup script
npm run setup

The setup script will:

1. Ask for your Crunchbase API key
2. Find your MCP settings file (or create a new one)
3. Add the Crunchbase MCP server to your settings

Alternatively, you can manually add it to your MCP configuration file:

{
  "mcpServers": {
    "crunchbase": {
      "command": "node",
      "args": ["/path/to/crunchbase-mcp-server/build/index.js"],
      "env": {
        "CRUNCHBASE_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Usage

Running the Server

Start the server:

npm start

For development with automatic reloading:

npm run dev

Available Tools

The server exposes the following tools:

1. search_companies - Search for companies based on various criteria

   • Parameters:
     • query (optional): Search query (e.g., company name, description)
     • location (optional): Filter by location (e.g., "San Francisco", "New York")
     • category (optional): Filter by category (e.g., "Artificial Intelligence", "Fintech")
     • founded_after (optional): Filter by founding date (YYYY-MM-DD)
     • founded_before (optional): Filter by founding date (YYYY-MM-DD)
     • status (optional): Filter by company status (e.g., "active", "closed")
     • limit (optional): Maximum number of results to return (default: 10)

2. get_company_details - Get detailed information about a specific company

   • Parameters (provide at least one; uuid/permalink take priority over name_or_id):
     • name_or_id (optional): Company name to search for. This resolves ambiguously - it's a name search that takes the first result, which can pick the wrong company for common names (e.g. "Meta"). Prefer uuid or permalink when you know them.
     • uuid (optional): Exact Crunchbase UUID of the company.
     • permalink (optional): Exact Crunchbase permalink of the company (e.g. "openai").

3. get_funding_rounds - Get funding rounds for a specific company

   • Parameters (provide at least one identifier):
     • company_name_or_id (optional): Company name to search for (ambiguous, see above).
     • uuid / permalink (optional): Exact identifiers for the company. Preferred - also skips an extra lookup call.
     • limit (optional): Maximum number of results to return (default: 10)

4. get_acquisitions - Get acquisitions made by or of a specific company (or recent acquisitions generally, if no company is given)

   • Parameters:
     • company_name_or_id (optional): Company name to search for (ambiguous, see above).
     • uuid / permalink (optional): Exact identifiers for the company. Preferred.
     • limit (optional): Maximum number of results to return (default: 10)

5. search_people - Search for people based on various criteria

   • Parameters:
     • query (optional): Search query (e.g., person name)
     • company (optional): Filter by company name
     • title (optional): Filter by job title
     • limit (optional): Maximum number of results to return (default: 10)

6. get_person_details - Get a person's full profile: bio fields (description, born_on, aliases, etc.) plus their job history (past and current roles) and education. Complements search_people, which only returns a person's current featured role.

   • Parameters (provide at least one identifier):
     • name (optional): Person name to search for (ambiguous - first result wins).
     • uuid / permalink (optional): Exact identifiers for the person. Preferred.

7. get_investor_details - Get an investor's profile (an organization such as a VC firm or corporate investor) plus the investments it has participated in - answers "what has investor Y backed".

   • Parameters (provide at least one identifier):
     • name (optional): Investor name to search for (ambiguous - first result wins).
     • uuid / permalink (optional): Exact identifiers for the investor organization. Preferred (e.g. permalink "sequoia-capital").
     • limit (optional): Maximum number of portfolio investments to return (default: 10)

8. search_investments - Search individual investment records (one investor participating in one funding round). Filter by organization to answer "who invested in X", or by investor to answer "what has investor Y backed".

   • Parameters:
     • organization_uuid / organization_permalink (optional): The company that received the investment.
     • investor_uuid / investor_permalink (optional): The investor that made the investment.
     • funding_round_uuid (optional): A specific funding round to list investments for.
     • limit (optional): Maximum number of results to return (default: 10)
     • after_id (optional): Pagination cursor - pass the uuid of the last result from a previous call to get the next page.

Available Resources

The server also exposes the following resources:

1. Trending Companies - List of trending companies on Crunchbase

   • URI: crunchbase://trending/companies

2. Company Details - Detailed information about a specific company (resolved by name search)

   • URI Template: crunchbase://companies/{name}

3. Company Funding Rounds - Funding rounds for a specific company

   • URI Template: crunchbase://companies/{name}/funding

4. Company Acquisitions - Acquisitions made by or of a specific company

   • URI Template: crunchbase://companies/{name}/acquisitions

5. Organization Details (by permalink) - Detailed information about a specific organization, looked up directly by its exact Crunchbase permalink (skips the ambiguous name-search-then-resolve step used by crunchbase://companies/{name}).

   • URI Template: crunchbase://organization/{permalink}
   • The {permalink} argument supports completion: an MCP client that calls completion/complete for this template gets live suggestions from Crunchbase's own /autocompletes endpoint (e.g. typing "open" can suggest "openai").

Example Queries

Here are some examples of how an AI assistant might use this MCP server:

1. Search for AI companies in San Francisco:

{
  "query": "AI",
  "location": "San Francisco",
  "limit": 5
}

2. Get details for a specific company:

{
  "name_or_id": "OpenAI"
}

3. Get funding rounds for a company:

{
  "company_name_or_id": "Anthropic"
}

4. Search for CEOs at tech companies:

{
  "title": "CEO",
  "limit": 10
}

5. Get an investor's profile and portfolio (get_investor_details):

{
  "permalink": "sequoia-capital",
  "limit": 10
}

6. Find who invested in a company (search_investments):

{
  "organization_permalink": "openai"
}

7. Get a person's full bio and job history (get_person_details):

{
  "permalink": "sam-altman"
}

License

MIT

Contact

For questions or support, please contact: [email protected]