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
- OAuth app
- Your own Icypeas 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 Icypeas MCP connection
In AgentKit > Connections, create an Icypeas 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
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.
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 = 'icypeasmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'icypeasmcp_subscription_information',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 = "icypeasmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Icypeas MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="icypeasmcp_subscription_information",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_toolicypeasmcp_find_companies_countCount the number of companies matching a query in the Icypeas lead database.Read-onlyFind 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-onlyFind 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-onlySubscription 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.WriteBulk 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_company_searchFind LinkedIn company page URLs for multiple companies at once.WriteBulk Company Search
Find LinkedIn company page URLs for multiple companies at once. Use this tool whenever 2 or more companies are provided. For a single company, use company-search instead. Handles any number of entries automatically (batched internally at 50 per call).
Inputs
companiesarrayrequired- List of companies to look up (minimum 2, maximum 50,000)
icypeasmcp_bulk_domain_searchFind all known email addresses for multiple domains or companies at once.WriteBulk Domain Search
Find all known email addresses for multiple domains or companies at once. Use this tool whenever 2 or more domains/companies are provided. For a single domain, use domain-search instead. Handles any number of entries automatically (batched internally at 50 per call).
Inputs
domainsarrayrequired- List of domains or company names to search (minimum 2, maximum 50,000)
icypeasmcp_bulk_email_searchFind professional email addresses for multiple people at once.WriteBulk Email Search
Find professional email addresses for multiple people at once. Use this tool whenever 2 or more people are provided. For a single person, use email-search instead. Handles any number of entries automatically (batched internally at 50 per call).
Inputs
prospectsarrayrequired- List of people to look up (minimum 2, maximum 50,000)
icypeasmcp_bulk_email_verificationVerify whether multiple email addresses are valid and deliverable at once.WriteBulk 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)
icypeasmcp_bulk_profile_scraperScrape full LinkedIn profile data for multiple people at once.WriteBulk Profile Scraper
Scrape full LinkedIn profile data for multiple people at once. Use this tool whenever 2 or more LinkedIn profile URLs are provided. For a single profile URL, use profile-scraper instead. Handles any number of URLs automatically (batched internally at 50 per call, maximum 50,000).
Inputs
urlsarrayrequired- List of LinkedIn profile URLs to scrape (minimum 2, maximum 50,000)
icypeasmcp_bulk_profile_searchFind LinkedIn profile URLs for multiple people at once.WriteBulk Profile Search
Find LinkedIn profile URLs for multiple people at once. Use this tool whenever 2 or more people are provided. For a single person, use profile-search instead. Handles any number of entries automatically (batched internally at 50 per call).
Inputs
profilesarrayrequired- List of people to look up (minimum 2, maximum 50,000)
icypeasmcp_bulk_reverse_email_lookupFind LinkedIn profile URLs for multiple professional email addresses at once.WriteBulk Reverse Email Lookup
Find LinkedIn profile URLs for multiple professional email addresses at once. Use this tool whenever 2 or more emails are provided. For a single email, use reverse-email-lookup instead. Handles any number of emails automatically (batched internally at 50 per call).
Inputs
emailsarrayrequired- List of professional email addresses to look up (minimum 2, maximum 50,000)
icypeasmcp_company_scraperScrape a single LinkedIn company page by URL and return all available company data (name, description, industry, headcount, revenue, specialties, address, employee growth, etc.).WriteCompany Scraper
Scrape a single LinkedIn company page by URL and return all available company data (name, description, industry, headcount, revenue, specialties, address, employee growth, etc.). Use this tool for exactly one company URL. If the user provides 2 or more URLs, use bulk-company-scraper instead.
Inputs
urlstringrequired- LinkedIn company URL (e.g. https://www.linkedin.com/company/my-linkedin-id)
icypeasmcp_company_searchFind the LinkedIn company page URL for a single company name or domain.WriteCompany Search
Find the LinkedIn company page URL for a single company name or domain. Use this tool for exactly one company. If the user provides 2 or more companies, use bulk-company-search instead.
Inputs
companyOrDomainstringrequired- Company name (e.g. 'NEC Technologies') or domain name (e.g. 'nec.com')
icypeasmcp_domain_searchScan a domain or company and return all role-based email addresses associated with it.WriteDomain Search
Scan a domain or company and return all role-based email addresses associated with it. Useful for finding generic email addresses inside an organisation.Use this tool for exactly one domain. If the user provides 2 or more items, use bulk-domain-search instead.
Inputs
domainOrCompanystringrequired- Company name (e.g. 'Icypeas') or domain (e.g. 'icypeas.com')
icypeasmcp_email_searchFind the professional email address of a person given their first name, last name, and company name or domain.WriteEmail Search
Find the professional email address of a person given their first name, last name, and company name or domain. Returns the email, certainty level, and MX provider when found.Use this tool for exactly one email address. If the user provides 2 or more items, use bulk-email-search instead.
Inputs
domainOrCompanystringrequired- Company name (e.g. 'Icypeas') or domain (e.g. 'icypeas.com')
firstnamestringrequired- First name of the person
lastnamestringrequired- Last name of the person
icypeasmcp_email_verificationVerify whether an email address is valid and deliverable.WriteEmail Verification
Verify whether an email address is valid and deliverable. Returns the certainty level and MX provider when the address is confirmed to exist.Use this tool for exactly one email address. If the user provides 2 or more items, use bulk-email-verification instead.
Inputs
emailstringrequired- The email address to verify
icypeasmcp_find_companiesSearch for companies in the Icypeas lead database and retrieve detailed results.WriteFind Companies
Search for companies in the Icypeas lead database and retrieve detailed results. Automatically fetches all pages up to a maximum of 50,000 companies (or up to maxResults if specified). Supports filters: name, lid, urn, companyId, type, industry, location, headcount, keyword, domain, revenue, headcountGrowth. Use find-companies-count first to check result size without consuming credits.
Inputs
queryobjectrequired- The search query with filters
maxResultsinteger- Maximum number of companies to retrieve (1–50,000). Defaults to all results up to 50,000.
icypeasmcp_find_peopleSearch for people in the Icypeas lead database and retrieve detailed results.WriteFind People
Search for people in the Icypeas lead database and retrieve detailed results. Automatically fetches all pages up to a maximum of 50,000 people (or up to maxResults if specified). Supports filters: firstname, lastname, currentJobTitle, pastJobTitle, currentCompanyName, pastCompanyName, currentCompanyUrn, pastCompanyUrn, currentCompanyWebsite, pastCompanyWebsite, currentCompanyId, pastCompanyId, school, languages, skills, location, keyword. Use find-people-count first to check result size without consuming credits.
Inputs
queryobjectrequired- The search query with filters
maxResultsinteger- Maximum number of people to retrieve (1–50,000). Defaults to all results up to 50,000.
icypeasmcp_profile_scraperScrape a single LinkedIn profile by URL and return all available profile data (name, headline, work experience, education, skills, contact info, etc.).WriteProfile Scraper
Scrape a single LinkedIn profile by URL and return all available profile data (name, headline, work experience, education, skills, contact info, etc.). Use this tool for exactly one profile URL. If the user provides 2 or more URLs, use bulk-profile-scraper instead.
Inputs
urlstringrequired- LinkedIn profile URL (e.g. https://www.linkedin.com/in/my-linkedin-id)
icypeasmcp_profile_searchFind the LinkedIn profile URL for a single person given their name and company or job title.WriteProfile Search
Find the LinkedIn profile URL for a single person given their name and company or job title. Use this tool for exactly one person. If the user provides 2 or more people, use bulk-profile-search instead.
Inputs
firstnamestringrequired- First name of the prospect
lastnamestringrequired- Last name of the prospect
companyOrDomainstring- Company name or domain name (required if jobTitle is not provided)
jobTitlestring- Job title of the prospect (required if companyOrDomain is not provided)
icypeasmcp_reverse_email_lookupFind the LinkedIn profile URL behind a single professional email address.WriteReverse Email Lookup
Find the LinkedIn profile URL behind a single professional email address. Use this tool for exactly one email. If the user provides 2 or more emails, use bulk-reverse-email-lookup instead.
Inputs
emailstringrequired- The professional email address to look up
No tools match.