io.github.setluca/luca-mcp

Create or update a custom lead field definition. Luca operation: POST /api/leads/field-definitions Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Get a lead's full timeline and notes. Luca operation: GET /api/leads/{id} Required scopes: leads:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Attach a verified or claimed identity to a lead. Luca operation: POST /api/leads/{id}/identities Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Apply a mapped lead import with consent evidence. Luca operation: POST /api/leads/imports/apply Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Preview a mapped CSV lead import before applying it. Luca operation: POST /api/leads/imports/preview Required scopes: leads:read Required capability: draft; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List leads. Query supports limit, cursor, channel, and q according to Luca OpenAPI. Luca operation: GET /api/leads Required scopes: leads:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Append a coach note to a lead. Body requires body. Luca operation: POST /api/leads/{id}/notes Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Remove one coach note from a lead and leave the rest of the timeline alone. This is how a note filed by mistake gets taken back. Luca operation: DELETE /api/leads/{id}/notes/{noteId} Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Update a lead's display name, stage, score, tags, or custom fields. Luca operation: PATCH /api/leads/{id} Required scopes: leads:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Win rate by objection bucket for the sales framework the coach has configured right now, over a rolling window. These numbers are correlational — read them as a signal, not as proof a framework caused the result. Luca operation: GET /api/framework-performance Required scopes: learning:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read which of the three profile questions Luca still owes an answer to, with suggested answers inferred from the coach's own words. The worked example pair is blanked for a redacted-tier key. Luca operation: GET /api/teach-luca Required scopes: learning:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Dismiss one learning proposal so it drops out of the default list. Use it when the coach has decided against the change, not when you have simply read it. Luca operation: POST /api/learning-proposals/{id}/dismiss Required scopes: learning:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List what the coach's tests have learned and are proposing they act on, newest first. Dismissed proposals are left out unless you ask for them. Luca operation: GET /api/learning-proposals Required scopes: learning:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List what Luca remembers, filtered by lead, scope, source, trust level, or free text. The fact, the reasoning, and the quoted evidence are blanked for a redacted-tier key; trust level, lead, and dates always come back. Luca operation: GET /api/memory Required scopes: memory:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Archive or restore several memories at once. Archiving stops Luca using a fact while the record and its provenance survive, so it is always reversible. Luca operation: POST /api/memory/bulk Required scopes: memory:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Correct one memory: edit the fact, flag it disputed when it turns out to be wrong, restore an archived one, or make it win over a conflicting memory. Luca operation: PATCH /api/memory/{id} Required scopes: memory:write Required capability: draft; data sensitivity: full_content Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Return the coach's structured last-24h review-queue digest: queued drafts with status and confidence, plus counts by status. No model call — summarize it client-side. Example: call with {} at the start of the day.

Cancel a lead's running rescue cadence so no further touches are sent. Safe to call twice (a no-op once cancelled). Example: call with { leadId, reason: "lead replied elsewhere" }.

Return everything waiting on the coach after a call: calls that still need a report on how they went, and attended calls with no revenue outcome recorded. The two halves are tracked separately by the API, so a call can sit on one list and not the other. Close an item with luca_close_call_loop. Example: call with {} after a day of calls.

Structured 24h review-queue digest (items + counts) for the coach. No model call; summarize client-side. Luca operation: GET /api/reports/morning Required scopes: reports:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read the sales scorecard for a window: calls booked and completed, show rate, won and lost, draft approvals, and hours saved. Luca operation: GET /api/reports/scorecard Required scopes: reports:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Move a booked call to a new time and hand back a fresh reschedule link for the lead. Checks the new slot is open first and returns the open slots instead of moving the call when it is taken. Example: call with { bookingId, slotAt: "2026-07-16T15:00:00Z" } after the lead asked to push the call. The lead is not messaged — send them the link yourself, or draft the message through the review queue.

Enroll one or more silent leads into the multi-day rescue cadence. THIS STARTS OUTBOUND TOUCHES to real leads over the coming days — pass confirm: true to proceed. cadenceTemplate is light | standard | aggressive (default standard). Example: { leadIds: ["..."], cadenceTemplate: "standard", confirm: true }.

