LeadIQ MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

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. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'leadiqmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize LeadIQ MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'leadiqmcp_check_credits',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "leadiqmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize LeadIQ MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="leadiqmcp_check_credits",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• List add prospect to, attach prospect to — Create a new prospect and attach it to an existing LeadIQ Prospector list in one step
• Lists browse prospect — Paginate through the user’s saved LeadIQ Prospector lists and return list metadata (id, name, description, status, visibility, dates)
• Credits check — Return the user’s current LeadIQ credit balance and live per-field unlock costs
• Create prospect, prospect list — Create a standalone prospect record in LeadIQ Prospector without attaching it to any list
• Companies enrich, find — Look up known companies in LeadIQ’s B2B database by domain, name, LinkedIn URL, or LinkedIn ID and return firmographics, technographics, funding rounds, revenue range, NAICS/SIC codes, and social profiles
• People enrich, find — Look up known people in LeadIQ’s B2B database by LinkedIn URL, email, or name + company, and unlock verified work email and direct phone per person

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

leadiqmcp_add_prospect_to_list#Create a new prospect and attach it to an existing LeadIQ Prospector list in one step. Returns the full prospect record with emails, phones, company, and list memberships. No credits consumed for list management (contact data unlock costs happen separately via Enrich People). Confirm the destination list with the user before saving.2 params▾

Create a new prospect and attach it to an existing LeadIQ Prospector list in one step. Returns the full prospect record with emails, phones, company, and list memberships. No credits consumed for list management (contact data unlock costs happen separately via Enrich People). Confirm the destination list with the user before saving.

NameTypeRequiredDescription

listIdstringrequiredDestination list id (24-char hex ObjectId).

prospectobjectrequiredThe prospect to create and attach to the list.

leadiqmcp_attach_prospect_to_list#Attach an existing saved prospect (by id) to a list without creating a new record. No credits consumed. Idempotent — attaching the same prospect twice is safe. Use Add Prospect To List instead when you need to create and attach in one step.2 params▾

Attach an existing saved prospect (by id) to a list without creating a new record. No credits consumed. Idempotent — attaching the same prospect twice is safe. Use Add Prospect To List instead when you need to create and attach in one step.

NameTypeRequiredDescription

listIdstringrequiredDestination list id (24-char hex ObjectId).

prospectIdstringrequiredId of the existing prospect to attach.

leadiqmcp_browse_prospect_lists#Paginate through the user's saved LeadIQ Prospector lists and return list metadata (id, name, description, status, visibility, dates). No credits consumed. Use this to discover existing lists before adding prospects or picking a destination list.2 params▾

Paginate through the user's saved LeadIQ Prospector lists and return list metadata (id, name, description, status, visibility, dates). No credits consumed. Use this to discover existing lists before adding prospects or picking a destination list.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a previous response's nextCursor. Omit on the first page.

limitintegeroptionalNumber of lists to return per page (1–100, default 25).

leadiqmcp_check_credits#Return the user's current LeadIQ credit balance and live per-field unlock costs. No credits consumed. Call this before large paid operations (Enrich People, Find People, Find Companies firmographics) to confirm available credits and quote accurate costs. Prefer the returned live costs over hardcoded figures in other tools.0 params▾

Return the user's current LeadIQ credit balance and live per-field unlock costs. No credits consumed. Call this before large paid operations (Enrich People, Find People, Find Companies firmographics) to confirm available credits and quote accurate costs. Prefer the returned live costs over hardcoded figures in other tools.

leadiqmcp_create_prospect#Create a standalone prospect record in LeadIQ Prospector without attaching it to any list. No credits consumed for list management (contact data may have been unlocked separately via Enrich People). Not idempotent — each call creates a distinct record. To create and attach to a list in one step, use Add Prospect To List instead.14 params▾

Create a standalone prospect record in LeadIQ Prospector without attaching it to any list. No credits consumed for list management (contact data may have been unlocked separately via Enrich People). Not idempotent — each call creates a distinct record. To create and attach to a list in one step, use Add Prospect To List instead.

NameTypeRequiredDescription

firstNamestringrequiredFirst name.

lastNamestringrequiredLast name.

companystringoptionalCompany name.

companyDomainstringoptionalCompany domain.

companyIndustrystringoptionalCompany industry.

emailStatusstringoptionalVerification status of the work email. Set only when the email was already vetted upstream (e.g. returned as verified by Enrich People). Omit if unknown.

functionstringoptionalJob function (e.g. Sales, Marketing, Engineering).

linkedinUrlstringoptionalLinkedIn profile URL.

notesstringoptionalFree-form notes about the prospect.

personIdstringoptionalLeadIQ stable person id from a prior Enrich People result. Required to enable the verified-phone flow.

