Connect AI agents to the CompanyEnrich MCP server

Vendor MCP

The CompanyEnrich MCP connector routes your AI agent's tool calls to CompanyEnrich's own MCP server through Scalekit. Each user signs in to CompanyEnrich once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 11 tools.

Tools: 11
What they doRead · write · destructive: 8 · 3 · 08 read3 write0 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the CompanyEnrich MCP connection
In AgentKit > Connections, create a CompanyEnrich MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for CompanyEnrich MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'companyenrichmcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize CompanyEnrich MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'companyenrichmcp_get_current_user',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "companyenrichmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize CompanyEnrich MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="companyenrichmcp_get_current_user",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

companyenrichmcp_find_similar_companiesFinds companies similar to one or more seed domains, with optional filters.Read-only
Find Similar Companies
Finds companies similar to one or more seed domains, with optional filters. Costs 5 credits per company returned, with a 5-credit minimum.
Inputs
domainsarrayrequired
Company domain names to find similar companies for. Up to 10 domains.
categoriesarray
Company categories to filter by.
categoryOperatorstring
Operator for category filters. Defaults to And in the API.one of AndOr
citiesarray
City IDs to filter by.
countriesarray
2-letter country codes to filter by.
countrystring
Deprecated single-country alias. Prefer countries.
employeesarray
Employee count ranges.
excludeobject
Exclude companies matching any of these filters.
foundedYearobject
Founded year range.
fundingAmountobject
Funding amount range.
fundingRoundsarray
Funding rounds to filter by.
fundingYearobject
Funding year range.
includeWorkforceboolean
When true, requests expanded workforce insights. Costs 5 additional credits per company.default false
keywordsarray
Keywords to filter by.
keywordsOperatorstring
Operator for keyword filters. Defaults to And in the API.one of AndOr
minScorenumber
Minimum similarity score required for returned companies.
naicsCodearray
NAICS codes to filter by.
pageinteger
Page number, 1-indexed.default 1
pageSizeinteger
Number of results per page, from 1 to 100.default 20
querystring
Search query applied to company name and domain.
regionsarray
Region IDs to filter by.
requirearray
Company features that must exist.
revenuearray
Revenue ranges in USD.
similarityWeightnumber
Similarity weight from -1 to 1. Higher favors similarity, lower favors established companies.
statesarray
State IDs to filter by.
technologiesarray
Technologies to filter by.
technologiesOperatorstring
Operator for technology filters. Defaults to And in the API.one of AndOr
typearray
Company types to filter by.
workforceGrowthobject
Filter by workforce growth percentage.
workforceSizearray
Filter by absolute workforce headcount.
companyenrichmcp_get_company_by_idRetrieves a company by CompanyEnrich company ID.Read-only
Get Company By ID
Retrieves a company by CompanyEnrich company ID. Costs 1 credit per call, plus 5 additional credits when includeWorkforce is true.
Inputs
idstringrequired
CompanyEnrich company ID.
includeWorkforceboolean
When true, requests expanded workforce insights. Costs 5 additional credits per company.default false
companyenrichmcp_get_company_workforceReturns workforce insights for a single company by CompanyEnrich company ID or domain.Read-only
Get Company Workforce Insights
Returns workforce insights for a single company by CompanyEnrich company ID or domain. Costs 5 credits per successful call.
Inputs
domainstring
Company domain. Provide either id or domain.
idstring
CompanyEnrich company ID. Provide either id or domain.
companyenrichmcp_get_current_userReturns authenticated user credit balance and account capabilities.Read-only
Get Current User
Returns authenticated user credit balance and account capabilities. Free; no credits deducted.
Inputs
This tool takes no inputs.
companyenrichmcp_get_person_by_idRetrieves a person by CompanyEnrich person ID.Read-only
Get Person By ID
Retrieves a person by CompanyEnrich person ID. Costs 2 credits per call.
Inputs
idstringrequired
CompanyEnrich person ID.
companyenrichmcp_lookup_person_by_emailLooks up a person by email address.Read-only
Lookup Person By Email
Looks up a person by email address. The API resolves the company from the email domain and matches the local part. Costs 5 credits per successful call.
Inputs
emailstringrequired
The email address of the person to look up.
companyenrichmcp_search_companiesSearches companies with page-based pagination.Read-only
Search Companies
Searches companies with page-based pagination. semanticQuery is optional; use it for natural-language profile search, and use query for name/domain focused searches. Costs 1 credit per company returned, with a 1-credit minimum.
Inputs
categoriesarray
Company categories to filter by.
categoryOperatorstring
Operator for category filters. Defaults to And in the API.one of AndOr
citiesarray
City IDs to filter by.
countriesarray
2-letter country codes to filter by.
countrystring
Deprecated single-country alias. Prefer countries.
employeesarray
Employee count ranges.
excludeobject
Exclude companies matching any of these filters.
foundedYearobject
Founded year range.
fundingAmountobject
Funding amount range.
fundingRoundsarray
Funding rounds to filter by.
fundingYearobject
Funding year range.
includeWorkforceboolean
When true, requests expanded workforce insights. Costs 5 additional credits per company.default false
keywordsarray
Keywords to filter by.
keywordsOperatorstring
Operator for keyword filters. Defaults to And in the API.one of AndOr
naicsCodearray
NAICS codes to filter by.
pageinteger
Page number, 1-indexed.default 1
pageSizeinteger
Number of results per page, from 1 to 100.default 20
querystring
Search query applied to company name and domain.
regionsarray
Region IDs to filter by.
requirearray
Company features that must exist.
revenuearray
Revenue ranges in USD.
semanticQuerystring
Natural-language query describing the kinds of companies to find.
semanticWeightnumber
Semantic weight from 0 to 1. Defaults to 0.7 in the API.
statesarray
State IDs to filter by.
technologiesarray
Technologies to filter by.
technologiesOperatorstring
Operator for technology filters. Defaults to And in the API.one of AndOr
typearray
Company types to filter by.
workforceGrowthobject
Filter by workforce growth percentage.
workforceSizearray
Filter by absolute workforce headcount.
companyenrichmcp_search_peopleSearches people with page-based pagination.Read-only
Search People
Searches people with page-based pagination. positionQuery accepts either one string or an array of strings. Costs 2 credits per person returned, with a 2-credit minimum.
Inputs
atCurrentCompanyAfterstring
Only include people who joined their current company after this UTC datetime.
atCurrentCompanyBeforestring
Only include people who joined their current company before this UTC datetime.
atCurrentPositionAfterstring
Only include people who started their current position after this UTC datetime.
atCurrentPositionBeforestring
Only include people who started their current position before this UTC datetime.
companyFilterobject
Company filters to scope people results.
countriesarray
2-letter country codes to filter by.
departmentarray
Departments to filter by.
domainsarray
Company domains to filter by.
excludeobject
People exclusion filters.
pageinteger
Page number, 1-indexed.default 1
pageSizeinteger
Number of results per page, from 1 to 100.default 20
positionQuerystring
Current job title query or queries. A string is accepted for backward compatibility.
querystring
Name search query. This is not semantic search.
seniorityarray
Seniority levels to filter by.
companyenrichmcp_enrich_companyEnriches a company by domain.Write
Enrich Company Information
Enriches a company by domain. Costs 1 credit per call, plus 5 additional credits when includeWorkforce is true.
Inputs
domainstringrequired
The domain name of the company to enrich, for example example.com.
includeWorkforceboolean
When true, requests expanded workforce insights. Costs 5 additional credits per company.default false
companyenrichmcp_enrich_company_by_propertiesEnriches a company by known properties such as name or social profile URL.Write
Enrich Company By Properties
Enriches a company by known properties such as name or social profile URL. Costs 1 credit per call, plus 5 additional credits when includeWorkforce is true.
Inputs
facebookUrlstring
Company Facebook URL.
includeWorkforceboolean
When true, requests expanded workforce insights. Costs 5 additional credits per company.default false
instagramUrlstring
Company Instagram URL.
linkedinIdstring
Company LinkedIn ID.
linkedinUrlstring
Company LinkedIn URL.
namestring
Company name to enrich.
twitterUrlstring
Company Twitter/X URL.
youtubeUrlstring
Company YouTube URL.
companyenrichmcp_enrich_person_emailBETA: Resolves a work email address for a single person ID and optional company domain.Write
Enrich Person Email
BETA: Resolves a work email address for a single person ID and optional company domain. Costs 10 credits per newly accessed found email.
Inputs
idstringrequired
CompanyEnrich person ID.
domainstring
Optional company domain. If omitted, current experience domains are tried.

Setup

Install the SDK

Set your credentials

Create the CompanyEnrich MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Find Similar Companies

Inputs

Get Company By ID

Inputs

Get Company Workforce Insights

Inputs

Get Current User

Inputs

Get Person By ID

Inputs

Lookup Person By Email

Inputs

Search Companies

Inputs

Search People

Inputs

Enrich Company Information

Inputs

Enrich Company By Properties

Inputs

Enrich Person Email

Inputs

Related: other CRM & Sales connectors