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
- OAuth app
- Your own Prospeo 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 Prospeo MCP connection
In AgentKit > Connections, create a Prospeo 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
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.
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 = 'prospeomcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'prospeomcp_enrich_company',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 = "prospeomcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Prospeo MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="prospeomcp_enrich_company",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_toolprospeomcp_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-onlyBulk 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-onlyBulk 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-onlyEnrich 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-onlyEnrich 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-onlyAccount 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-onlySearch 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-onlySearch 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-onlySearch 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
No tools match.