phonestringoptionalMobile or direct phone number. Pair with personId to enable the verified-phone flow.

senioritystringoptionalSeniority level. Use Other when the title does not map cleanly.

titlestringoptionalJob title.

workEmailstringoptionalWork email address, if known.

leadiqmcp_create_prospect_list#Create a new named prospect list in LeadIQ Prospector to organize and track leads. No credits consumed. After creation, use the returned list id with Add Prospect To List to populate it.2 params▾

Create a new named prospect list in LeadIQ Prospector to organize and track leads. No credits consumed. After creation, use the returned list id with Add Prospect To List to populate it.

NameTypeRequiredDescription

namestringrequiredName of the new prospect list.

descriptionstringoptionalOptional free-form description of the list.

leadiqmcp_enrich_companies#Look up known companies in LeadIQ's B2B database by domain, name, LinkedIn URL, or LinkedIn ID and return firmographics, technographics, funding rounds, revenue range, NAICS/SIC codes, and social profiles. Batch up to 10 companies per call. Cost: 3 UC per result returned. Always obtain explicit user consent before calling, as the full query is a paid export.1 param▾

Look up known companies in LeadIQ's B2B database by domain, name, LinkedIn URL, or LinkedIn ID and return firmographics, technographics, funding rounds, revenue range, NAICS/SIC codes, and social profiles. Batch up to 10 companies per call. Cost: 3 UC per result returned. Always obtain explicit user consent before calling, as the full query is a paid export.

NameTypeRequiredDescription

companiesarrayrequiredUp to 10 companies to look up. Identify each by domain, name, linkedinUrl, or linkedinId.

leadiqmcp_enrich_people#Look up known people in LeadIQ's B2B database by LinkedIn URL, email, or name + company, and unlock verified work email and direct phone per person. Batch up to 10 people per call. Cost: 0.1 UC profile (always), +1 UC/person for email, +10 UC/person for phone, +3 UC/company for firmographics. Default run unlocks email + phone (up to 11 UC/person); company unlock requires explicit consent. LeadIQ only bills for data returned.5 params▾

Look up known people in LeadIQ's B2B database by LinkedIn URL, email, or name + company, and unlock verified work email and direct phone per person. Batch up to 10 people per call. Cost: 0.1 UC profile (always), +1 UC/person for email, +10 UC/person for phone, +3 UC/company for firmographics. Default run unlocks email + phone (up to 11 UC/person); company unlock requires explicit consent. LeadIQ only bills for data returned.

NameTypeRequiredDescription

peoplearrayrequiredUp to 10 people to look up. Identify each by linkedinUrl (best), email, id, or fullName + company.

unlockCompanybooleanoptionalUnlock company firmographics — domain, industry, employee range (3 UC per company returned). Default false. Always requires explicit user consent.

unlockPersonalPhonebooleanoptionalUnlock personal phone, which is a direct business number (10 UC/person, always paired with work phone). Default true.

unlockWorkEmailbooleanoptionalUnlock work email (1 UC/person). Default true.

unlockWorkPhonebooleanoptionalUnlock direct phone (10 UC/person, always paired with personal phone unlock). Default true.

leadiqmcp_find_companies#Discover companies matching ICP criteria in LeadIQ's B2B database — filter by industry, size, revenue, funding, technology stack, location, and more. Returns a list of companies with firmographic identity. Default cost: 3 UC/company (company unlock is on by default). Set unlockCompany=false for id + name only at 0.1 UC. Always obtain user consent before running with company unlock enabled.2 params▾

Discover companies matching ICP criteria in LeadIQ's B2B database — filter by industry, size, revenue, funding, technology stack, location, and more. Returns a list of companies with firmographic identity. Default cost: 3 UC/company (company unlock is on by default). Set unlockCompany=false for id + name only at 0.1 UC. Always obtain user consent before running with company unlock enabled.

NameTypeRequiredDescription

inputobjectrequiredSearch filters for company discovery.

unlockCompanybooleanoptionalReturn full company firmographics — domain, industry, employee count (3 UC/company). Default true. Set false for id + name only at 0.1 UC.

leadiqmcp_find_job_changes#Discover people who recently changed jobs or were promoted, matched against ICP criteria. Returns each person's full transition (previous position and company → current position and company) as a buying or warm-intro trigger signal. Default cost: 0.1 UC/person (profile only). Company firmographics unlock costs 3 UC/person and requires consent. jobChangeFilter is required — use JobChange for company movers, TitleChange for in-place promotions.2 params▾

Discover people who recently changed jobs or were promoted, matched against ICP criteria. Returns each person's full transition (previous position and company → current position and company) as a buying or warm-intro trigger signal. Default cost: 0.1 UC/person (profile only). Company firmographics unlock costs 3 UC/person and requires consent. jobChangeFilter is required — use JobChange for company movers, TitleChange for in-place promotions.

