Tool reference
The VibeSell MCP server exposes 38 tools. Every page of this reference is
generated from the server’s own catalog: the description the model reads, the input schema and the
output schema are exactly what tools/list returns.
How to read the badges
Section titled “How to read the badges”| Badge | Meaning |
|---|---|
| Read · mcp | Reads only. Every connection can call it. |
| Act · mcp:act | Saves or prepares something in the workspace. Needs the mcp:act scope. |
| Approval card | Does not act: opens a card that only the user’s click runs. |
| Irreversible | Once approved and run, it cannot be undone. |
| Asks the user | Returns a question for the user, then takes their answer back. |
| Opens at: … | Refused until the workspace reaches that step. |
| 30 calls / 10 min | Rate-limited per connection, because it calls a provider. |
| Calls a provider | Reaches the lead provider, Instantly or Stripe, not only VibeSell. |
| Idempotent | Two identical calls give the same result. |
Workspace
Section titled “Workspace”Where the workspace stands, what waits for the user, and what VibeSell should remember.
get_workspace_contextRead the VibeSell workspaceThe first call of a conversation. It says which step of the journey the workspace is on and everything already on record: the offer, the target and its filters, the playbook, the sizing, the sending domains, the sequences, the campaign, the lead credits and the latest decisions.Read · mcplist_pending_approvalsList pending approvalsLists the approval cards waiting for the user's decision — a lead import, a domain order, a plan change, a campaign launch, stop or resume — with what each would do and when it expires.Read · mcprememberRemember a factKeeps one lasting fact about the user's business or preferences in the workspace, for VibeSell's own agent and for later conversations.Act · mcp:act
Offer & target
Section titled “Offer & target”What the user sells, who they sell to, and the playbook that frames the campaign.
save_offerSave the offerSaves what the user sells: the product, the problem it solves, the proof (traction, logos, results) and the constraints. It replaces the offer on record.Act · mcp:actsave_targetSave the targetSaves the ideal customer profile (ICP): the segment, the company profile, the champion who answers, the trigger that makes them answer now, and who to exclude.Act · mcp:actsave_target_filtersSave the target's lead filtersSaves the lead filters every search of the target starts from: countries and places, job titles, seniority, departments, headcount, industries, keywords, technologies, funding and more.Act · mcp:actconfirm_targetConfirm the targetRecords the user's yes to their target, quoted in their own words, once they have seen real people of that target. It opens the plan step.Act · mcp:actsave_playbookSave the playbookSaves the go-to-market playbook: the messaging angles, the cadence — three emails, sent on days 0, 3 and 7 — and the number of meetings a month the user aims at.Act · mcp:act
Count and preview the B2B leads a target returns, then import them on the user's click.
estimate_lead_poolCount matching leadsCounts how many B2B leads VibeSell's lead provider holds for a target — free, nobody is imported. Filters left out are taken from the target saved in the workspace.Read · mcp30 calls / 10 minpreview_lead_samplePreview matching leadsShows up to 10 real people a target returns — name, job title, company, location, LinkedIn — without their email addresses. Free, nobody is imported.Read · mcp30 calls / 10 minimport_leadsImport leadsPrepares the import of the leads a target returns, with their email addresses, into a named batch. It opens an approval card: only the user's click imports, and it spends one lead credit per lead asked for.Act · mcp:actApproval cardIrreversible
Plan & billing
Section titled “Plan & billing”Size the campaign, pick the plan that carries it, and pay on Stripe.
estimate_campaign_planEstimate a campaignTurns a number of contacts, a horizon and a sending calendar into a campaign scenario: total emails, new people per sending day, peak emails per day, the mailboxes and domains it needs, and the smallest plan that carries it.Read · mcpsize_sending_capacitySize the sending capacityComputes and saves the sending fleet the campaign needs — mailboxes, domains, reserve — from the peak emails per day that estimate_campaign_plan returned, with the same contacts, horizon and calendar.Act · mcp:actconfirm_sizingConfirm the sizingRecords the user's yes, quoted in their own words, to the sending capacity on record, once they saw its figures.Act · mcp:actget_plans_and_billingRead plans and billingReads the plans on sale — monthly price, emails and lead credits per month, sending domains and mailboxes included — the plan VibeSell recommends for the sizing, the workspace's subscription and its lead credits left.Read · mcpstart_checkoutOpen the plan payment pageOpens the secure Stripe payment page for a plan and returns its link. The user opens it and pays there; nothing is charged before.Act · mcp:act30 calls / 10 minupgrade_planMove up to a bigger planMoves the workspace up to a bigger plan. It opens an approval card that states the plan, its price, its credits and its fleet; only the user's click moves them, charged today.Act · mcp:actApproval cardIrreversibleOpens at: Setting up the sending infrastructureopen_billing_portalOpen the billing pageReturns the link to the user's billing page at Stripe, where they change their card, read their invoices or cancel. Nothing changes from this call.Act · mcp:act30 calls / 10 min
Sending setup
Section titled “Sending setup”Choose where the emails come from, keep the domains, order them and warm the mailboxes up.
get_sending_setupRead the sending setupReads the sending infrastructure: the domains, the mailboxes on each, where every mailbox's warmup stands and its score, and the domains kept but not bought yet.Read · mcpchoose_sending_sourceChoose where the emails come fromAsks the user where their emails come from: domains already warmed (they start sooner, without their brand's name) or names of their own (their brand, after a warmup). It returns the question; the assistant calls it again with the user's answer.Act · mcp:actAsks the userOpens at: Target confirmed, choosing a plan30 calls / 10 minlist_warmed_domainsList already-warmed domainsReads the domains VibeSell's email provider holds already warmed today, ready to send sooner than a new domain. The shelf rotates every day; reading keeps nothing.Read · mcpOpens at: Target confirmed, choosing a plan30 calls / 10 mincheck_domainsCheck sending domainsChecks which candidate sending domains can really be set up, and sizes the mailboxes on them, without buying or reserving anything.Read · mcp30 calls / 10 minpropose_domainsPropose sending domainsFor names of the user's own: checks candidate .com domains, sizes them, and shows the user the whole setup — the names and the addresses on them — for them to keep. Keeping names buys nothing.Act · mcp:actAsks the userOpens at: Target confirmed, choosing a plan30 calls / 10 minpropose_warmed_domainsPick already-warmed domainsFor domains already warmed: shows the user today's shelf, closest to their brand first, and keeps the domain they pick. Keeping one buys nothing.Act · mcp:actAsks the userOpens at: Target confirmed, choosing a plan30 calls / 10 minorder_sending_setupOrder the sending setupPrepares the purchase of exactly the domains and mailboxes the user kept. It opens an approval card: only the user's click, on the card or in VibeSell, places the order.Act · mcp:actApproval cardIrreversiblestart_warmupStart the warmupStarts warming up the mailboxes that were delivered and are not warming yet. Nothing is sent to prospects: the warmup builds the mailboxes' reputation first.Act · mcp:act30 calls / 10 min
Email sequence
Section titled “Email sequence”Write the three emails with the user, one at a time, then save and approve them.
check_first_emailCheck a first emailChecks the first email of a sequence against VibeSell's blocking rule: no link, no image, no tracking pixel, and no personalisation variable off the catalogue. It checks only.Read · mcpOpens at: Target confirmed, choosing a planpropose_emailShow an email of the sequenceShows the user one email of their 3-email sequence and lets them settle it. For every change they ask for, the assistant rewrites that same email and calls it again with the same position, then moves to the next one.Act · mcp:actAsks the userOpens at: Target confirmed, choosing a plansave_sequenceSave the sequenceSaves the sequence once the user settled its 3 emails one by one with propose_email: it records exactly what they settled, under the name given. Nothing is sent.Act · mcp:actOpens at: Target confirmed, choosing a planapprove_sequenceRecord the yes to the sequenceRecords the user's yes, quoted in their own words, to the sequence saved under this name. Nothing is sent: the campaign launches only on its own approval card.Act · mcp:actOpens at: Target confirmed, choosing a plan
Campaign
Section titled “Campaign”Prepare the campaign, launch it on the user's click, follow it and read the replies.
stage_campaignPrepare the campaignCreates the campaign at the email provider from the approved sequence, as a draft: it sends nothing and is not active. Until it is launched, its dates can still change.Act · mcp:actOpens at: Setting up the sending infrastructure30 calls / 10 minget_campaignRead the campaignReads the campaign: its state, its dates and the provider's counters — sent, replies, opens, bounces, and when they were measured — and, once the sending setup exists, the four launch figures the user confirms before a launch.Read · mcplaunch_campaignLaunch the campaignLaunches the campaign stage_campaign prepared: emails then go out in the user's name. It opens an approval card; only the user's click, on the card or in VibeSell, launches.Act · mcp:actApproval cardIrreversibleOpens at: Setting up the sending infrastructurestop_campaignStop the campaign for goodStops the live campaign for good: not one more email goes out under it, and it never resumes. It opens an approval card; only the user's click stops it.Act · mcp:actApproval cardIrreversibleOpens at: Setting up the sending infrastructureresume_campaignResume the campaignSends a paused campaign out again, from where it stopped. It opens an approval card; only the user's click resumes it.Act · mcp:actApproval cardIrreversibleOpens at: Setting up the sending infrastructurelist_repliesList prospect repliesLists the latest replies prospects sent to the user's campaigns, most recent first: who replied, the subject, a snippet and when.Read · mcp
Support & cards
Section titled “Support & cards”Write to the VibeSell team, and the tool only the card calls.
contact_supportWrite to the VibeSell teamSends a message to the VibeSell team — real people — on the user's behalf. The team answers in VibeSell's support chat and by email, never in the conversation.Act · mcp:actdecide_approvalDecide an approval cardApproves or rejects an approval card. Called by the VibeSell card in Claude when the user clicks Approve or Reject — hidden from the model, and given to no other host.Act · mcp:actCard only