MCP, référence des tools

Provision a complete Kernel client workspace: workspace + admin user + Stripe Connect onboarding link + seed data + onboarding email. Returns the new workspace details. Idempotent on slug.

Archive workspace cleanly: dry-run export, cancel Stripe subscription, soft-archive in DB, notify owner. Multi-step with partial-failure surfacing.

List all workspaces with billing + member count + last activity. Filter by status (active/archived/past_due/comped/all), plan, or text query on name/slug.

Get full workspace detail by slug: owner, billing, Stripe Connect, domains, theme, member count.

List workspace members. If workspace_id is provided, scoped to that workspace; otherwise returns all members across workspaces.

Get a member by user_id + workspace_id, with profile data joined.

List recent kernel_activity entries across or within a workspace. since: ISO date (default last 24h).

Aggregate billing metrics across all workspaces: MRR, ARR, active subscriptions count, past_due count, comped count.

List custom domains across workspaces.

List active workspace themes.

List per-workspace integrations (Stripe Connect, Google, Meta, LinkedIn, TikTok).

Aggregate system health: pending Apify, failed studio publish, pending JIT approvals, recent error count.

List all billing plans (id, name, monthly_price_cents, currency).

List Billing Accounts (1 user → 1 BA → N workspaces). Each BA owns one Stripe customer + card and may pay for multiple workspaces. Filter by has_card (BAs with a Stripe customer attached) or text query on owner email.

Get a Billing Account by id or by owner_user_id. Returns the BA row + the Stripe payment method (brand/last4/exp) + every workspace billed by this BA with plan + subscription status.

List signups in the waitlist (status, source, created_at).

Cross-workspace text search across workspaces, members, contacts (top 5 of each).

Create a new workspace via create_workspace_for_owner_v2_with_domains RPC. Requires existing owner user_id.

Update workspace name, brand_color, icon_url, logo_url.

Change the billing plan for a workspace (updates workspaces.plan only; Stripe subscription change is separate).

Invite an existing user as a member of a workspace.

Change a member role within a workspace.

Set a global platform feature flag (Hypervisor-scoped). Affects ALL workspaces.

Mark a workspace integration as connected (stores credentials elsewhere — this only flips status).

Add a custom domain to a workspace (unverified until DNS check passes).

Soft-archive a workspace (sets archived_at). Reversible. Stripe subscription stays active until manually cancelled.

HARD delete a workspace via cascade. Irreversible. Use archive_workspace first.

Remove a member from a workspace. Their auth.user row is preserved.

Hard-delete kernel_activity rows older than the given ISO date. Cannot be undone.

Force-mark a workspace billing as cancelled (workspace_billing.stripe_subscription_status = canceled). Stripe must be cancelled separately.

Revoke an MCP token by id. Sets revoked_at. Subsequent calls return 401.

Enqueue a webhook replay for a workspace + provider (Stripe/Meta/...).

Cross-workspace media library usage (count, archived, bytes, AI generated, quota, last upload).

List media items with zero recorded usage older than N days. Sorted by size desc.

Set storage_quota_bytes on a workspace. Pass null to remove the quota (unlimited).

Hard-delete all media_items + storage objects archived more than N days ago for a given workspace. Irreversible.

List Ads campaigns.

Get performance metrics for an Ads campaign (spend, impressions, clicks, leads).

End-to-end lead-quality funnel for the workspace ads over a configurable window. Returns the aggregated counts at each step: leads submitted, calls booked, contacts who paid, and total revenue in cents. Lets an agent answer "what's my ads ROI" without poking at each table.

List multi-platform launch groups. Each launch fanned a single brief into 2-4 platform campaigns. Returns the launch_group_id, top-level name, abstract objective, platform count, and total daily budget across platforms.

Get a single multi-platform launch group with its sub-campaigns + 7-day aggregated metrics (impressions, clicks, spend, conversions) across all platforms.

Update Ads campaign fields.

Pause an Ads campaign.

Resume a paused Ads campaign.

Delete an Ads campaign.

Publish all approved Studio drafts to the requested channels (LinkedIn / TikTok / Instagram / YouTube). Limits per channel. Continues on partial failure and returns per-channel breakdown.

Process an inbound lead (LinkedIn URL or email): enrich via Apollo + Apify, upsert contact, create opportunity deal, run strategic audit, enroll in welcome sequence. Continues on best-effort failures (e.g., Apify timeout).

Generate + send recurring monthly invoices for all active retainer clients in a workspace. Idempotent on (workspace_id, billing_month). dry_run=true returns the list without creating invoices.

