# Companyenrich — how to use (mcp.ai)

Connect your Companyenrich account and use 32 tools for developer tools straight from your AI agent. Connect with your own API key. CompanyEnrich provides instant company data enrichment, search, and similar company discovery through API endpoints.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_companyenrich?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `companyenrich_autocomplete_companies`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/companyenrich`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/companyenrich/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/companyenrich/autocomplete/companies` — Returns a list of companies matching the given partial domain name. This is useful for autocompleting domain names in your application. Up to 10 companies are returned per request. Cost: FREE - No cre
  - body: { query: string }
- `POST https://api.mcp.ai/api/companyenrich/autocomplete/keywords` — Lookup keywords for use in company search filters. This endpoint returns a list of keywords that match the provided query string. Use this action to discover valid keyword values before using them in 
  - body: { query: string }
- `POST https://api.mcp.ai/api/companyenrich/autocomplete/positions` — Lookup positions/job titles for use in people search filters. This endpoint returns a list of job titles that match the provided query string. Use this action to discover valid position values before 
  - body: { query: string }
- `POST https://api.mcp.ai/api/companyenrich/autocomplete/technologies` — Lookup technologies for use in company search filters. This endpoint returns a list of technology names that match the provided query string. Use this action to discover valid technology values before
  - body: { query: string }
- `POST https://api.mcp.ai/api/companyenrich/count/companies` — Returns the total count of companies matching the given search criteria without retrieving the actual results. Use this action to check how many companies match your filters before performing a full s
  - body: { type?: string[], lists?: string[], query?: string, cities?: integer[], states?: integer[], exclude?: object, regions?: string[], require?: string[], revenue?: string[], category?: string[], keywords?: string[], countries?: string[], employees?: string[], naics_code?: integer[], founded_year?: object, funding_year?: object, technologies?: string[], funding_amount?: object, funding_rounds?: string[], semantic_query?: string, semantic_weight?: number, workforce_growth?: object, category_operator?: string, keywords_operator?: string, technologies_operator?: string }
- `POST https://api.mcp.ai/api/companyenrich/count/similar/companies` — Tool to count the total number of similar companies matching the given search criteria without retrieving the actual results. Use when you need to know how many similar companies exist before making a
  - body: { type?: string[], query?: string, cities?: integer[], states?: integer[], domains: string[], exclude?: object, regions?: string[], require?: string[], revenue?: string[], category?: string[], keywords?: string[], countries?: string[], employees?: string[], naicsCode?: integer[], foundedYear?: object, fundingYear?: object, technologies?: string[], fundingAmount?: object, fundingRounds?: string[], workforceGrowth?: object, categoryOperator?: string, keywordsOperator?: string, similarityWeight?: number, technologiesOperator?: string }
- `POST https://api.mcp.ai/api/companyenrich/create/people/search/export/job` — Creates an asynchronous search export job for up to 50,000 people. Use when you need to export large sets of people data that will be processed in the background. The job returns immediately with a jo
  - body: { count: integer, query?: string, domains?: string[], exclude?: object, countries?: string[], seniority?: string[], department?: string[], webhook_url?: string, company_filter?: object, position_query?: string[], at_current_company_after?: string, at_current_company_before?: string, at_current_position_after?: string, at_current_position_before?: string }
- `POST https://api.mcp.ai/api/companyenrich/create/search/export/job` — Creates an asynchronous search export job for company data. Supports both standard company search and similar-company search. Returns a job ID immediately while processing happens in the background. T
  - body: { count: integer, search?: object, similar?: object, webhook_url?: string }
- `POST https://api.mcp.ai/api/companyenrich/enrich/by/domain` — Enriches a company using its domain name as lookup parameter. This is the preferred way to enrich a company as domain lookups are fast and reliable. Each domain maps to a unique company. Cost: 1 credi
  - body: { domain: string, expand?: string[] }
- `POST https://api.mcp.ai/api/companyenrich/enrich/by/properties` — Enriches a company using its properties. You must provide at least one of the following properties: name, linkedinUrl, linkedinId, twitterUrl, facebookUrl, instagramUrl. Best match is used to determin
  - body: { name?: string, expand?: string[], linkedin_id?: string, twitter_url?: string, facebook_url?: string, linkedin_url?: string, you_tube_url?: string, instagram_url?: string }
- `POST https://api.mcp.ai/api/companyenrich/enrich/companies` — Enriches a list of companies using their domain names. Use when you need to enrich multiple companies in a single request. Up to 50 domains can be provided. Each domain maps to a unique company. Cost:
  - body: { expand?: string[], domains: string[] }
- `POST https://api.mcp.ai/api/companyenrich/find/similar/companies` — Tool to find similar companies to the given company by domain. Use when you need to find companies similar to a target company based on industry, size, or other characteristics. Returns up to 100 comp
  - body: { page?: integer, type?: string[], query?: string, cities?: integer[], expand?: string[], states?: integer[], domains: string[], regions?: string[], require?: string[], revenue?: string[], category?: string[], keywords?: string[], pageSize?: integer, countries?: string[], employees?: string[], naicsCode?: integer[], technologies?: string[], fundingRounds?: string[], categoryOperator?: string, keywordsOperator?: string, similarityWeight?: number, technologiesOperator?: string }
