# Companyenrich — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/companyenrich

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_companyenrich?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/companyenrich/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/companyenrich/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/companyenrich/skill.md
Postman collection (v2.1): https://mcp.ai/companyenrich/postman.json

## Tools
- companyenrich_autocomplete_companies(query: string) — 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
- companyenrich_autocomplete_keywords(query: string) — 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 
- companyenrich_autocomplete_positions(query: string) — 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 
- companyenrich_autocomplete_technologies(query: string) — 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
- companyenrich_count_companies(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) — 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
- companyenrich_count_similar_companies(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) — 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
- companyenrich_create_people_search_export_job(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) — 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
- companyenrich_create_search_export_job(count: integer, search?: object, similar?: object, webhook_url?: string) — 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
- companyenrich_enrich_by_domain(domain: string, expand?: string[]) — 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
- companyenrich_enrich_by_properties(name?: string, expand?: string[], linkedin_id?: string, twitter_url?: string, facebook_url?: string, linkedin_url?: string, you_tube_url?: string, instagram_url?: string) — 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
- companyenrich_enrich_companies(expand?: string[], domains: string[]) — 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:
- companyenrich_find_similar_companies(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) — 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
- companyenrich_get_bulk_enrichment_job_status(job_id: string) — 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
- companyenrich_get_company_workforce(id?: string, domain?: string) — 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
- companyenrich_get_country_by_code(country_code: string) — 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. 
- 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
- companyenrich_get_job_details(job_id: string) — 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.
- companyenrich_get_people_search_export_job_status(job_id: string) — 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
- 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.
- companyenrich_get_search_export_job_status(jobId: string) — 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
- companyenrich_list_all_jobs(page?: integer, type?: string, status?: string, pageSize?: integer) — 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
- companyenrich_list_bulk_enrichment_jobs(page?: integer, status?: string, pageSize?: integer) — 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
- 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
- companyenrich_list_people_search_export_jobs(page?: integer, status?: string, page_size?: integer) — 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 
- companyenrich_list_search_export_jobs(page?: integer, status?: string, pageSize?: integer) — 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 
- companyenrich_lookup_person(email: string) — 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
- companyenrich_scroll_people_search(query?: string, cursor?: string, domains?: string[], countries?: string[], page_size?: integer, seniority?: string[], department?: string[], position_query?: string[]) — 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
- companyenrich_search_cities(page?: integer, query?: string, country_codes?: string[]) — 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.
- companyenrich_search_companies(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) — 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
- companyenrich_search_countries(page?: integer, query?: string) — 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
- companyenrich_search_people(page: integer, query?: string, domains?: string[], pageSize: integer, countries?: string[], seniority?: string[], department?: string[], positionQuery?: string[]) — 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
- companyenrich_search_states(page?: integer, query?: string, country_codes?: string[]) — 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.

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

## Links
Docs: https://mcp.ai/docs/mcps/companyenrich
Website: https://mcp.ai/mcps/companyenrich