io.github.setluca/luca-mcp

List a campaign's published version history. Published versions cannot change, so this is the record of what actually ran rather than what the draft says today. Luca operation: GET /api/campaigns/{id}/versions Required scopes: campaigns:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Describe Luca's public API capabilities, scopes, and boundaries. Luca operation: GET /api/capabilities Required scopes: leads:read, conversations:read, bookings:read, campaigns:read, broadcasts:read, webhooks:read, integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

File what happened on a call and what it was worth, in one call. Reports attendance on the call event (completed, no_show, rescheduled, or cancelled) and, when an outcome is given, records the booking outcome: won with an amount, lost with a reason id from luca_bookings_outcomeReasons_list, or open with the next follow-up. Nothing is sent to the lead. Example: { bookingId, attendance: "completed", outcome: "won", amountMinor: 250000, currency: "USD" }.

Read the coach-visible audit trail, newest first, filterable by actor type, action, action prefix, or target. It is the one read that spans every domain, so use it to check what a previous run actually did instead of replaying each list route. Luca operation: GET /api/audit-log Required scopes: coach: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 coach's canonical niche, the cohort key their benchmarks are compared against. Luca operation: GET /api/coaches/niche Required scopes: coach: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 coach's offer, audience, price range, promised outcomes, disqualifiers, and FAQs. This is the context that decides whether a lead is a fit. Luca operation: GET /api/coaches/niche-profile Required scopes: coach:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read how the coach wants each objection type handled — price, timing, trust, fit — before drafting a reply to one. Luca operation: GET /api/coaches/objection-playbook Required scopes: coach:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Read which CRM field each post-call value writes to. Check this before a CRM push to know what will land where. Luca operation: GET /api/coaches/post-call-crm-mapping Required scopes: coach: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 CRM pipeline and the stage each call outcome moves a deal to. Luca operation: GET /api/coaches/post-call-deal-sync Required scopes: coach: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 coach's post-call preferences: what gets summarized, what gets pushed to the CRM, and what the coach fills in themselves. Luca operation: GET /api/coaches/post-call-settings Required scopes: coach: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 coach's account record: name, timezone, business hours, and tone slider. Use it to know when the coach is reachable and how formal they want to sound. Luca operation: GET /api/coaches/me Required scopes: coach:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Get a conversation with messages and lead context. Luca operation: GET /api/conversations/{id} Required scopes: conversations: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 recent conversations. Query supports limit, cursor, channel, and q. Luca operation: GET /api/conversations Required scopes: conversations:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Page backward through a thread's older messages, for threads longer than the window the conversation read returns. Luca operation: GET /api/conversations/{id}/messages Required scopes: conversations:read Required capability: read; data sensitivity: full_content Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Send a message to the lead on their channel right away. This is the one conversation tool that reaches a real person without a reviewer seeing the message first, which is why it needs an explicit confirm. Prefer drafting into the review queue unless the coach has asked for this message to go out now. Luca operation: POST /api/conversations/{id}/send Required scopes: conversations: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.

Draft a voice-matched reply for a lead on demand and queue it for review — the middle step of the reply loop (triage → draft → approve). Optional guidance steers tone or content. Nothing is sent; approve it with luca_approve_and_send. Example: call with { leadId, guidance: "keep it short and warm" }.

Search the coach's leads by free-text query and optional channel. Use this to locate a lead before drafting, booking, or flagging. Example: call with { query: "maria instagram" } to find Maria's Instagram lead.

Add a note to a lead, tagged [needs-human], that the coach sees on the lead's timeline. This is an ordinary note with a prefix — it does not route, alert, or reprioritize anything. Use when a conversation needs judgment an agent should not exercise (payment claims, distress, legal), and tell the coach directly if it is urgent. Example: call with { leadId, reason: "lead mentioned a refund dispute" }.

Dismiss one insight the coach does not want to act on. Use this rather than leaving it unread forever. Luca operation: POST /api/insights/{id}/dismiss Required scopes: insights: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 that the thing an insight asked for was actually done. Use it after doing the work, not instead of it. Luca operation: POST /api/insights/{id}/action Required scopes: insights: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.

