Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Icypeas MCP server

Vendor MCP
Open markdown

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

Tools
21
What they doRead · write · destructive
3 · 18 · 03 read18 write0 destructive
Users sign in with
OAuth app
Your own Icypeas 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 Icypeas MCP connection

    In AgentKit > Connections, create an Icypeas 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

    Icypeas MCP server connections use your own OAuth app. Register one with Icypeas MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Icypeas 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 = 'icypeasmcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Icypeas 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: 'icypeasmcp_subscription_information',
    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
  • icypeasmcp_find_companies_countCount the number of companies matching a query in the Icypeas lead database.Read-only

    Find Companies Count

    Count the number of companies matching a query in the Icypeas lead database. This is free and does not consume credits. Use it to assess result size before fetching. Supports filters: name, lid, urn, companyId, type, industry, location, headcount, keyword, domain, revenue, headcountGrowth.

    Inputs

    queryobjectrequired
    The search query with filters
  • icypeasmcp_find_people_countCount the number of people matching a query in the Icypeas lead database.Read-only

    Find People Count

    Count the number of people matching a query in the Icypeas lead database. This is free and does not consume credits. Use it to assess result size before fetching. Supports filters: firstname, lastname, currentJobTitle, pastJobTitle, currentCompanyName, pastCompanyName, currentCompanyUrn, pastCompanyUrn, currentCompanyWebsite, pastCompanyWebsite, currentCompanyId, pastCompanyId, school, languages, skills, location, keyword.

    Inputs

    queryobjectrequired
    The search query with filters
  • icypeasmcp_subscription_informationRetrieve the current user's Icypeas subscription information: plan name, account status (free, none, cancelled, paid, unpaid), remaining credits, and daily SalesNav quota.Read-only

    Subscription Information

    Retrieve the current user's Icypeas subscription information: plan name, account status (free, none, cancelled, paid, unpaid), remaining credits, and daily SalesNav quota. Takes no input. Use this to check the user's account status or remaining credits.

    Inputs

    This tool takes no inputs.

  • icypeasmcp_bulk_company_scraperScrape full LinkedIn company data for multiple companies at once.Write

    Bulk Company Scraper

    Scrape full LinkedIn company data for multiple companies at once. Use this tool whenever 2 or more LinkedIn company URLs are provided. For a single company URL, use company-scraper instead. Handles any number of URLs automatically (batched internally at 50 per call, maximum 50,000).

    Inputs

    urlsarrayrequired
    List of LinkedIn company URLs to scrape (minimum 2, maximum 50,000)
  • icypeasmcp_bulk_email_verificationVerify whether multiple email addresses are valid and deliverable at once.Write

    Bulk Email Verification

    Verify whether multiple email addresses are valid and deliverable at once. Use this tool whenever 2 or more emails are provided. For a single email, use email-verification instead. Handles any number of entries automatically (batched internally at 50 per call).

    Inputs

    emailsarrayrequired
    List of email addresses to verify (minimum 2, maximum 50,000)