Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Prospeo MCP server

Vendor MCP
Open markdown

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

Tools
8
What they doRead · write · destructive
8 · 0 · 08 read0 write0 destructive
Users sign in with
OAuth app
Your own Prospeo 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 Prospeo MCP connection

    In AgentKit > Connections, create a Prospeo 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

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

    Then enter the app's Client ID and Client Secret on the Prospeo 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 = 'prospeomcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Prospeo 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: 'prospeomcp_enrich_company',
    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
  • prospeomcp_bulk_enrich_companyEnrich up to 25 companies in ONE call — the canonical lookup tool when you already have a list of company names/domains (CRM exports, account lists, competitor maps).Read-only

    Bulk Enrich Companies

    Enrich up to 25 companies in ONE call — the canonical lookup tool when you already have a list of company names/domains (CRM exports, account lists, competitor maps). Each record needs one of: company_id, company_website, company_linkedin_url, or company_name. Returns the full company profile per match (tech stack, attributes, funding, job postings — same shape as enrich_company). identifier defaults to company_id when provided so search_company → bulk_enrich_company chains correlate without extra bookkeeping. Use search_company instead when you don't yet know which companies to target. 1 credit per matched company.

    Inputs

    dataarrayrequired
    Up to 25 company records to enrich in a single request.
  • prospeomcp_bulk_enrich_personEnrich up to 25 people in ONE call — the canonical follow-up to search_person.Read-only

    Bulk Enrich People

    Enrich up to 25 people in ONE call — the canonical follow-up to search_person. Pass each search result's person_id as a record; the matched.identifier in the response equals that person_id so you can stitch results back to the original list. Per-record cost is identical to enrich_person (1 credit per matched email, 10 per matched email+mobile). Response also includes free_enrichment per record so you can attribute credit consumption. Returns a compact response per record (no job_history, no skills, abbreviated company summary) — use enrich_person if you need the full profile for a specific person. For >25 records, call this multiple times — do not auto-batch.

    Inputs

    dataarrayrequired
    Up to 25 person records to enrich in a single request.
    enrich_mobileboolean
    Also look up mobile numbers (10 credits per matched record; email is included at no extra cost).default false
    only_verified_emailboolean
    Only return records where a verified email is found. Applies to every record in `data`.default false
    only_verified_mobileboolean
    Only return records where a verified mobile is found (automatically enables enrich_mobile).default false
  • prospeomcp_enrich_companyEnrich a company — return its full profile (headcount, industry, revenue, tech stack, funding, social links, HQ phone).Read-only

    Enrich Company

    Enrich a company — return its full profile (headcount, industry, revenue, tech stack, funding, social links, HQ phone). Provide at least one identifier: company_website (most accurate), company_linkedin_url, company_name, or company_id (from a prior search result). Credits: 1 per successful match. No charge if no match is found. Check free_enrichment in the response to confirm whether credits were deducted.

    Inputs

    company_idstring
    Prospeo company_id from a prior Enrich Person or Search result
    company_linkedin_urlstring
    Company LinkedIn URL
    company_namestring
    Company name, e.g. Acme Inc
    company_websitestring
    Company website domain, e.g. acme.com
  • prospeomcp_enrich_personEnrich a SINGLE person — return their full profile with verified email and/or mobile, job history, and current company.Read-only

    Enrich Person

    Enrich a SINGLE person — return their full profile with verified email and/or mobile, job history, and current company. Provide at least one identifier: linkedin_url, email, person_id (from a prior search result), or full_name/first_name+last_name plus company_name/company_website. Credits: 1 for email, 10 for email + mobile (set enrich_mobile=true; email is included free when mobile is requested). Credits are only deducted when the requested contact data is actually returned. No charge if no person is matched, and no charge if only_verified_email/only_verified_mobile is set but no verified contact exists. Check free_enrichment in the response to confirm. If you have MULTIPLE people to enrich (e.g. a full page of search_person results), use bulk_enrich_person instead — same per-record cost, one call.

    Inputs

    company_linkedin_urlstring
    Company LinkedIn URL
    company_namestring
    Current employer name
    company_websitestring
    Company website domain, e.g. acme.com
    emailstring
    Person's email address
    enrich_mobileboolean
    Also look up the person's mobile phone number (costs 10 credits; email is included at no extra cost when mobile is requested)default false
    first_namestring
    Person's first name
    full_namestring
    Person's full name (alternative to first_name + last_name)
    last_namestring
    Person's last name
    linkedin_urlstring
    LinkedIn profile URL, e.g. https://www.linkedin.com/in/johndoe
    only_verified_emailboolean
    Only return the result if a verified email is founddefault false
    only_verified_mobileboolean
    Only return the result if a verified mobile is found (automatically enables enrich_mobile)default false
    person_idstring
    Prospeo person_id from a prior Search Person result
  • prospeomcp_get_account_infoCheck your Prospeo account status — credits remaining, plan name, renewal date, and team size.Read-only

    Account Info

    Check your Prospeo account status — credits remaining, plan name, renewal date, and team size. Free endpoint, does not consume credits. Useful to verify the API key works or check remaining quota.

    Inputs

    This tool takes no inputs.

  • prospeomcp_search_companySearch Prospeo's company database using typed filters.Read-only

    Search Companies

    Search Prospeo's company database using typed filters. Returns up to 25 results per page (max 1000 pages). Costs 1 credit per page that returns results. WORKFLOW: (1) call search_suggestions first for any location/technology/industry/NAICS/SIC the user mentioned. (2) build filters. (3) pass any company_id from results to enrich_company for full profile (tech stack, attributes, job postings — not included in search). Available filters include firmographics (industry, headcount, technology, revenue, funding) and intent/event filters (company_news, company_key_execs, company_lookalike, company_icp, company_website_search, company_google_discovery) — see each filter's description for when to use it. At least one positive (include) filter is required.

    Inputs

    filtersobjectrequired
    Company search filters. At least one positive (include) filter is required. For values that can't be guessed (locations, technologies, industries, NAICS, SIC), call search_suggestions first.
    pageinteger
    Page number (1–1000). Each page returns up to 25 results.default 1
  • prospeomcp_search_personSearch Prospeo's professional database using typed filters.Read-only

    Search People

    Search Prospeo's professional database using typed filters. Returns up to 25 results per page (max 1000 pages). Costs 1 credit per page that returns results. WORKFLOW: (1) for any filter value the user mentioned by description (location, technology, industry, job title, NAICS/SIC code), call search_suggestions first to get the canonical string. (2) build filters mixing person fields (person_job_title, person_seniority, person_location_search) with company fields (company_industry, company_headcount_range, company_technology). (3) take each result's person_id and pass it to bulk_enrich_person in one call to reveal verified emails/mobiles. Each result includes person fields (name, title, location, linkedin_url) and a company summary. email and mobile are obfuscated previews in search results (revealed=false) with status (VERIFIED / UNVERIFIED / null) — use status to gauge coverage before enriching. At least one positive (include) filter is required.

    Inputs

    filtersobjectrequired
    Filter object combining person-specific filters and company filters. At least one positive (include) filter is required — exclude-only payloads are rejected for performance. For values that can't be guessed (locations, technologies, industries, NAICS, SIC, job titles), call search_suggestions first.
    pageinteger
    Page number (1–1000). Each page returns up to 25 results.default 1
  • prospeomcp_search_suggestionsResolve canonical filter values BEFORE building a search.Read-only

    Search Suggestions

    Resolve canonical filter values BEFORE building a search. Free — no credit cost. Use type='location' for person/company location filters, 'job_title' for job-title filters, 'technology' for company_technology, 'industry' for company_industry, 'naics' / 'sic' for the code filters. Locations and technologies in particular cannot be guessed — call this first or your search will return zero results.

    Inputs

    querystringrequired
    Search query (min 2 chars). Case-insensitive.
    typestringrequired
    Which value type to resolve. 'location' for person/company location filters; 'job_title' for person_job_title.include and company_job_posting_hiring_for; 'technology' for company_technology; 'industry' for company_industry; 'naics' / 'sic' return {code, label} pairs for company_naics / company_sics. NAICS results follow the NAICS 2022 revision — legacy codes like 5112 (NAICS 2017 Software Publishers, now 5132) may not match; prefer label-based queries (e.g. 'software') when unsure of the current code.one of locationjob_titletechnologyindustrynaicssic