Vibe Prospecting MCP connector

OAuth 2.1/DCRCRM & SalesMarketingAI

Connect to Vibe Prospecting by Explorium to build B2B lead lists, research companies and prospects, enrich contacts, and personalize outreach from your AI...

Vibe Prospecting MCP connector

Install the SDK
Section titled “Install the SDK”
- Node.js
- Python
Terminal window
1 npm install @scalekit-sdk/node
Terminal window
1 pip install scalekit
Full SDK reference: Node.js | Python
Set your credentials
Section titled “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>
```

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENV_URL,
6
  process.env.SCALEKIT_CLIENT_ID,
7
  process.env.SCALEKIT_CLIENT_SECRET,
8
)
9
const actions = scalekit.actions
10

11
const connector = 'vibeprospectingmcp'
12
const identifier = 'user_123'
13

14
// Generate an authorization link for the user
15
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
16
console.log('Authorize Vibe Prospecting MCP:', link)
17
process.stdout.write('Press Enter after authorizing...')
18
await new Promise(r => process.stdin.once('data', r))
19

20
// Make your first call
21
const result = await actions.executeTool({
22
  connector,
23
  identifier,
24
  toolName: 'vibeprospectingmcp_get_dataset',
25
  toolInput: { tool_reasoning: 'YOUR_TOOL_REASONING' },
26
})
27
console.log(result)

1
import os
2
from scalekit.client import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENV_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "vibeprospectingmcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Vibe Prospecting MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={"tool_reasoning":"YOUR_TOOL_REASONING"},
27
    tool_name="vibeprospectingmcp_get_dataset",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

What you can do

Connect this agent connector to let your agent:

Sample show — Present the final sample rows to the user from a fetch, enrich, or events exploration table
Plans show pricing — Show Vibe Prospecting credit package pricing in an interactive widget
Prospects match, enrich — Match specific individuals to get their Explorium prospect IDs
Business match, enrich — Get the Explorium business IDs from business name and/or domain in bulk
Get dataset — Load a previously exported dataset or list into a session for further analysis, prospecting, or exclusion — or list the user’s most recent datasets
Fetch prospects events, entities statistics, entities — Retrieves prospect-related events (role changes, company changes, job anniversaries) from the Explorium API in bulk

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.

vibeprospectingmcp_autocomplete#Autocomplete values for business filters based on a query. Supports fields: naics_category, linkedin_category, company_tech_stack_tech, job_title, business_intent_topics, city_region. Never use for fields not in this list. Prefer linkedin_category over naics_category unless the LinkedIn result is too broad. Do not call autocomplete for country or region codes — use ISO codes directly.4 params

Autocomplete values for business filters based on a query. Supports fields: naics_category, linkedin_category, company_tech_stack_tech, job_title, business_intent_topics, city_region. Never use for fields not in this list. Prefer linkedin_category over naics_category unless the LinkedIn result is too broad. Do not call autocomplete for country or region codes — use ISO codes directly.

NameTypeRequiredDescription

fieldstringrequiredThe field to autocomplete. Only use fields listed here. Never use autocomplete for a field not in this list.

querystringrequiredThe query to autocomplete

tool_reasoningstringrequiredThe original user query that prompted this workflow, in EXACT WORDS. Reuse the same wording across chained tool calls when the task is unchanged. Maximum 2000 characters.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. Reuse when continuing the same request; omit to create a new session.

vibeprospectingmcp_enrich_business#Add detailed information to companies from previous fetch-entities results. Supports enrichments including firmographics, technographics, funding, workforce trends, financial metrics, LinkedIn posts, website changes, and more. Returns a masked preview and a new table_name (no charge); use export-to-csv to retrieve all enriched rows. Use the new table_name for all downstream steps — the original fetch-entities table does not receive the enrichment columns.6 params

Add detailed information to companies from previous fetch-entities results. Supports enrichments including firmographics, technographics, funding, workforce trends, financial metrics, LinkedIn posts, website changes, and more. Returns a masked preview and a new table_name (no charge); use export-to-csv to retrieve all enriched rows. Use the new table_name for all downstream steps — the original fetch-entities table does not receive the enrichment columns.

NameTypeRequiredDescription

enrichmentsarrayrequiredList of enrichment types to run in parallel

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredTable name containing business data to enrich

estimate_costbooleanoptionalNo description.

parametersobjectoptionalNo description.

sample_sizenumberoptionalNumber of sample results to return in context

vibeprospectingmcp_enrich_prospects#Add contact details and profiles to people from previous fetch-entities results. Supports enrichments for professional/personal emails and phone numbers (enrich-prospects-contacts) and full profile details including work history and education (enrich-prospects-profiles). Returns a masked preview and a new table_name (no charge). Use the new table_name for all downstream steps — the original fetch-entities table does not receive enrichment columns.6 params

Add contact details and profiles to people from previous fetch-entities results. Supports enrichments for professional/personal emails and phone numbers (enrich-prospects-contacts) and full profile details including work history and education (enrich-prospects-profiles). Returns a masked preview and a new table_name (no charge). Use the new table_name for all downstream steps — the original fetch-entities table does not receive enrichment columns.

NameTypeRequiredDescription

enrichmentsarrayrequiredList of enrichment types to run in parallel

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredTable name containing prospect data to enrich

estimate_costbooleanoptionalNo description.

parametersobjectoptionalNo description.

sample_sizenumberoptionalNumber of sample results to return in context

vibeprospectingmcp_estimate_cost#Estimate the export cost in Explorium credits for a given table before exporting. Returns estimated cost, currency, a human-readable description, the table name, and a breakdown by row count and enrichment operations. Always show the cost estimate to the user and wait for explicit confirmation before calling export-to-csv. Note: show-sample already returns cost estimation fields, so this tool is only needed when a separate cost check is required.3 params

Estimate the export cost in Explorium credits for a given table before exporting. Returns estimated cost, currency, a human-readable description, the table name, and a breakdown by row count and enrichment operations. Always show the cost estimate to the user and wait for explicit confirmation before calling export-to-csv. Note: show-sample already returns cost estimation fields, so this tool is only needed when a separate cost check is required.

NameTypeRequiredDescription

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredName of the table to estimate cost for

vibeprospectingmcp_export_to_csv#Export your data to CSV and get a download link. Consumes credits. Only call this tool when the user has explicitly asked to export and has seen a cost estimate. Always wait for explicit user confirmation before exporting, regardless of credit balance. Exported entities are automatically added to the user's exclude list to prevent them from appearing in future searches.6 params

Export your data to CSV and get a download link. Consumes credits. Only call this tool when the user has explicitly asked to export and has seen a cost estimate. Always wait for explicit user confirmation before exporting, regardless of credit balance. Exported entities are automatically added to the user's exclude list to prevent them from appearing in future searches.

NameTypeRequiredDescription

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredName of the specific table to export

dataset_namestringoptionalDescriptive name for the dataset (10-80 chars, lowercase alphanumeric with underscores). If not provided, a random name will be generated. The final dataset name will be: {dataset_name}_{unique_id}.

exclude_keystringoptionalOptional. Pass the prior export dataset_id (ds- plus UUID) on the SAME table_name to skip rows already in that dataset. Use after a credit-limited partial export or when the user asks for additional rows.

limitintegeroptionalMaximum rows to materialize for this export (overrides workflow number_of_results). Without exclude_key: cap at limit rows from the original query. With exclude_key (prior export dataset_id): caps how many rows are fetched after excluding that dataset.

tool_reasoningstringoptionalThe ORIGINAL user query that started this workflow, in EXACT WORDS. Use the first message that led to this tool being called, NOT follow-up commands like 'export', 'yes', 'continue'. Maximum 2000 characters.

vibeprospectingmcp_fetch_businesses_events#Retrieves business-related events (funding rounds, new offices, partnerships, hiring signals, etc.) from the Explorium API in bulk. Requires a table_name and session_id from a prior fetch-entities call. Returns a masked preview and table_name at no charge; export-to-csv delivers the full dataset. Sample preview shows only up to 3 events per company — the full export contains significantly more data. For events related to role changes, use the prospects events tool instead.6 params

Retrieves business-related events (funding rounds, new offices, partnerships, hiring signals, etc.) from the Explorium API in bulk. Requires a table_name and session_id from a prior fetch-entities call. Returns a masked preview and table_name at no charge; export-to-csv delivers the full dataset. Sample preview shows only up to 3 events per company — the full export contains significantly more data. For events related to role changes, use the prospects events tool instead.

NameTypeRequiredDescription

event_typesarrayrequiredList of event types to fetch, max 10

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredTable name containing business data to get events for

estimate_costbooleanoptionalNo description.

sample_sizenumberoptionalNumber of sample results to return in context

timestamp_fromstringoptionalISO format datetime string or date in format YYYY-MM-DD (defaults to 3 months ago)

vibeprospectingmcp_fetch_entities#Find companies and/or prospects using any combination of filters (returns ~10 sample rows for exploration, no charge). Use entity_type 'prospects' when the request involves people in any way; use 'businesses' only when the request is purely about companies. Filters requiring autocomplete first: linkedin_category, naics_category, job_title, business_intent_topics, company_tech_stack_tech, city_region (USA cities). Make ONE comprehensive fetch call — multiple calls combining filters that could be merged are forbidden.9 params

Find companies and/or prospects using any combination of filters (returns ~10 sample rows for exploration, no charge). Use entity_type 'prospects' when the request involves people in any way; use 'businesses' only when the request is purely about companies. Filters requiring autocomplete first: linkedin_category, naics_category, job_title, business_intent_topics, company_tech_stack_tech, city_region (USA cities). Make ONE comprehensive fetch call — multiple calls combining filters that could be merged are forbidden.

NameTypeRequiredDescription

entity_typestringrequiredREQUIRED: The type of entity you want as final output. Use "businesses" for company data, "prospects" for people/contact data. This helps disambiguate when filters alone don't clearly indicate intent.

filtersobjectrequiredCombination of filters to narrow down results. All filter fields are optional. Filters requiring autocomplete first: linkedin_category, naics_category, job_title, business_intent_topics, company_tech_stack_tech, city_region (USA).

businesses_reference_tablestringoptionalOPTIONAL: Only use to REFINE prospects from a previous fetch-businesses result. For fresh searches, use company filters directly with entity_type: "prospects" instead. MUST be provided with a session_id.

estimate_costbooleanoptionalNo description.

exclude_keystringoptionalExclude key to avoid returning previously seen entities. Use 'prospects' or 'business' for the tenant-global exclude list, or pass a specific dataset_id from get-dataset or export-to-csv.

max_per_companynumberoptionalMaximum number of prospects to return per company. Only applicable for prospect queries. CRITICAL: DO NOT use unless explicitly requested by the user.

number_of_resultsnumberoptionalNumber of results to return. Defaults to 50 if not specified. Use the exact number requested by the user.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. Reuse when refining or continuing the same user request; omit to create a new session for a distinct new request.

vibeprospectingmcp_fetch_entities_statistics#Fetch aggregated insights into businesses or prospects by industry, revenue, employee count, job department, and geographic distribution. Use entity_type 'prospects' when the request involves prospects; use 'businesses' only for company-only stats. Filters requiring autocomplete first: linkedin_category, naics_category, job_title, business_intent_topics, company_tech_stack_tech. Country and region codes can be used directly without autocomplete.4 params

Fetch aggregated insights into businesses or prospects by industry, revenue, employee count, job department, and geographic distribution. Use entity_type 'prospects' when the request involves prospects; use 'businesses' only for company-only stats. Filters requiring autocomplete first: linkedin_category, naics_category, job_title, business_intent_topics, company_tech_stack_tech. Country and region codes can be used directly without autocomplete.

NameTypeRequiredDescription

entity_typestringrequiredREQUIRED: The type of entity you want statistics for. Use "businesses" for company stats, "prospects" for people/contact stats.

filtersobjectrequiredCombination of filters to scope the statistics query. All filter fields are optional.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. Reuse when refining or continuing the same request; omit to create a new session.

vibeprospectingmcp_fetch_prospects_events#Retrieves prospect-related events (role changes, company changes, job anniversaries) from the Explorium API in bulk. Requires a table_name and session_id from a prior fetch-entities call. Returns a masked preview and table_name at no charge; sample preview shows only up to 3 events per prospect. Must ask the user to confirm before calling when the prior fetch used event-related filters (unless the user already asked for event details in the same message).6 params

Retrieves prospect-related events (role changes, company changes, job anniversaries) from the Explorium API in bulk. Requires a table_name and session_id from a prior fetch-entities call. Returns a masked preview and table_name at no charge; sample preview shows only up to 3 events per prospect. Must ask the user to confirm before calling when the prior fetch used event-related filters (unless the user already asked for event details in the same message).

NameTypeRequiredDescription

event_typesarrayrequiredList of event types to fetch, max 10

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredTable name containing prospect data to get events for

estimate_costbooleanoptionalNo description.

sample_sizenumberoptionalNumber of sample results to return in context

timestamp_fromstringoptionalISO format datetime string or date in format YYYY-MM-DD (defaults to 3 months ago)

vibeprospectingmcp_get_dataset#Load a previously exported dataset or list into a session for further analysis, prospecting, or exclusion — or list the user's most recent datasets. Call with no dataset_id and no dataset_name to list up to 20 recent datasets. Provide at least one of dataset_id or dataset_name to load a specific dataset. If session_id is omitted, a new session is automatically created.4 params

Load a previously exported dataset or list into a session for further analysis, prospecting, or exclusion — or list the user's most recent datasets. Call with no dataset_id and no dataset_name to list up to 20 recent datasets. Provide at least one of dataset_id or dataset_name to load a specific dataset. If session_id is omitted, a new session is automatically created.

NameTypeRequiredDescription

dataset_idstringoptionalOptional. Dataset or list ID (starts with "ds-") to load directly. Takes priority over dataset_name. If neither dataset_name nor dataset_id is provided, returns a list of the user's most recent datasets.

dataset_namestringoptionalOptional. Dataset or list name to load by name search. If the value starts with "ds-", use dataset_id instead. If neither dataset_name nor dataset_id is provided, returns a list of the user's most recent datasets.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. If not provided, a new session is automatically created for the dataset.

vibeprospectingmcp_match_business#Get the Explorium business IDs from business name and/or domain in bulk. You can provide either name OR domain for each business, or both (recommended for better accuracy). If session_id is provided, results are stored for future reference; otherwise a new session_id is created and returned. Do NOT use when you already called fetch-entities for businesses (response contains business IDs) or when looking for general industry trends without specific companies.3 params

Get the Explorium business IDs from business name and/or domain in bulk. You can provide either name OR domain for each business, or both (recommended for better accuracy). If session_id is provided, results are stored for future reference; otherwise a new session_id is created and returned. Do NOT use when you already called fetch-entities for businesses (response contains business IDs) or when looking for general industry trends without specific companies.

NameTypeRequiredDescription

businesses_to_matcharrayrequiredList of businesses to match. Each entry requires name and/or domain. Up to 50 businesses per call.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. Reuse when refining or continuing the same request; omit to create a new session.

vibeprospectingmcp_match_prospects#Match specific individuals to get their Explorium prospect IDs. Requires email OR (full name + company name) for each prospect. Always prefer this over web search for questions about specific people. Results are stored in the session for future enrichment or export. Returns session_id in the response for future data retrieval.3 params

Match specific individuals to get their Explorium prospect IDs. Requires email OR (full name + company name) for each prospect. Always prefer this over web search for questions about specific people. Results are stored in the session for future enrichment or export. Returns session_id in the response for future data retrieval.

NameTypeRequiredDescription

prospects_to_matcharrayrequiredList of prospects to match. Each entry requires email OR (full_name + company_name). Up to 40 prospects per call.

session_idstringoptionalSession ID for tracking tool calls within the same user request context. Reuse when continuing the same request; omit to create a new session.

vibeprospectingmcp_show_pricing_plans#Show Vibe Prospecting credit package pricing in an interactive widget. Use when the user asks about pricing, cost, buying credits, packages, upgrading, or plans — or when a prior tool execution failed due to insufficient credits. All plans are one-time purchases (not subscriptions), and credits are valid for 365 days. If a prior export-to-csv response included a promotion, pass its promo_code_id and promotion_type.3 params

Show Vibe Prospecting credit package pricing in an interactive widget. Use when the user asks about pricing, cost, buying credits, packages, upgrading, or plans — or when a prior tool execution failed due to insufficient credits. All plans are one-time purchases (not subscriptions), and credits are valid for 365 days. If a prior export-to-csv response included a promotion, pass its promo_code_id and promotion_type.

NameTypeRequiredDescription

promotion_code_idstringoptionalOptional Stripe promotion code id (e.g. promo_code_id from export-to-csv tool execution).

promotion_typestringoptionalOptional promotion type. Currently can only be 'first_export'. Use it only when given a specific promotion code id from a previous export-to-csv tool execution with that type in the response.

vibeprospectingmcp_show_sample#Present the final sample rows to the user from a fetch, enrich, or events exploration table. Call this after each user turn's fetch/enrich/events work is finished. Charges 5 credits per exploration table (idempotent per table — duplicate calls for the same table_name do not charge again). Always call show-sample before presenting results to the user; do not ask for confirmation before calling it. This tool also returns export cost fields, so estimate-cost is not needed after show-sample for the same table.3 params

Present the final sample rows to the user from a fetch, enrich, or events exploration table. Call this after each user turn's fetch/enrich/events work is finished. Charges 5 credits per exploration table (idempotent per table — duplicate calls for the same table_name do not charge again). Always call show-sample before presenting results to the user; do not ask for confirmation before calling it. This tool also returns export cost fields, so estimate-cost is not needed after show-sample for the same table.

NameTypeRequiredDescription

session_idstringrequiredSession ID containing the data to process

table_namestringrequiredtable_name from a prior fetch/enrich/events exploration response. Do not invent this value.

Vibe Prospecting MCP connector

Vibe Prospecting MCP connector

Install the SDK

Set your credentials

Authorize and make your first call

What you can do

Tool list