PrivCo MCP Package

This package provides MCP (Model Context Protocol) handlers for accessing PrivCo's data services.

Installation

You can install the package either globally or locally:

Global Installation (Recommended for CLI usage)

npm install -g privco-data-mcp

Local Installation (For project usage)

npm install privco-data-mcp

Configuration

Configure your MCP client to use the PrivCo MCP server:

{
  "mcpServers": {
    "Privco Data MCP": {
      "command": "privco-data-mcp",
      "args": [],
      "env": {
        "PRIVCO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with your actual PrivCo API key.

You can also override the API base URL by setting PRIVCO_API_BASE_URL (defaults to PrivCo's staging environment).

Available Handlers

The package includes the following data handlers:

Match

• Match companies and investors by name or website
• Optional city/state information inclusion

Profile

• Retrieve detailed profile information for companies, investors, and advisors
• Supports pagination

General Profile

• Retrieve lightweight/basic profile information for companies and investors
• Distinct from the full profile tool — returns a smaller payload
• Supports pagination

Finance

• Access company financial data (companies only)
• Supports both revenue-only and comprehensive financial metrics
• Filter by fiscal year, financial category (title), and data type (type)

People

• Information about company executives and board members
• Supports companies, investors, and advisors

People Search

• Advanced people search with 20+ filter types
• Support for text, location, range, industry, and classification filters
• Raw filter support: use rawKeywords and rawIndustries to pass string values directly
• Customizable pagination and sorting

Company Search

• Advanced company search with 15+ filter types
• Filter by name, location, revenue, employees, funding, growth rates, and more
• Raw filter support: use rawKeywords and rawIndustries to pass string values directly
• Customizable pagination and sorting

Industry Keyword

• Search for industry keywords with autocomplete
• Returns keyword IDs for use in company_search and people_search filters
• Alternatively, use raw keyword strings via rawKeywords parameter

Industry PICS

• Get all industry PICS (Product/Industry Classification System)
• Limited list - call once and store in context
• Returns industry IDs for use in search filters
• Alternatively, use raw industry names via rawIndustries parameter

Company Contact

• Retrieve detailed company contact information
• Includes personal details, job titles, and contact methods
• Requires contact hash from people_search results

Investor Contact

• Retrieve detailed investor contact information
• Includes personal details, job titles, and contact methods
• Requires contact hash from people_search results

Identification

• Company verification and identification
• Includes business details, social media, and alternate names
• Advanced search capabilities

M&A Deals

• Mergers and acquisitions activity for companies and investors
• Supports Target, Buyer, and Seller roles
• Requires profileType (company/investor) and profileId

VC Deals

• Venture capital investments for companies and investors
• Supports Target and Investor roles
• Requires profileType (company/investor) and profileId

Funding Round Search

• Advanced search across VC and PE funding rounds
• Filter by funding type (equity seed/A–H, debt, grant), USD amount, industry, location, investor type, and industry keyword
• Customizable pagination and sorting

M&A Deal Search

• Advanced search across M&A deals
• Filter by deal date, deal value, buyer/seller/target industries, PE/VC-backed flags, buyer type, and target location
• Customizable pagination and sorting

API Reference

Match Parameters

• name: Company or investor name to match
• website: Website domain to match
• includeCityState: Include city and state information in results

Profile Parameters

• profileType: Type of profile (company/investor/advisor)
• profileId: Unique identifier of the profile
• page: Page number for paginated results

General Profile Parameters

• profileType: Type of profile (company/investor/advisor)
• profileId: Unique identifier of the profile
• page: Page number for paginated results

Finance Parameters

• profileId: Company identifier [Required]
• year: Fiscal year (optional)
• title: Financial data category, e.g. Revenues (optional)
• type: Type of financial data, e.g. CURR for current period (optional)

Revenue Financials Parameters

• profileId: Company identifier [Required]
• year: Fiscal year (optional)
• type: Type of financial data (optional)

People Parameters

• profileType: Entity type
• profileId: Entity identifier
• page: Page number

People Search Parameters

• filters: Advanced search filters including:
  • Text filters: queryFirstName, queryLastName, queryJobTitles, queryAssociated
  • Location: city, state, region with optional radius
  • Range filters: revenue, employee, funding, latestEbitda, latestValuation
  • Year filters: yearLastSeen, yearFounded, latestFundingYear
  • Industry filters: keyword (with selection IDs or rawKeywords strings), industry (with selection IDs or rawIndustries strings)
  • Growth filters: revenue/employee growth over 1 or 3 years
  • Classification: seniorityLevels, departments, inclusionExclusion, privateCompanyOnly, investorOnly
• page: Page number for paginated results
• sorting: Sort by field and order (asc/desc)

Company Search Parameters

• filters: Advanced search filters including:
  • query: Free text search for company name
  • Location: city, state, region with optional radius
  • Range filters: revenue, employee, funding, latestEbitda, latestValuation
  • Year filters: yearFounded, latestFundingYear
  • Industry filters: keyword (with selection IDs or rawKeywords strings), industry (with selection IDs or rawIndustries strings)
  • Growth filters: revenue/employee growth over 1 or 3 years
  • Classification: inclusionExclusion, classification.privateOnly
• page: Page number for pagination
• sorting: Sort by field and order (asc/desc)

Industry Keyword Parameters

• query: Search term prefix for autocomplete (optional - returns all if omitted)

Industry PICS Parameters

• query: Search term prefix for autocomplete (optional - returns all if omitted)

Contact Parameters

• hash: Unique hash identifier from people_search results

Identification Parameters

• name: Primary company name
• Multiple optional parameters for detailed company information
• Social media and alternate name fields

M&A Deals Parameters

• profileType: Entity type (company/investor) [Required]
• profileId: Entity identifier [Required]
• page: Page number

VC Deals Parameters

• profileType: Entity type (company/investor) [Required]
• profileId: Entity identifier [Required]
• page: Page number

Funding Round Search Parameters

• filters: Advanced search filters including:
  • fundingTypes: Funding round type tokens (e.g. equity_funding_seed_angel, equity_funding_A–H, debt funding_financing, grant or non-equityfunding)
  • timestamp: Unix-millisecond timestamp range for the funding round
  • totalInUsd: Funding total range in USD
  • industry: Industry classification filter for funded companies (selection IDs or rawIndustries strings)
  • location: city, state, region with optional radius
  • investorTypes: Investor type names (e.g. Venture Capital, Accelerator, Angel)
  • keyword: Industry keyword filter (selection IDs or rawKeywords strings; condition required when used)
• page: Page number for pagination
• sorting: Sort by companyName, timestamp, totalInUsd, or fundingType, order asc/desc

M&A Deal Search Parameters

• filters: Advanced search filters including:
  • query: Free-text search across buyer, seller, and target names
  • timestamp: Unix-millisecond timestamp range for the deal date
  • totalInUsd: Deal total value range in USD
  • buyersIndustries, sellersIndustries, targetsIndustries: Industry filters for each role
  • targetsIndustryKeywords: Industry keyword filter for deal targets
  • isPeDeal: Boolean filter for PE deals
  • inclusionExclusion: targetsIsPeBacked / targetsIsVcBacked (include/exclude)
  • buyersAllOfType: Require all buyers to share a single type (Financial, Private, Public) — ignored when isPeDeal is set
  • location: Location filter matched against target company location
• page: Page number for pagination
• sorting: Sort by timestamp, order asc/desc

Error Handling

The package includes built-in error handling for:

• Invalid API keys
• Rate limiting
• Network errors
• Invalid parameters

Support

For support or questions, please contact:

• Email: [email protected]
• Documentation: https://docs.privco.com