- `POST https://api.mcp.ai/api/companyenrich/get/bulk/enrichment/job/status` — Returns the current status of a bulk enrichment job. Once the job is completed, the response includes a results_url to download the enrichment results. Cost: FREE - No credits deducted. Use when you n
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/companyenrich/get/company/workforce` — Returns workforce insights for a single company. You must provide exactly one lookup parameter: id or domain. The response includes observed employee count, an employee range bucket, and headcounts gr
  - body: { id?: string, domain?: string }
- `POST https://api.mcp.ai/api/companyenrich/get/country/by/code` — Tool to search for a country by its ISO 3166-1 alpha-2 code. Returns country information including name, coordinates, and country code. Use when you need to retrieve details about a specific country. 
  - body: { country_code: string }
- `POST https://api.mcp.ai/api/companyenrich/get/current/user` — Returns information about the authenticated user, including their API key, credit balance, and account capabilities. This endpoint requires authentication via an API key in the Authorization header. C
- `POST https://api.mcp.ai/api/companyenrich/get/job/details` — Returns details for a specific job by ID. Use when you need to check the status, progress, or result of an async enrichment job. Cost: FREE - No credits deducted.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/companyenrich/get/people/search/export/job/status` — Returns the current status of a person search export job. Once completed, includes the results_url to download the export results. Use when: - Checking if an async person search export job has complet
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/companyenrich/get/regions` — Tool to get all available regions. Returns a list of all geographic regions supported by the API. Use when you need to retrieve region information for filtering or validation purposes.
- `POST https://api.mcp.ai/api/companyenrich/get/search/export/job/status` — Returns the current status of a search export job. Once the job is completed, the response will include a results_url that can be used to download the exported company data. This action is free - no c
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/companyenrich/list/all/jobs` — Returns a paginated list of all jobs (bulk enrichment, etc.) for the authenticated user. Supports optional filtering by job status and type. Cost: FREE - No credits deducted. Use this action to: - Vie
  - body: { page?: integer, type?: string, status?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/companyenrich/list/bulk/enrichment/jobs` — Returns a paginated list of all bulk enrichment jobs for the authenticated user. Supports optional filtering by job status. This action is free - no credits are deducted. Use this action to: - View al
  - body: { page?: integer, status?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/companyenrich/list/industries` — Obtain a list of all company industries. Returns all industry names along with their associated NAICS code prefixes. Use when you need to retrieve the complete list of industries for filtering or cate
- `POST https://api.mcp.ai/api/companyenrich/list/people/search/export/jobs` — Returns a paginated list of all person search export jobs for the authenticated user. Supports optional filtering by job status. Use this to check the status of previously submitted export jobs, view 
  - body: { page?: integer, status?: string, page_size?: integer }
- `POST https://api.mcp.ai/api/companyenrich/list/search/export/jobs` — Returns a paginated list of all search export jobs for the authenticated user. Supports optional filtering by job status. This action is free - no credits are deducted. Use this action to: - View all 
  - body: { page?: integer, status?: string, pageSize?: integer }
- `POST https://api.mcp.ai/api/companyenrich/lookup/person` — Look up a person by email address. We resolve the company from the email domain first, then match the person by email local-part patterns. Returns the best deterministic match when found. Costs 5 cred
  - body: { email: string }
- `POST https://api.mcp.ai/api/companyenrich/scroll/people/search` — Searches people based on given criteria using cursor-based pagination. Use when you need to find people at specific companies or with particular roles. You can request the next page of results by usin
  - body: { query?: string, cursor?: string, domains?: string[], countries?: string[], page_size?: integer, seniority?: string[], department?: string[], position_query?: string[] }
- `POST https://api.mcp.ai/api/companyenrich/search/cities` — Search for cities by name or country codes. Returns up to 100 cities per page. Use when you need to find cities matching a query string, optionally filtered by country codes.
  - body: { page?: integer, query?: string, country_codes?: string[] }
- `POST https://api.mcp.ai/api/companyenrich/search/companies` — Searches companies based on given criteria. You can search by name, domain, industry, employees, revenue, founded year, and more. Up to 10,000 results can be returned from this endpoint (page * pageSi
  - body: { page?: integer, type?: string[], lists?: string[], query?: string, cities?: integer[], states?: integer[], exclude?: object, regions?: string[], require?: string[], revenue?: string[], category?: string[], keywords?: string[], countries?: string[], employees?: string[], page_size?: integer, naics_code?: integer[], founded_year?: object, funding_year?: object, technologies?: string[], funding_amount?: object, funding_rounds?: string[], semantic_query?: string, semantic_weight?: number, workforce_growth?: object, category_operator?: string, keywords_operator?: string, technologies_operator?: string }
- `POST https://api.mcp.ai/api/companyenrich/search/countries` — Tool to search countries by name. Returns up to 100 countries per page. Use when you need to find country information including codes, names, and coordinates. Supports pagination and filtering by name
  - body: { page?: integer, query?: string }
- `POST https://api.mcp.ai/api/companyenrich/search/people` — Searches people based on given criteria using page-based pagination. Up to 10,000 results can be returned from this endpoint (page * pageSize cannot exceed 10,000). For more results, use the scroll en
  - body: { page: integer, query?: string, domains?: string[], pageSize: integer, countries?: string[], seniority?: string[], department?: string[], positionQuery?: string[] }
- `POST https://api.mcp.ai/api/companyenrich/search/states` — Tool to search states by name or country codes. Returns up to 100 states per page. Use when you need to find states within a country or search states by name.
  - body: { page?: integer, query?: string, country_codes?: string[] }

## Example prompts
- "What can I do in Companyenrich?"
- "Show me a summary of my Companyenrich account"

## More
- Page: https://mcp.ai/companyenrich
- Agent spec (llms.txt): https://mcp.ai/companyenrich/llms.txt
- Postman collection: https://mcp.ai/companyenrich/postman.json