NameTypeRequiredDescription

inputobjectrequiredSearch filters. jobChangeFilter is required.

unlockCompanybooleanoptionalUnlock firmographics on both previous and current company blocks (3 UC/record). Default false. Requires user consent.

leadiqmcp_find_people#Discover new leads in LeadIQ's B2B database matching ICP criteria — filter by title, seniority, role, industry, technology stack, company size, revenue, funding, location, and hiring or promotion signals. Returns a flat list of people with current position and company identity. Default cost: 0.1 UC/person (profile only). Company firmographics unlock costs 3 UC/person and requires consent. Use Enrich People for known individuals; use this for open-ended prospecting.2 params▾

Discover new leads in LeadIQ's B2B database matching ICP criteria — filter by title, seniority, role, industry, technology stack, company size, revenue, funding, location, and hiring or promotion signals. Returns a flat list of people with current position and company identity. Default cost: 0.1 UC/person (profile only). Company firmographics unlock costs 3 UC/person and requires consent. Use Enrich People for known individuals; use this for open-ended prospecting.

NameTypeRequiredDescription

inputobjectrequiredSearch filters.

unlockCompanybooleanoptionalUnlock company firmographics for each result (3 UC/person). Default false. Requires user consent.

leadiqmcp_get_prospect#Fetch a single saved Prospector prospect by id, returning the full record including LinkedIn URL, work email, phones, company, location, list memberships, and notes. No credits consumed. Reads data already saved in the user's account.1 param▾

Fetch a single saved Prospector prospect by id, returning the full record including LinkedIn URL, work email, phones, company, location, list memberships, and notes. No credits consumed. Reads data already saved in the user's account.

NameTypeRequiredDescription

idstringrequiredProspect id (24-char hex ObjectId).

leadiqmcp_get_prospect_list#Fetch a single LeadIQ Prospector list by id, including its paginated prospect records. No credits consumed. Use this to inspect prospects already saved in a known list.3 params▾

Fetch a single LeadIQ Prospector list by id, including its paginated prospect records. No credits consumed. Use this to inspect prospects already saved in a known list.

NameTypeRequiredDescription

idstringrequiredList id (24-char hex ObjectId).

prospectsCursorstringoptionalPagination cursor from a previous call's prospects.nextCursor. Omit on the first page.

prospectsLimitintegeroptionalNumber of prospects to return per page (1–100, default 25).

leadiqmcp_search_prospects#Search the user's saved Prospector prospects across all lists by email or full name. No credits consumed. Pass either email alone, or firstName + lastName together — mixed or partial queries are not supported. Use this to check for existing contacts before creating duplicates.5 params▾

Search the user's saved Prospector prospects across all lists by email or full name. No credits consumed. Pass either email alone, or firstName + lastName together — mixed or partial queries are not supported. Use this to check for existing contacts before creating duplicates.

NameTypeRequiredDescription

cursorstringoptionalPagination cursor from a prior nextCursor.

emailstringoptionalExact email to search by. Use alone (without firstName/lastName).

firstNamestringoptionalFirst name. Must be used together with lastName.

lastNamestringoptionalLast name. Must be used together with firstName.

limitintegeroptionalNumber of results per page (1–100, default 25).

leadiqmcp_verify_email#Verify any email address against LeadIQ's Email Verification Service and return a deliverability verdict: Verified, VerifiedLikely, Unverified, or Invalid. No credits consumed. Does not require an existing prospect — use as a pre-flight check before saving contact data.1 param▾

Verify any email address against LeadIQ's Email Verification Service and return a deliverability verdict: Verified, VerifiedLikely, Unverified, or Invalid. No credits consumed. Does not require an existing prospect — use as a pre-flight check before saving contact data.

NameTypeRequiredDescription

emailstringrequiredEmail address to verify.

leadiqmcp_verify_prospect_email#Re-verify the work email already stored on a saved Prospector prospect and persist the updated status. No credits consumed. Returns the verdict (Verified, VerifiedLikely, Unverified, or Invalid) plus the updated prospect. Returns 409 if the prospect has no email on record. To verify an arbitrary email not tied to a prospect, use Verify Email instead.1 param▾

Re-verify the work email already stored on a saved Prospector prospect and persist the updated status. No credits consumed. Returns the verdict (Verified, VerifiedLikely, Unverified, or Invalid) plus the updated prospect. Returns 409 if the prospect has no email on record. To verify an arbitrary email not tied to a prospect, use Verify Email instead.

NameTypeRequiredDescription

prospectIdstringrequiredId of the saved prospect whose email to verify.