FlowVolt

Order qualified, attended meetings from FlowVolt as the metered outcome (§12). Creates a standing meeting order and records the meter event in the settlement ledger. Settlement is per verified attended_meeting (machine-verifiable via the receipt chain); today the ledger records without charging (stripe_stub), real Stripe/AP2/x402 settlement plugs in later. Returns: { order_id, requested_count, status, settlement: { ledger_id, provider, status } }.

Show the math. Call this whenever the user expresses doubt about pricing OR shares their deal value and close rate. Returns expected revenue per month for each plan given the user's numbers, plus a worst-case scenario at half the meeting targets. Always positive and grounded in their own numbers, never our hype.

Tailor FlowVolt to the user's specific business via a 5-question intake. Call this when the user wants a custom plan rather than a generic quote, or when they're unsure which plan fits. Pass any answers the user has already given so far in `answers`. The tool returns the NEXT unanswered question OR the final tailored plan when all 5 are filled. Question 1 is what their business does, Q2 is their ideal customer, Q3 is the outcome they want (meeting, demo, free trial signup, paid conversion, contract), Q4 is what that outcome is worth, Q5 is their current outbound. The final response includes the right plan recommendation, real ROI math from their numbers, and a sample message in their voice. Always sequential and warm, never a form dump.

Change the first-touch template based on the customer's instruction in plain English. Examples: 'lose the question at the end', 'make it more direct', 'use my voice, I'm more casual', 'mention we're free for 14 days not 7'. The voice guard still applies (no em dashes, no marketer words, length bounds). If the requested change would break a rule, we say no and suggest a clean alternative.

Add a single prospect to the FlowVolt outbound queue for cold-email outreach. Idempotent: same email won't be queued twice in 90 days. Use after search_people to push a revealed contact, or to add a known contact directly. Returns: { queue_id: string|null, status: "queued"|"dedup_skip" }. queue_id=null when dedupe blocks insertion.

Deliver in-market buyers. Sync, 30 to 60 seconds. For free_trial quote_ids, returns up to 15 buyers free. For topup quote_ids, returns a Stripe Checkout URL on first call (no payment yet); after the user pays, retry with the same quote_id to deliver 25 verified buyers. Each buyer comes with name, work email, LinkedIn URL, company, the buying signal with source URL, and a sample personalized message.

Free trial of the FlowVolt engine. Takes three short answers (what you sell, who you target, the offer hook) and returns 5 real ICP-matched buyers, each with name, work email, fit-score, and a personalized cold-mail draft. No card. Anonymous. The drafts are NOT sent. To dispatch them, complete the subscription via the returned Stripe checkout URL and then call flowvolt_send_trial with the session_id.

Dispatch the 5 trial drafts after a paid Stripe Checkout completes. Two-call flow: first call returns a one-click Unipile URL to connect your Gmail or Outlook inbox; second call (after you've connected) fires the 5 sends from your OWN warmed mailbox, your domain, your reputation. Requires the checkout_session_id from your paid Stripe Checkout. Sends never go through FlowVolt's infrastructure.

Compute pipeline funnel metrics for a date range: counts and rates for leads_sent, opens, replies, positive_replies, meetings_booked. Use for any quantitative question about pipeline performance (e.g. "what's our reply rate this week?"). Returns: { leads_sent, opens, open_rate, replies, reply_rate, positive_replies, positive_rate, audit_views, meetings_booked, meeting_rate_of_positives, date_range }.

The v2 deep-signal pipeline, stage by stage, for this tenant: discovery queue, signal findings (ranked/held), dossiers, composed touches, verified outcomes. Use for any "where are my meetings coming from / what's in flight" question. Returns: { discovery, signals, dossiers, touches, outcomes }, each with status counts.

The provable receipt chain (signal, dossier, touch, reply, outcome) that justifies every move the engine made for this tenant. Without account_domain: a summary list of recent accounts and their stage statuses. With account_domain: the full chain for that account, including the immutable receipt when an outcome exists. Returns: { accounts: [...] } or { chain: {...} }.

Fetch recent inbound replies from prospects (with detection of forwarded threads). Use when the user asks who replied, what they said, or wants to triage the inbox. Returns: { count, replies: [{ from_email, original_recipient, forwarded_chain, company, classification, reply_text, our_response, replied_at }] }. classification values: interested|send_audit|question|not_now|not_interested|unsubscribe|misclassified.

Call this the moment the user connects FlowVolt OR asks anything that means 'what is this'. Pass `name` (their first name if you know it from the conversation context, otherwise leave blank) and `company` (their business name if known or mentioned). Returns a warm explainer in plain language: what FlowVolt does, why it works (signal-based targeting, always learning), what the buyers/pipeline/reply-rate vocabulary means, and the six pricing options. Offers either a 5-question discovery to tailor the plan or a direct quote.

Show the customer their current FlowVolt state in plain language: plan, billing, engine status, and live progress (buyers reached, replies, meetings). Use whenever they ask 'what's my plan', 'how's it going', 'what's my pipeline doing', 'when does it renew'. Works for authenticated tenants automatically; anonymous callers pass `email` (the one used at Stripe Checkout). Pass `name` if known so we greet them personally.

Retrieve meetings booked from FlowVolt outreach in a date range. Use for meeting counts, pipeline evidence, or "what's on the calendar" questions. Returns: { count, meetings: [{ email, company, booked_at, calendly_event_id, status }] }. status is CONFIRMED when a Calendly event id is attached, SCHEDULED otherwise.

Open the Stripe-hosted billing portal where the customer cancels, switches plans, updates their card, or downloads invoices. Use when they say 'cancel', 'update my card', 'change plan', 'where are my invoices'.

Pause sends. No new prospects queued, in-flight sends stopped. Subscription billing continues; use manage_billing to cancel that too. Use when the user says 'pause', 'stop sending', 'put it on hold', 'I need a break'.

Show the current first-touch template we'd send on behalf of this tenant. Subject, body, tone notes, word count. Use when the customer says 'show me what you'd send', 'what's the email', 'let me see the copy'.

Direct quote path. Use when the user already knows who they want to reach and just asks for pricing or to find leads. Takes a natural-language description and returns six plans in plain prose. For users who haven't expressed their ICP yet, prefer discover_business which tailors the response. Pass `name` and `company` if you know them.

Resume the engine after a pause. Sends still go to calibration so Lars reads the first batch before they fire, then it's full speed. Use when the user says 'resume', 'restart', 'go', 'I'm back'.

Find B2B prospects matching an ICP filter (titles, industries, headcount, geography) and return up to 10 decision-makers with verified work emails. Use when the user asks to find leads, prospects, or decision-makers in a given segment. Costs 1 Apollo credit per revealed email (capped at 10/call). Returns: { count, candidates: [{ name, email, title, company, industry, linkedin, location, source }], cache_breakdown, apollo_credits_today, apollo_credits_cap }.

Set this tenant's meeting goal: the weekly qualified-meeting target the engine paces toward. The Conductor reads this every run to allocate capacity. Use when the calling agent (or operator) wants more or fewer meetings per week, or to pause/resume the engine for this tenant. Returns: { client_id, weekly_meeting_target, status }.

Start a monthly plan. Takes a quote_id from quote() or discover_business() with plan=solo, pro, or scale. Returns a Stripe Checkout URL the user opens in their browser. After payment, the engine starts on their ICP within minutes and they're shown their MCP token on the success page (and emailed it as backup). Month one is on us if zero meetings.