Documentation / Reference

MCP Tools: Pipeline

Run pipelines, qualify companies, sync leads to outreach.

Technical reference, generated automatically from the live tool registry.

Pipeline

Run pipelines, qualify companies, sync leads to outreach

run_full_pipeline

action

Run the full GTM pipeline for a playbook: source → qualify → discover leads → enrich → personalize → sync to outreach. Runs in background by default — returns immediately with a run_id. Use get_pipeline_run_status to check progress. Set wait=true to block until completion.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
max_companiesnumberno
skip_enrichmentbooleanno
waitbooleanno

get_pipeline_run_status

read-only

Check the status of a background pipeline run started via run_full_pipeline. Returns running/complete/error status and results when finished.

ParameterTypeRequiredDescription
run_idstringyesThe run_id returned from run_full_pipeline

list_pipeline_runs

read-only

List recent background pipeline runs for this workspace (running, complete, and errored within the last hour).

No parameters.

run_company_pipeline

action

Run pipeline for a single company: research → qualify → discover leads → enrich → personalize → sync.

ParameterTypeRequiredDescription
company_idstringyesCompany ID
playbook_idstringyesPlaybook ID

qualify_companies

action

Qualify pending companies against playbook ICP. Returns qualification results.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
company_idsstring[]no
limitnumberno

discover_and_enrich_leads

action

Discover leads at a company and enrich with email/phone. Returns leads found.

ParameterTypeRequiredDescription
company_idstringyesCompany ID
playbook_idstringyesPlaybook ID
skip_enrichmentbooleanno

enrich_lead

action

Enrich a single lead with email and phone via the lead_enrichment step.

ParameterTypeRequiredDescription
lead_idstringyesLead ID

sync_leads_to_outreach

action

Sync approved leads to their outreach sequence (Email Outreach for email, LinkedIn Outreach for LinkedIn).

ParameterTypeRequiredDescription
lead_idsstring[]yesLead IDs to sync
sequence_idstringyesSequence ID

run_step

action

Run a specific pipeline step on one or more companies — like clicking a cell in the pipeline UI. Steps: research, qualification, solar_analysis, lead_discovery, lead_enrichment, copy_generation, outreach_sync, crm_sync.

