Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the ContactOut MCP server

Vendor MCP
Open markdown

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 app
Your own ContactOut MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. 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>
  3. 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_name your code passes. See Configure connections.

  4. 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.

  5. 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.actions
    const connector = 'contactoutmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'contactoutmcp_company_information_from_domain',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    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 PlaygroundRequest a tool
  • contactoutmcp_company_information_from_domainGet company information based on given input domains.Read-only

    Company 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_contact_info_from_linkedin_profileGet contact details for a single LinkedIn profile.Read-only

    Contact 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-only

    Decision 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-only

    Email 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-only

    Get 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-only

    LinkedIn 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-only

    LinkedIn 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.