Mark one insight read, so it stops coming back at the top of the feed. Luca operation: POST /api/insights/{id}/read Required scopes: insights: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 which insight alerts reach the coach and how. The row is created with defaults on the first read, so this never 404s. Check it before concluding a quiet feed means nothing is happening — it may just be muted. Luca operation: GET /api/insights/settings Required scopes: analytics:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Merge-patch the coach's alert-delivery settings. Send only what you are changing; anything left out keeps its current value. Luca operation: PUT /api/insights/settings Required scopes: insights: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.

How many insights the coach has not read yet. Cheap enough to poll before pulling the whole feed. Luca operation: GET /api/insights/unread-count Required scopes: analytics:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

List Zapier, Make, and CRM provider capabilities. Luca operation: GET /api/integrations/connectors Required scopes: integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Create or update a workspace-scoped CRM connection. Luca operation: POST /api/integrations/crm/connections Required scopes: integrations: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.

Probe CRM provider health. Luca operation: POST /api/integrations/crm/connections/{id}/health Required scopes: integrations: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 CRM connections. Luca operation: GET /api/integrations/crm/connections Required scopes: integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Discover CRM provider schema. Luca operation: GET /api/integrations/crm/connections/{id}/schema Required scopes: integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Configure CRM provider webhook status. Luca operation: POST /api/integrations/crm/connections/{id}/webhooks/setup Required scopes: integrations: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.

Confirm CRM field mappings. Luca operation: PUT /api/integrations/crm/connections/{id}/mappings Required scopes: integrations: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.

Suggest CRM field mappings. Luca operation: POST /api/integrations/crm/connections/{id}/mappings/suggest Required scopes: integrations: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.

Exchange a CRM OAuth code and store encrypted credentials. Luca operation: POST /api/integrations/crm/oauth/callback Required scopes: integrations: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.

Create a CRM provider OAuth URL. Luca operation: GET /api/integrations/crm/providers/{provider}/oauth-url Required scopes: integrations:write Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Create a CRM dry-run or live sync run. Luca operation: POST /api/integrations/crm/connections/{id}/sync-runs Required scopes: integrations: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 CRM sync history. Luca operation: GET /api/integrations/crm/connections/{id}/sync-runs Required scopes: integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Record an inbound CRM provider webhook event. Idempotent on the provider's event id, so a redelivery is recorded once. Luca operation: POST /api/integrations/crm/webhooks/{provider} Required scopes: integrations: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 integration event log. Luca operation: GET /api/integrations/events Required scopes: integrations:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Approve a profile suggestion and write it into the coach's profile. Every later draft reads the result, so check the excerpt supports the change before approving. Luca operation: POST /api/knowledge/suggestions/{id}/approve Required scopes: knowledge: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.

Reject a profile suggestion so it stops being offered. The profile is left as it stands. Luca operation: POST /api/knowledge/suggestions/{id}/reject Required scopes: knowledge: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.

Delete a knowledge source. Its pending suggestions go with it; values the coach already approved stay in the profile, because approving copies them there. Luca operation: DELETE /api/knowledge/sources/{id} Required scopes: knowledge: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 the content sources the coach has connected — Notion, Google Docs, a website, an Instagram bio — with the sync state of each one. Connecting a new source is app-only; this lists what is already there. Luca operation: GET /api/knowledge/sources Required scopes: knowledge:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Queue a re-read of one knowledge source now rather than waiting for its next scheduled sync. It returns as soon as the job is queued, so any new suggestions appear on a later read. Luca operation: POST /api/knowledge/sources/{id}/sync Required scopes: knowledge: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 profile changes proposed from the coach's own knowledge sources, each with the excerpt it was drawn from and the value it would replace. Luca operation: GET /api/knowledge/suggestions Required scopes: knowledge:read Required capability: read; data sensitivity: redacted Does not require idempotency. Use workspaceId or workspaceSlug to override the default workspace configured by environment.

Grant explicit lead consent for a channel purpose. Luca operation: POST /api/leads/{id}/consents 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.

Revoke explicit lead consent for a channel purpose. Luca operation: POST /api/leads/{id}/consents/revoke 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.

Create or upsert a lead identity. Body requires channel and externalUserId. Luca operation: POST /api/leads 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.

Draft a voice-matched reply for a lead on demand and queue it for review. Optional guidance steers tone or content. Luca operation: POST /api/leads/{id}/draft 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.

Explain why a lead qualified: the qualifier's reasoning, signals, and confidence from its most recent drafted turn. Luca operation: GET /api/leads/{id}/explain 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.

List custom lead field definitions. Luca operation: GET /api/leads/field-definitions 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.