Crunchbase MCP Server

Instructions

Implementation Reference

• src/index.ts:352-369 (handler)

  MCP tool handler implementation for 'get_funding_rounds'. Validates input arguments, constructs GetFundingRoundsInput parameters, calls CrunchbaseAPI.getFundingRounds, and returns the result as JSON text content.

  case 'get_funding_rounds': {
    if (!args || typeof args !== 'object' || !('company_name_or_id' in args) || typeof args.company_name_or_id !== 'string') {
      throw new McpError(ErrorCode.InvalidParams, 'Missing or invalid company_name_or_id parameter');
    }
    const params: GetFundingRoundsInput = {
      company_name_or_id: args.company_name_or_id,
      limit: typeof args.limit === 'number' ? args.limit : undefined
    };
    const fundingRounds = await this.crunchbaseApi.getFundingRounds(params);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(fundingRounds, null, 2),
        },
      ],
    };
  }

• src/index.ts:243-260 (registration)

  Tool registration in the ListToolsRequestSchema handler, defining the name, description, and inputSchema for 'get_funding_rounds'.

  {
    name: 'get_funding_rounds',
    description: 'Get funding rounds for a specific company',
    inputSchema: {
      type: 'object',
      properties: {
        company_name_or_id: {
          type: 'string',
          description: 'Company name or UUID',
        },
        limit: {
          type: 'number',
          description: 'Maximum number of results to return (default: 10)',
        },
      },
      required: ['company_name_or_id'],
    },
  },

• src/crunchbase-api.ts:105-123 (helper)

  Core helper function in CrunchbaseAPI class that implements the API call to retrieve funding rounds: first resolves company UUID, then queries Crunchbase API endpoint for funding_rounds.

  async getFundingRounds(params: GetFundingRoundsInput): Promise<FundingRound[]> {
    try {
      // First, get the company UUID
      const company = await this.getCompanyDetails({ name_or_id: params.company_name_or_id });
  
      // Then, get the funding rounds
      const response = await this.client.get<CrunchbaseApiResponse<FundingRound[]>>(`/entities/organizations/${company.uuid}/funding_rounds`, {
        params: {
          limit: params.limit || 10,
          order: 'announced_on DESC'
        }
      });
  
      return response.data.data;
    } catch (error) {
      console.error('Error getting funding rounds:', error);
      throw this.handleError(error);
    }
  }

• src/types.ts:129-132 (schema)

  TypeScript interface defining the input shape for getFundingRoundsInput used by the tool handler and API helper.

  export interface GetFundingRoundsInput {
    company_name_or_id: string;
    limit?: number;
  }