Send the audit results summary to a contact via email + log in 360 timeline.

For each overdue invoice : classify severity (1=light, 2=medium, 3=collections), pick template, send relance email.

Enrich contacts in bulk (Apify queue + Apollo). Filter by lifecycle_stage or list of ids.

Re-enqueue failed inbox_outbound_messages for retry (with exponential backoff schedule).

Aggregate yesterday : new contacts/deals/publications/payments/inbox. Returns markdown briefing.

Draft a DM in the user's voice profile (from voice_corpus) and send via inbox.

Cross-channel business summary over a window: ads spend + lead funnel (leads → calls → revenue) + booking outcomes + total revenue. Returns derived ratios (CPL, CAC, close rate, ROAS, blended ROI). The one-call tool to answer 'comment tourne le business ce mois'.

List API keys (fos_sk_live_...) for the current workspace. Returns metadata only — plaintext tokens are never readable after creation.

Create a long-lived API key for the current workspace. The plaintext token is returned ONCE in this response — store it immediately. Scopes default to ["read:*"]; pass ["*"] for full access.

Revoke an API key by id. Sets revoked_at = now. Subsequent calls with the revoked token return 401. Idempotent.

Get the current Kernel SaaS subscription state for this workspace: plan, status, trial_end, period end, cancel_at_period_end.

Get current-period usage summary (service, included quota, used, estimated overage cost) for this workspace.

Get the Billing Account paying for this workspace (1 user → 1 BA → N workspaces). Returns owner, Stripe customer, payment method (brand/last4/exp). The cross-workspace list of workspaces billed by the same BA is only returned to the BA owner (viewer_is_owner=true); guests see only the current workspace.

Create a Stripe Checkout session to upgrade this workspace to Pro (14-day trial, CB required). Returns the hosted Checkout URL — open it in a browser to complete the payment.

Open a Stripe Customer Portal session for this workspace (update card, change plan, cancel). Returns the portal URL.

Open a Stripe Customer Portal session for the current user's Billing Account (cross-workspace : every subscription paid by the same card is manageable from one portal). Use this when the user wants to update their card once for all workspaces they own.

Returns revenue attribution for bookings over a period: total bookings, completed, cancelled, no-show, attributed revenue from contacts who had a booking + a succeeded transaction in the window. The killer business metric for a freelance dev who lives on calls → sales.

List bookable event types in the workspace.

List bookings (filterable by status, since).

Paginated detailed list of bookings with invitee name / email / timezone / linked event type / host. Use this when the simple list does not give enough context.

Update a booking event type (name, duration, active state).

Save the workspace's design system in one call: vibe preset + accent color + typography + radius + density. Compiles the full token bundle (color/font/radius/shadow + layout) and writes it to workspace_theme. Mirrors the accent into workspaces.brand_color.

List contacts in the current workspace, filterable by lifecycle_stage / source / text query.

Get a contact by id (must belong to current workspace).

Prospect 360 view: contact + recent conversations + bookings + audits + deals + payments.

Search contacts by email/name/linkedin substring.

Lists contacts who paid in the period, sorted by total amount desc. Joins prospects.email with transactions.email to recover the contact_id when present. Useful for an agent answering 'qui m'a acheté' or for triggering follow-up workflows.

Create or update a contact (by id, email, or linkedin_url).

Queue an Apify enrichment for a contact (LinkedIn scrape) + Apollo lookup.

Add a tag to a contact.

Hard-delete a contact and all related data. Irreversible.

List Fathom conversation transcripts.

Get full transcript content by id.

Add a note to a conversation transcript.

List Counsel quotes (devis).

List Counsel invoices (factures).

Total revenue from succeeded transactions over a window. Breaks down by week and gives the top contributing customers (email + total). Lets an agent answer 'combien j'ai encaissé ce mois' in one call.

Create a Counsel quote (devis).

Send a Counsel quote to the contact (status → sent).

Create a Counsel invoice (facture).

Send a Counsel invoice (status → sent).

Cancel a Counsel invoice (status → cancelled).

Refund a Counsel invoice payment via Stripe.

List CRM segments in the current workspace.

Get a CRM segment with its member prospects.

Create a new CRM segment (manual membership).

Add contacts to a CRM segment (idempotent — duplicates ignored).

Remove contacts from a CRM segment.

Delete a CRM segment (membership rows cascade).

List deals in the current workspace, filterable by stage.

Get a deal by id.

Create a new deal for a contact.

Update a deal (any field).

Move a deal to a new pipeline stage.

Delete a deal.

