The ContactOut MCP connector routes your AI agent's tool calls to ContactOut's own MCP server through Scalekit. Each user signs in to ContactOut once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 15 tools.
- Tools
- 15
- What they doRead · write · destructive
- 15 · 0 · 015 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own ContactOut MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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 ContactOut MCP connection
In AgentKit > Connections, create a ContactOut MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
ContactOut MCP server connections use your own OAuth app. Register one with ContactOut MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the ContactOut MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'contactoutmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize ContactOut MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'contactoutmcp_company_information_from_domain',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "contactoutmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize ContactOut MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="contactoutmcp_company_information_from_domain",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcontactoutmcp_company_information_from_domainGet company information based on given input domains.Read-onlyCompany Information from Domain
Get company information based on given input domains. Cost: Consumes 1 search credit for each company found.
Inputs
domainsarray- Domain names to look up (e.g. `example.com`). Up to 30 entries.
contactoutmcp_company_searchGet company profiles matching the search criteria.Read-onlyCompany Search
Get company profiles matching the search criteria. Cost: Consumes 1 search credit for each company returned.
Inputs
domainarray- Company website domains
hq_onlyboolean- Filter search locations by headquarters only
industryarray- Industries; supports boolean expressions (OR, AND, NOT) with parentheses.
linkedin_urlarray- Company LinkedIn identifiers: full URL, slug (`contactout`), numeric id (`27927`), etc. Up to 25; Cannot be used with other search filters.
locationarray- Locations to match
max_revenueinteger- Maximum annual revenue in whole dollars (same allowed values as `min_revenue`; must be greater than `min_revenue` when both are set).one of
01000000500000010000000500000001000000002500000005000000001000000000 min_revenueinteger- Minimum annual revenue in whole dollars. Allowed values: 0, 1_000_000, 5_000_000, 10_000_000, 50_000_000, 100_000_000, 250_000_000, 500_000_000, 1_000_000_000.one of
01000000500000010000000500000001000000002500000005000000001000000000 namearray- Company names to match
pageinteger- Provides results for the given page
sizearray- Employee-count bucket codes: `1_10`, `11_50`, `51_200`, `201_500`, `501_1000`, `1001_5000`, `5001_10000`, `10001` (10,000+ employees).
year_founded_frominteger- Minimum year founded of the company; not before 1985.
year_founded_tointeger- Maximum year founded of the company (not after the current year). Use together with `year_founded_from`.
contactoutmcp_contact_info_from_linkedin_profileGet contact details for a single LinkedIn profile.Read-onlyContact Info from LinkedIn Profile
Get contact details for a single LinkedIn profile. Requesting real-time work emails via `email_type=work` may increase response time. Real-time verified `work_email` is **not** included unless you pass `email_type` accordingly. LinkedIn URLs from Sales Navigator or Recruiter are not supported. If `email_type` is not specified in the request, the response includes both personal and work emails. However, real-time verification is only performed when `email_type=work` is explicitly included, which may yield more work email results but can increase response time. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found (and `include_phone` is set to `true`).
Inputs
email_typestring- `email_type=personal` — only personal emails. `email_type=work` — only work emails. `email_type=personal,work` — both. `email_type=none` — no emails and no email credits. When omitted, both personal and work emails are returned.
include_phoneboolean- If true, include phone numbers in the response (uses phone credits when numbers are found).
profilestring- The fully formed URL of the LinkedIn profile. URL must begin with `http` and must contain `linkedin.com/in/` or `linkedin.com/pub/`
contactoutmcp_decision_makersGet profiles of key decision makers within a specified company.Read-onlyDecision Makers
Get profiles of key decision makers within a specified company. **At least one** of `linkedin_url`, `domain`, or `name` is required. You may pass any combination of these to identify the company. Cost: Consumes 1 search credit for each profile returned. Consumes 1 email/phone credit for every profile where email/phone info is found, if `reveal_info=true` is specified.
Inputs
domainstring- The domain name of the company's website, e.g. example.com
linkedin_urlstring- The fully formed URL of the company's LinkedIn profile. URL must begin with http and must contain linkedin.com/company/. Accepts both the numeric or string version of the URL, e.g. `https://linkedin.com/company/contactout` or `https://linkedin.com/company/27090845`
namestring- The name of the company
pageinteger- Provides results for the given page
reveal_infoboolean- If true, `contact_info` includes emails and phone numbers and credits are charged accordingly.
contactoutmcp_email_verifierVerify the deliverability of an email address.Read-onlyEmail Verifier
Verify the deliverability of an email address. `status` returns the status of the email address. Below are the possible values: - `valid`: the email address is valid. - `invalid`: the email address is not valid. - `accept_all`: the email address is valid but any email address is accepted by the server. - `disposable`: the email address comes from a disposable email service provider. - `unknown`: we failed to verify the email address. Cost: Consumes 1 "verifier" credit if result is either `valid`, `invalid` or `accept_all`
Inputs
emailstring- Email address
contactoutmcp_get_api_usage_statsGet ContactOut account stats for email, phone, and search for the requested month (`usage` in the JSON body).Read-onlyGet API Usage Stats
Get ContactOut account stats for email, phone, and search for the requested month (`usage` in the JSON body). Responses: - `count` / `phone_count` / `search_count`: successful API requests that consumed that credit in the period. - `quota` / `phone_quota` / `search_quota`: postpaid → monthly quota; prepaid → current prepaid balance. - `remaining` / `phone_remaining` / `search_remaining`: postpaid only; credits left in the month vs period usage. - `over_quota` / `phone_over_quota` / `search_over_quota`: postpaid only; amount over monthly quota when applicable. - `is_prepaid`: boolean indicating if the account is prepaid (true) or postpaid (false). Search (postpaid only): if the account has unlimited search credits, `search_quota` may be the string `unlimited` and `search_remaining` / `search_over_quota` may be omitted.
Inputs
periodstring- Month to report in `YYYY-MM` format; defaults to current month if not provided
contactoutmcp_linkedin_profile_from_emailGet profile details for a single email address.Read-onlyLinkedIn Profile from Email
Get profile details for a single email address. The match rate is typically higher with a personal email address as they change less frequently. For work emails, if the domain is from a past employer, previous work experience is checked to ensure accurate identification. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found.
Inputs
emailstring- Email address
includestring- Extra data to return; currently supports `work_email`
contactoutmcp_linkedin_profile_from_urlGet profile details for a single linkedin profile URL.Read-onlyLinkedIn Profile from URL
Get profile details for a single linkedin profile URL. Only standard LinkedIn profile URLs are accepted—not Sales Navigator or Talent / Recruiter products. Returns email addresses, phone numbers, work experience, education, skills, and more associated with a LinkedIn profile. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found. Consumes 1 search credit if `profile_only` is set to true or if there is no contact information available for the requested profile.
Inputs
profilestring- The fully formed URL of the LinkedIn profile. URL must begin with `http` and must contain `linkedin.com/in/` or `linkedin.com/pub/`
profile_onlyboolean- If true, returns profile data without contact information.
contactoutmcp_linkedin_url_from_emailGet LinkedIn profile url for a given email.Read-onlyLinkedIn URL from Email
Get LinkedIn profile url for a given email. Cost: Consumes 1 email credit if profile is found.
Inputs
emailstring- Email address
contactoutmcp_people_countGet the total count of profiles matching the search criteria.Read-onlyPeople Count
Get the total count of profiles matching the search criteria. Uses the same request fields as the `people-search` tool except do not send `page`, `data_types`, or `reveal_info` (they are not supported for counts). Cost: Does not consume credits Access: Only available to paid users
Inputs
companyarray- Company names to match
company_filterstring- `current` — match current company name. `past` — match any past company. `both` — match current or past experience.
company_sizearray- Employee-count bucket codes: `1_10`, `11_50`, `51_200`, `201_500`, `501_1000`, `1001_5000`, `5001_10000`, `10001` (10,000+ employees).
current_company_onlyboolean- If true, require a match on the current company name.
current_titles_onlyboolean- If true, match the current job title only; if false, include past titles as well.
current_work_locationarray- Cities or countries where the person currently works. Each entry supports boolean expressions (OR, AND, NOT).
detailed_educationboolean- If true, `education` returns structured objects (`school_name`, `degree`, `field_of_study`, `description`, dates, `url`, etc.); if false, returns simple text strings.
detailed_experienceboolean- If true, `experience` returns structured objects (`title`, `company_name`, `summary`, dates, `is_current`, `linkedin_url`, `logo_url`, etc.); if false, returns simple text strings.
domainarray- Company domains to match
educationarray- Schools or degrees. Supports boolean expressions (OR, AND, NOT)
educationsarray- Structured education filters. Provide at least one of `school_name`, `field_of_study`, or `location` per object. Each supports boolean expressions (OR, AND, NOT).
exclude_companiesarray- Company names to exclude
exclude_job_titlesarray- Job titles to exclude from results.
include_related_job_titlesboolean- If true, include related job titles in the match.
industryarray- Industries; supports boolean expressions (OR, AND, NOT).
job_functionarray- Job functions (e.g. Engineering, Marketing, Sales, Finance); values must match supported job-function labels.
job_titlearray- Job titles to match. Supports boolean expressions (OR, AND, NOT).
keywordstring- Returns profiles that contain the mentioned keyword anywhere in their profile. Supports boolean expressions (OR, AND, NOT).
languagesarray- Language filters: each item has `language` and optionally `proficiency`. `language` supports boolean expressions (OR, AND, NOT).
locationarray- Locations to match
location_radiusinteger- Search radius in miles (1-500). Only works when `location` is provided and the location is a city / area. Filters profiles within the specified radius of the location.
match_experiencestring- Allowed values: current, past, past_only, or both. `current` — `job_title` and `company` must match the current experience. `past` — match any past experience. `past_only` — match a past experience, excluding profiles that also have a current role at the same company. `both` — match current or past. When set, do not use `current_titles_only`, `company_filter`, or `current_company_only` (the request will be rejected).
namestring- Name of the profile
output_fieldsarray- This parameter controls which fields are included in the output. By default, all fields are returned. Use this to limit the output to only the fields you need, which can reduce token usage and cost. Allowed values: li_vanity, full_name, title, headline, company, company.name, company.website, company.headquarter, company.domain, company.size, location, industry, experience, education, skills, profile_picture_url.
past_work_locationarray- Cities or countries where the person previously worked. Each entry supports boolean expressions (OR, AND, NOT).
recently_changed_jobsboolean- Filter for profiles who recently changed jobs
seniorityarray- Seniority levels to filter profiles by their career level`owner / founder` (Founder/Owner), `cxo` (C-suite), `vp` (Vice President), plus `partner`, `head`, `director`, `manager`, `senior`, `entry`, `intern`.
skillsarray- Skills to match. Supports boolean expressions (OR, AND, NOT)
years_in_current_rolearray- Tenure in current role as `X_Y` (e.g. `1_3` = 1–3 years). Multiple ranges are OR’d.
years_of_experiencearray- Total experience ranges as `X_Y` (e.g. `2_5` = 2–5 years). Multiple ranges are OR’d.
contactoutmcp_people_enrichGet profile details using a combination of data points such as name, email, phone, LinkedIn URL, company information, education, and location.Read-onlyPeople Enrich
Get profile details using a combination of data points such as name, email, phone, LinkedIn URL, company information, education, and location. This tool provides flexible enrichment by allowing you to provide multiple identifying parameters to find and enrich a person's profile. By default, this endpoint returns profile information without contact details. To include contact information such as email addresses and phone numbers, you must specify the include parameter with the desired contact types. Matching rules: supply one primary identifier (`linkedin_url`, `email`, or `phone`) **or** a name (`full_name`, or `first_name` + `last_name`) together with at least one secondary field among `company`, `company_domain`, `job_title`, `location`, or `education`. Contact details only appear when you list them in `include` (`work_email`, `personal_email`, `phone`). Cost: Consumes 1 search credit if a profile was found. Consumes 1 email credit if email is found and 1 phone credit if phone number is found.
Inputs
companyarray- Company names (up to 10)
company_domainarray- Company domains (up to 10)
educationarray- Educational institutions (up to 10).
emailstring- Email address
first_namestring- First name (must be used with last_name)
full_namestring- Full name of the person
includearray- Data to include: `work_email`, `personal_email`, `phone`
job_titlestring- Job title
last_namestring- Last name (must be used with first_name)
linkedin_urlstring- LinkedIn profile URL
locationstring- Location/city
phonestring- Phone number
contactoutmcp_people_searchGet profiles matching the search criteria.Read-onlyPeople Search
Get profiles matching the search criteria. Some parameters accept boolean expressions using OR, AND, and NOT. Use parentheses so grouping is explicit (e.g. `(React AND Python) NOT Java`). For example, if you are looking for profiles who have the skills ReactJS and Python, but not Java, you can format the skills parameter as: { "skills": ["(ReactJS AND Python) NOT Java"] }. Always add brackets to ensure the boolean logic is applied correctly. Supported operators: OR, AND, NOT. Responses contain meta information and the matching list of profiles. Each profile contains the information like title, headline, company details, experience, skills etc. It also lists the contact availability and contact information fields. Cost: Consumes 1 search credit for each profile returned. Consumes 1 email/phone credit for every profile where email/phone info is found, if `reveal_info=true` is specified.
Inputs
companyarray- Company names to match
company_filterstring- `current` — match current company name. `past` — match any past company. `both` — match current or past experience.
company_sizearray- Employee-count bucket codes: `1_10`, `11_50`, `51_200`, `201_500`, `501_1000`, `1001_5000`, `5001_10000`, `10001` (10,000+ employees).
current_company_onlyboolean- If true, require a match on the current company name.
current_titles_onlyboolean- If true, match the current job title only; if false, include past titles as well.
current_work_locationarray- Cities or countries where the person currently works. Each entry supports boolean expressions (OR, AND, NOT).
data_typesarray- Require at least one of: `personal_email`, `work_email`, `phone`.
detailed_educationboolean- If true, `education` returns structured objects (`school_name`, `degree`, `field_of_study`, `description`, dates, `url`, etc.); if false, returns simple text strings.
detailed_experienceboolean- If true, `experience` returns structured objects (`title`, `company_name`, `summary`, dates, `is_current`, `linkedin_url`, `logo_url`, etc.); if false, returns simple text strings.
domainarray- Company domains to match
educationarray- Schools or degrees. Supports boolean expressions (OR, AND, NOT)
educationsarray- Structured education filters. Provide at least one of `school_name`, `field_of_study`, or `location` per object. Each supports boolean expressions (OR, AND, NOT).
exclude_companiesarray- Company names to exclude
exclude_job_titlesarray- Job titles to exclude from results.
include_related_job_titlesboolean- If true, include related job titles in the match.
industryarray- Industries; supports boolean expressions (OR, AND, NOT).
job_functionarray- Job functions (e.g. Engineering, Marketing, Sales, Finance); values must match supported job-function labels.
job_titlearray- Job titles to match. Supports boolean expressions (OR, AND, NOT).
keywordstring- Returns profiles that contain the mentioned keyword anywhere in their profile. Supports boolean expressions (OR, AND, NOT).
languagesarray- Language filters: each item has `language` and optionally `proficiency`. `language` supports boolean expressions (OR, AND, NOT).
locationarray- Locations to match
location_radiusinteger- Search radius in miles (1-500). Only works when `location` is provided and the location is a city / area. Filters profiles within the specified radius of the location.
match_experiencestring- Allowed values: current, past, past_only, or both. `current` — `job_title` and `company` must match the current experience. `past` — match any past experience. `past_only` — match a past experience, excluding profiles that also have a current role at the same company. `both` — match current or past. When set, do not use `current_titles_only`, `company_filter`, or `current_company_only` (the request will be rejected).
namestring- Name of the profile
output_fieldsarray- This parameter controls which fields are included in the output. By default, all fields are returned. Use this to limit the output to only the fields you need, which can reduce token usage and cost. Allowed values: li_vanity, full_name, title, headline, company, company.name, company.website, company.headquarter, company.domain, company.size, location, industry, experience, education, skills, profile_picture_url.
pageinteger- Provides results for the given page
past_work_locationarray- Cities or countries where the person previously worked. Each entry supports boolean expressions (OR, AND, NOT).
recently_changed_jobsboolean- Filter for profiles who recently changed jobs
reveal_infoboolean- If true, `contact_info` includes emails and phone numbers and credits are charged accordingly.
seniorityarray- Seniority levels to filter profiles by their career level`owner / founder` (Founder/Owner), `cxo` (C-suite), `vp` (Vice President), plus `partner`, `head`, `director`, `manager`, `senior`, `entry`, `intern`.
skillsarray- Skills to match. Supports boolean expressions (OR, AND, NOT)
years_in_current_rolearray- Tenure in current role as `X_Y` (e.g. `1_3` = 1–3 years). Multiple ranges are OR’d.
years_of_experiencearray- Total experience ranges as `X_Y` (e.g. `2_5` = 2–5 years). Multiple ranges are OR’d.
contactoutmcp_personal_email_checkerGet personal email availability status for a single Linkedin profile Cost: Does not consume credits Access: Only available to paid usersRead-onlyPersonal Email Checker
Get personal email availability status for a single Linkedin profile Cost: Does not consume credits Access: Only available to paid users
Inputs
profilestring- The fully formed URL of the LinkedIn profile. URL must begin with `http` and must contain `linkedin.com/in/` or `linkedin.com/pub/`
contactoutmcp_phone_checkerGet phone availability status for a single LinkedIn profile Cost: Does not consume credits Access: Only available to paid usersRead-onlyPhone Checker
Get phone availability status for a single LinkedIn profile Cost: Does not consume credits Access: Only available to paid users
Inputs
profilestring- The fully formed URL of the LinkedIn profile. URL must begin with `http` and must contain `linkedin.com/in/` or `linkedin.com/pub/`
contactoutmcp_work_email_checkerGet work email availability status for a single LinkedIn profile Response: `profile.email` returns true if work email is present.Read-onlyWork Email Checker
Get work email availability status for a single LinkedIn profile Response: `profile.email` returns true if work email is present. `profile.email_status` returns whether the email is verified or unverified, and may be `Verified`, `Unverified`, or `null`. Cost: Does not consume credits Access: Only available to paid users
Inputs
profilestring- The fully formed URL of the LinkedIn profile. URL must begin with `http` and must contain `linkedin.com/in/` or `linkedin.com/pub/`.
No tools match.