ParameterTypeRequiredDescription
stepenum(qualification \solar_analysis \social_listening \
company_idsstring[]yesCompany IDs to run the step on
playbook_idstringyesPlaybook ID

run_column

action

Run a pipeline step on ALL companies that are ready for it — like running an entire column in the pipeline UI. Automatically picks companies in the right status for each step. E.g. run_column step=copy_generation runs copy gen on all “enriched” companies.

ParameterTypeRequiredDescription
stepenum(qualification \lead_discovery \lead_enrichment \
playbook_idstringyesPlaybook ID
limitnumberno

get_pipeline_overview

read-only

Get a count of companies in each pipeline column/status for a playbook — shows what needs to be run next.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID

run_next_step

action

Automatically run the next pipeline step for a company based on its current status. Like clicking “continue” — figures out what needs to happen next.

ParameterTypeRequiredDescription
company_idstringyesCompany ID
playbook_idstringyesPlaybook ID

reset_pipeline

destructive

Reset ALL companies in a playbook to fresh state. Clears pipeline logs, leads, scores, enrichment data. After reset, use run_pipeline_all to re-process everything.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID

run_pipeline_all

action

Run the pipeline on ALL companies in a playbook. Creates a batch and executes in the background. Smart-resume: skips steps that already succeeded. Use reset_pipeline first for a fresh run.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID

retry_failed_companies

action

Reset only companies stuck in qualification_status=failed (research error, enrichment crash, transient adapter outage) back to pending and optionally re-run the pipeline on them. Scoped to the playbook.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
runbooleanno

Pipeline Config

Configure pipeline steps, modules, and tool module settings per playbook

list_pipeline_modules

read-only

List all available pipeline modules that can be added to a playbook pipeline. Optional filter by module_type (e.g. source, qualify, discover, enrich, output). Returns slug, name, moduleType, requires, produces for each module.

ParameterTypeRequiredDescription
module_typestringno

get_playbook_pipeline

read-only

Get the current pipeline configuration for a playbook. Returns the ordered list of configured modules with their settings and enabled/disabled state, plus validation result.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID

set_playbook_pipeline

destructive

Set the FULL pipeline for a playbook. Takes an ordered array of module slugs with optional config. Validates the sequence first — if invalid, returns errors without saving. Replaces all existing pipeline config rows for this playbook.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
modulesobject[]yesOrdered array of pipeline modules

add_pipeline_module

action

Add a single module to an existing pipeline at a given position (0-indexed). Validates the resulting pipeline before saving.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
slugstringyesModule slug to add (e.g. “enrich:icp-check”)
positionnumberyes0-indexed position to insert at
configobjectno

remove_pipeline_module

destructive

Remove a module from the pipeline by position (0-indexed). Validates the resulting pipeline before saving.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
positionnumberyes0-indexed position of the module to remove

toggle_pipeline_module

action

Enable or disable a module in the pipeline without removing it. Disabled modules are skipped during pipeline execution.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
positionnumberyes0-indexed position of the module to toggle
enabledbooleanyesWhether the module should be enabled

configure_pipeline_steps

action

Configure pipeline steps for a playbook using simple step keys (pre_qualify, qualification, solar_analysis, lead_discovery, persona_qualification, lead_enrichment, copy_generation, outreach_sync, crm_sync). NOTE: qualification now does both research AND ICP scoring in one call (merged 2026-05-28). Set which steps are enabled and their config (mode, sources, model, run_conditions). This is the simplest way to set up a pipeline from scratch.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook ID
stepsobject[]yesPipeline steps with config

list_tool_modules

read-only

List all available tool modules with their enabled/disabled status for this workspace. Shows which capabilities are active.

ParameterTypeRequiredDescription
categorystringno

enable_tool_module

action

Enable a tool module for this workspace. Makes its tools available to the Command Center and agents.

ParameterTypeRequiredDescription
module_idstringyesModule ID to enable (e.g. “calendar”, “linkedin-sequences”)

disable_tool_module

action

Disable a tool module for this workspace. Its tools will no longer be available. Core modules cannot be disabled.

ParameterTypeRequiredDescription
module_idstringyesModule ID to disable

configure_tool_module

action

Set module-specific configuration for this workspace (e.g. default settings, provider preferences).

ParameterTypeRequiredDescription
module_idstringyesModule ID to configure
configobjectyesConfiguration key-value pairs to set

Leads

List, filter, approve, reject, bulk-manage, import leads

list_leads

read-only

List leads with optional filters (status, playbook, pagination).

ParameterTypeRequiredDescription
statusenum(pending \approved \contacted \
playbook_idstringno
limitnumberno
offsetnumberno

get_lead

read-only

Get full lead details including company and conversation history.

ParameterTypeRequiredDescription
lead_idstringyesLead ID

get_lead_counts

read-only

Get lead counts by status (funnel overview).

No parameters.

create_lead

action

Create a new lead manually.

ParameterTypeRequiredDescription
first_namestringyesFirst name
last_namestringyesLast name
emailstringno
job_titlestringno
company_namestringno
company_idstringno
linkedin_urlstringno
playbook_idstringno
phonestringno

update_lead

destructive

Update lead fields.

ParameterTypeRequiredDescription
lead_idstringyesLead ID
emailstringno
job_titlestringno
phonestringno
linkedin_urlstringno
statusenum(pending \approved \contacted \

approve_leads

action

Approve one or more leads for outreach.

ParameterTypeRequiredDescription
lead_idsstring[]yesLead IDs to approve

update_lead_status

destructive

Update lead status (e.g. mark as meeting_booked, not_interested).

ParameterTypeRequiredDescription
lead_idstringyesLead ID
statusenum(pending \approved \contacted \

update_lead_priority

destructive

Batch update priority scores for leads based on closed-loop optimization signals

ParameterTypeRequiredDescription
updatesobject[]yesList of lead IDs and their new priority scores

revert_lead

destructive

Undo AI-generated changes on a lead (enrichment, copy, variables). Reverts only AI-written fields, not manual edits.

ParameterTypeRequiredDescription
lead_idstringyes
fieldsenum(enrichment \copy \variables)[]

crm_push_leads

destructive

Push selected leads to the workspace CRM (CRM) with company data + conversation history. External side-effect is irreversible.

ParameterTypeRequiredDescription
lead_idsstring[]yes
crmenum(hubspot)no

enroll_preflight

read-only

Check prerequisites before enrolling a lead in a playbook. Returns blockers (missing credentials, missing sequence, blacklist) without mutating state.

ParameterTypeRequiredDescription
lead_idstringyes
playbook_idstringyes

bulk_lead_action

action

Perform bulk actions on leads: delete, move (to playbook), approve (with auto-enrollment), reject, or archive.

ParameterTypeRequiredDescription
lead_idsstring[]yesLead IDs to act on
actionenum(delete \move \approve \
target_playbook_idstringno

Blacklist

Manage domain/email blacklist entries

list_blacklist

read-only

List blacklist entries (blocked domains, emails, companies, persons, phones, LinkedIn profile URLs). Supports filtering by type and search. Valid types: domain, email, company, person, phone, linkedin_url.

ParameterTypeRequiredDescription
typeenum(domain \email \company \
searchstringno
limitnumberno
offsetnumberno

add_blacklist

action

Add entries to the blacklist. Supports single or batch add. Valid types: domain, email, company, person, phone, linkedin_url.

ParameterTypeRequiredDescription
entriesobject[]yesEntries to add

remove_blacklist

destructive

Remove entries from the blacklist by their IDs.

ParameterTypeRequiredDescription
idsstring[]yesBlacklist entry IDs to remove

Enrichment

Contact enrichment (email, phone), company enrichment (tech stack, signals), and email validation

enrich_contact

action

Find email and phone for a single contact via Enrichment.

Required integration: fullenrich

ParameterTypeRequiredDescription
first_namestringyesFirst name
last_namestringyesLast name
company_namestringyesCompany name
domainstringno
linkedin_urlstringno
include_phonebooleanno

bulk_enrich_contacts

action

Enrich multiple contacts in batch (email + optional phone). Max 100 per batch.

Required integration: fullenrich

ParameterTypeRequiredDescription
contactsobject[]yesArray of contacts to enrich
include_phonebooleanno

search_people_at_company

read-only

Search for people at a company by job title using Enrichment People Search.

Required integration: fullenrich

ParameterTypeRequiredDescription
company_namestringyesCompany name
domainstringno
job_titlesstring[]yesJob titles to search for
limitnumberno

validate_email

action

Validate an email address via Email Validation.

Required integration: zerobounce

ParameterTypeRequiredDescription
emailstringyesEmail to validate

validate_emails_bulk

action

Validate multiple emails in batch via Email Validation.

Required integration: zerobounce

ParameterTypeRequiredDescription
emailsstring[]yesEmails to validate

get_enrichment_credits

read-only

Check remaining Email Validation email validation credits.

Required integration: zerobounce

No parameters.

get_company_enrichment

read-only

Get enrichment details for a company: tech stack, recent news, buying signals, qualification data, and enrichment metadata.

ParameterTypeRequiredDescription
company_idstringno
domainstringno

list_company_buying_signals

read-only

List companies with detected buying signals. Useful for finding hot leads and high-intent companies.

ParameterTypeRequiredDescription
playbook_idstringno
limitnumberno

update_company_signals

destructive

Manually add or update buying signals for a company.

ParameterTypeRequiredDescription
company_idstringyesCompany ID
buying_signalsstring[]yesBuying signals to set (replaces existing)

Outreach Prep

Batch-prepare pending leads for sending: validate emails, hold invalid/role-based/off-ICP leads, regenerate link-free copy, mark ready

prepare_for_outreach

action

Batch-prepare a playbook’s pending leads for sending: validate emails (Email Validation), hold invalid/role-based/off-ICP leads (qualification_status=‘disqualified’), regenerate link-free copy for survivors, and mark them ready. Async with progress; idempotent — re-run to pick up new pending leads.

ParameterTypeRequiredDescription
playbook_idstringyesPlaybook whose pending leads to prepare
limitnumberno
enforce_regionbooleanno
hold_role_basedbooleanno
hold_catch_allbooleanno
hold_unknownbooleanno

Import

Import companies from CSV, CRM (CRM, CRM, CRM), or other sources

import_companies

action

Bulk import companies into a playbook. Provide an array of company objects with name and domain. Handles deduplication and triggers the pipeline automatically.

ParameterTypeRequiredDescription
playbook_idstringyesTarget playbook ID
companiesobject[]yesCompanies to import

revert_company

destructive

Undo AI-generated changes on a company (ICP scoring, enrichment, custom fields).

ParameterTypeRequiredDescription
company_idstringyes
fieldsenum(icp \enrichment \custom_fields)[]

crm_discover_tools

action

Discover what tools the connected CRM MCP server exposes. Shows available read tools organized by type (contacts, companies, search). Use this first to understand what data you can pull from the CRM.

No parameters.

crm_pull_data

action

Pull raw data from a CRM (contacts, companies, deals) for inspection or custom processing. Use crm_import_to_playbook to directly import into a playbook with dedup.

ParameterTypeRequiredDescription
tool_namestringyesThe CRM MCP tool name to call (from crm_discover_tools)
inputobjectno

crm_preview_import

action

Preview what CRM data would be imported into a playbook (dry run). Calls the CRM MCP server to pull contacts/companies, then checks for duplicates against existing records. Does NOT write anything.

ParameterTypeRequiredDescription
playbook_idstringyesTarget playbook ID
import_typeenum(contacts \companies \both)
tool_namestringno
tool_inputobjectno

crm_import_to_playbook

action

Import contacts and/or companies from the connected CRM MCP server into a playbook. Reads data via MCP (never writes to CRM), deduplicates against existing records, and creates new companies/leads. Triggers the pipeline automatically. Use crm_discover_tools first to find the right tool, then crm_preview_import to dry run.

ParameterTypeRequiredDescription
playbook_idstringyesTarget playbook ID
import_typeenum(contacts \companies \both)
tool_namestringno
tool_inputobjectno
auto_pipelinebooleanno

crm_import_history

action

View past CRM import runs for this workspace.

ParameterTypeRequiredDescription
limitnumberno