List every system email template (transactional + marketing) merged with this workspace's overrides. Shows key, label, category, whether it is customised, and whether it is enabled.

Get one effective email template (subject + HTML body, override or registry default) by key, optionally for a locale (fr/en).

List the workspace email campaigns with their status and headline stats (enrolled/sent/opened/replied).

Get one email campaign by id with its full stats and audience rules.

Create or update this workspace's override of an email template. Subject + bodyHtml may use {{variable}} placeholders (see email.templates.get for the allowed variables). Set enabled=false to stop sending this email entirely.

Remove this workspace's override of a template (for a locale), reverting to the registry default.

Render an email template with the provided sample variables and send it to a test address. Uses the workspace verified sender.

Create a DRAFT email campaign (no emails are sent). Pick an existing outbound sequence and optional audience rules. Use email.campaigns.launch to enroll the audience and start sending.

Pause, resume, or finish a campaign. action='pause' (active→paused), 'resume' (paused→active), 'done' (active|paused→done). The outbound runner checks status before each send.

Activate a campaign and enroll the matching audience into its outbound sequence. REAL emails will be sent by the outbound runner. Idempotent: re-running enrolls newly matching prospects. Requires approval.

List the resolved entitlements (modules, features, limits) for this workspace based on its current plan + comped state.

Check whether the workspace can access a feature (module.* or feature.*). Returns allowed + reason + required_plan when denied.

List Inbox conversation threads (DMs / comments).

Get the per-channel DM agent mode (off | suggested | auto) for Instagram, WhatsApp, LinkedIn, Messenger. LinkedIn 'auto' is forbidden (TOS) and always reported as 'suggested' or 'off'. Also returns the framework, voice prompt, and booking config. Scoped to the calling workspace — returns defaults (all 'off') if no settings row exists for this workspace yet.

Send a direct message reply in an Inbox thread.

Set the DM agent mode for a single channel (instagram_dm | whatsapp | linkedin | messenger). Modes: off | suggested | auto. LinkedIn 'auto' is rejected (TOS Microsoft — risk of account ban) and clamped to 'suggested'. The legacy global dm_agent_mode is kept in sync as max(IG/WA/Messenger). Scoped to the calling workspace — refuses if no settings row exists for this workspace yet.

Self-introspection : returns the catalog of all MCP tools this workspace can call, optionally filtered by module prefix or tier. Useful when an agent needs to discover what actions are available before planning a multi-step workflow.

List media items in the current workspace with optional filters (kind, collection, tags, source). Paginated by created_at cursor.

Full-text search across alt_text, caption, and generation_prompt. Same filters as media.list.

Get a single media item with a fresh signed URL (TTL 1h) or public URL for public assets.

Return parents (refs used to generate this image) and children (images generated from it).

List entities (pages, drafts, ad creatives, etc.) that reference this media item.

Upload a media item to the workspace library from base64 data. Auto-dedup on checksum. Returns the persisted row.

Add/remove tags, change collection, update alt-text or caption on a media item.

Record that an entity (page, draft, creative, …) references this media item. Idempotent on (media, entity, field).

Soft-archive a media item (sets archived_at). Reversible.

Hard-delete a media item (DB row + storage bytes). Irreversible. Requires JIT approval.

Snapshot of the current members-app config for the workspace: active domain (kind=members), count of enabled features, count of menu items.

Full list of member-app feature toggles (registry + workspace override). Each entry: key, label, href, default_enabled, enabled.

List the custom menu items configured for the member app navigation (handle="members"). Returns id, label, url, position, target.

Enable or disable a member-app feature for the workspace. Stores an override only when it differs from the registry default (otherwise the row is removed).

Append a new menu entry to the member-app navigation. Auto-positions at the end.

Delete a menu item by id (must belong to the current workspace).

Set the theme mode used by the member app: light, dark, or auto.

List CMS pages for this workspace.

List the curated page templates available for pages.create_from_template (id, name, description, suggested slug/title, block count).

Create a new CMS page in draft status.

Publish a CMS page (status → published, published_at = now).

Create a new draft page from one of the 5 curated templates (landing-coaching, about, pricing-3-tiers, contact, blog-post). Returns the new page id + blocks_count. Use pages.list_templates first to see available ids.

Create a new draft page by asking Claude to generate 6-12 blocks from a natural-language prompt. The same generator the editor Mode IA uses. Returns the new page id + blocks_count.

Delete a CMS page.

List products / offers in the workspace (optionally filter by active state).

Get a single product with its detail counters (modules, files, active purchases).