Approve a pending draft for sending; dispatches through the lead's channel. Sends a real message. Luca operation: POST /api/review-queue/{id}/approve Required scopes: review_queue:write Required capability: queue_ops; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Destructive: has a real-world side effect. You must pass confirm: true; the call is rejected without it. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Explain the signals behind a drafted reply: its voice-match score, any critic findings, and the qualification that motivated it. Luca operation: GET /api/review-queue/{id}/explain Required scopes: review_queue:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List review-queue items when the API key has review queue access. Luca operation: GET /api/review-queue Required scopes: review_queue:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Retry a failed voice-note transcription so the draft can be reviewed. Only re-transcribes; never redrafts or sends. Luca operation: POST /api/review-queue/{id}/media/{mediaId}/retry Required scopes: review_queue:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Record which objection-specialist variant was picked for one queued draft. It is how the objection tests learn which handling works, so record the variant the coach actually chose. Luca operation: POST /api/review-queue/{id}/objection-variant Required scopes: review_queue:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Reject a pending review-queue draft so it never sends. Stops any related booking-recovery cadence and emits review.rejected. Luca operation: POST /api/review-queue/{id}/reject Required scopes: review_queue:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Restore a rejected review-queue item back to pending. Fails if it's a booking message whose recovery window already passed. Luca operation: POST /api/review-queue/{id}/restore Required scopes: review_queue:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read median first-response time and its daily trend. Tells you whether the queue is being cleared fast enough. Luca operation: GET /api/review-queue/sla Required scopes: review_queue:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read each connected channel account's safety status, 24-hour send count, and human-approval window. An account inside its approval window must not be automated against. Luca operation: GET /api/account-safety Required scopes: safety:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Return the coach's prioritized reply queue: pending drafts with lead context and, for the top items, why Luca drafted what it drafted. Start every review session here, then act on an item with luca_approve_and_send, luca_draft_reply, or luca_reviewQueue_reject. Example: call with { explainTop: 3 } to get the queue plus explanations for the three most urgent drafts.

Read the message pool: used, allowed, and remaining for the period. Check this before starting work that drafts in bulk. Luca operation: GET /api/usage/messages Required scopes: usage:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read model spend for the period, rolled up by agent and by day, against the plan's cap. Luca operation: GET /api/usage Required scopes: usage:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List the coach's voice corpus: the writing every draft is matched against. Entry id, source, channel, and age always come back; the writing itself is blanked for a redacted-tier key. Luca operation: GET /api/voice Required scopes: voice:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read a non-verbatim voice-fingerprint summary: version, example count, and last refresh. No corpus text. Luca operation: GET /api/voice/profile Required scopes: voice:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List webhook deliveries. Luca operation: GET /api/webhook-subscriptions/deliveries Required scopes: webhooks:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Replay one webhook delivery without changing the event id. Re-triggers the subscriber's downstream automation. Luca operation: POST /api/webhook-subscriptions/deliveries/{deliveryId}/replay Required scopes: webhooks:write Required capability: queue_ops; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Destructive: has a real-world side effect. You must pass confirm: true; the call is rejected without it. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Bulk replay webhook events by type and time range. Re-triggers downstream automations at scale. Luca operation: POST /api/webhook-subscriptions/events/replay Required scopes: webhooks:write Required capability: queue_ops; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Destructive: has a real-world side effect. You must pass confirm: true; the call is rejected without it. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List canonical webhook events of one type, newest first, in the delivered payload fields. Falls back to a documented sample payload when the workspace has none yet. Luca operation: GET /api/webhook-events Required scopes: webhooks:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Replay one canonical webhook event. Re-triggers subscribers' downstream automations. Luca operation: POST /api/webhook-subscriptions/events/{eventId}/replay Required scopes: webhooks:write Required capability: queue_ops; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Destructive: has a real-world side effect. You must pass confirm: true; the call is rejected without it. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Describe Luca webhook HMAC verification. Luca operation: GET /api/webhook-subscriptions/signature-guide Required scopes: webhooks:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Create an outbound webhook subscription. Luca operation: POST /api/webhook-subscriptions Required scopes: webhooks:write Required capability: draft; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Delete an outbound webhook subscription. Terminal, idempotent soft delete: delivery history stays queryable and the subscription can never be resurrected. Luca operation: DELETE /api/webhook-subscriptions/{id} Required scopes: webhooks:write Required capability: draft; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List outbound webhook subscriptions. Luca operation: GET /api/webhook-subscriptions Required scopes: webhooks:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Update an outbound webhook subscription. Luca operation: PATCH /api/webhook-subscriptions/{id} Required scopes: webhooks:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Queue a canonical test webhook event. Luca operation: POST /api/webhook-subscriptions/test-delivery Required scopes: webhooks:write Required capability: draft; data sensitivity: redacted Requires Idempotency-Key. Provide idempotencyKey for safe retries, or the server will generate one. Use workspaceId or workspaceSlug to override the default workspace configured by environment.