List downloadable files attached to a product.

Activate or deactivate (archive) a product.

List curriculum modules for a product (programme).

List lessons inside a curriculum module.

Publish or unpublish a curriculum module.

Publish or unpublish a curriculum lesson.

List Studio drafts (content pieces). Filter by status / target_platform.

Get a Studio draft by id (full content).

List Studio publications (drafts that have been scheduled or already pushed to a channel). Each row carries the scheduled_at / published_at / publish_error fields so an agent can audit what is live vs queued vs failed.

List Studio ideas (upstream of drafts). Each idea has a title, hook, angle, status and score. Useful when a content agent needs the next batch of inspirations to turn into drafts.

List SEO briefs (keyword + search intent + target word count). Used by content agents to plan articles aligned with the workspace SEO strategy.

Check whether a draft is approved for autopilot publishing, and by whom / when. Returns null if the draft does not exist or is not yet reviewed.

Resolve where a draft comes from : the competitor post, decoded pattern, and / or source draft that inspired it. Helps an agent retrace why a draft was generated before iterating.

Latest virality score for a Studio entity (draft, idea, publication). Returns the Gemini-computed predicted score plus the reasoning breakdown.

List inspiration packs (competitor post + decoded structure) available for the workspace to remix into new drafts.

Create a new Studio draft.

Update Studio draft fields.

Mark a Studio draft as approved-for-publish (publish_approved_at = now).

Revoke the publish approval on a Studio draft. Use this when an agent or the user spots a problem after approval and wants to block the next autopilot cycle.

Move a Studio draft to the archive (soft-hide from default lists). Reversible : the row stays in DB. Prefer this to delete unless the draft is junk.

Archive a Studio idea so it stops appearing in the active ideation pipeline. Reversible.

Delete a Studio draft.

Delete a Studio publication record (channel push history). Does not retract anything from the actual channel ; only removes the row from the workspace ledger.

List workspace team members (workspace_members + profile join). Each row carries user_id, role (owner / admin / staff / member), status (active / invited / suspended), joined_at.

Get a single workspace member with their profile (display name, avatar, email). Returns null if the user is not a member of the workspace.

Workspace audit log : who did what (login, role change, integration connect, etc.). Filter by event type or recency.

List third-party integrations connected to the workspace (Stripe, Google, Meta, LinkedIn, TikTok, etc.) with their connection state.

List recent voice calls in the current workspace. Returns id, direction, status, duration, prospect_id, disposition slug, created_at.

Get the full detail of a single voice call: call row, recording metadata, transcript summary, segments, score (if Tier 3 enabled).

List call lists in the current workspace with progress counts (total / completed / positive).

Pre-create a voice_calls row so a client (browser dialer or AI Voice Agent) can initiate a call. Returns the callId + caller-id E.164. Does NOT actually dial — the dialing is done by the client via Twilio Voice JS SDK or by the AI Voice Agent provider.

Enrich a prospect (or arbitrary contact data) with phone numbers via Dropcontact. Optionally writes the best phone back to the prospects row when prospect_id is provided. Costs 1 Dropcontact credit per row enriched.

Add a phone number to the workspace Do-Not-Call list. The number is blocked pre-dial across the queue runner, MCP voice.start_call, and AI Voice Agent campaigns.

List webinars in the workspace (featured first, then by scheduled date).

Get a single webinar by id.

Mark a webinar as the featured one (unfeatures the others).

List Workbench tasks.

List Workbench projects.

List Workbench milestones with progress + due date. Useful when an agent needs the next deliverables on a project before assigning new tasks.

Workbench cockpit KPIs : tasks done in the last 7d (vs prior 7d), currently open / overdue / blocked counts, and the daily completion sparkline.

List the tasks currently assigned to the caller and still open (todo / in_progress / blocked). The user "focus list" — what the operator should do today.

List active projects with their cockpit data (color, deadline, owner, status). Trimmed to what the dashboard widget shows.

Team workload heatmap : open task count per assignee per day for the next ~14 days. Used to spot overloads before assigning new work.

Recent task / project / milestone events in the Workbench audit log (creation, status change, assignment, delete) over the last 24 hours.

Create a new Workbench task.

Update a Workbench task.

Assign a Workbench task to a user.

Quick status change on a Workbench task (todo / in_progress / blocked / done / cancelled). Auto-sets completed_at when status becomes done, clears it otherwise. Cheaper than the full update tool when only the status changes.

Create a follow-up task linked to another entity (e.g. after a Voice call : a task linked to the prospect with a due date and priority).

Delete a Workbench task.