{"name":"KaiCalls","schema_version":"1.1.1","serverInfo":{"name":"KaiCalls","version":"1.1.1","description":"A business phone line with a secretary who answers calls, takes messages, books appointments and sends missed-call alerts."},"provider":{"organization":"KaiCalls","url":"https://www.kaicalls.com","contact_email":"connor@kaicalls.com"},"endpoints":{"mcp":"https://www.kaicalls.com/api/mcp","acquisition":"https://www.kaicalls.com/api/mcp/acquisition","documentation":"https://www.kaicalls.com/docs/api/agent-discovery"},"auth":{"type":"oauth2","description":"OAuth 2.1 (authorization code + PKCE S256, refresh tokens, DCR). A KaiCalls API key (kc_live_*) is also accepted via Authorization Bearer or X-KaiCalls-API-Key for direct API clients and MCP gateways."},"surfaces":[{"name":"account","url":"https://www.kaicalls.com/api/mcp","audience":"Existing KaiCalls accounts.","description":"The full operator inventory — calls, leads, voicemail, SMS, campaigns, analytics, agent config, evals, config history and billing for a business the caller already belongs to.","tools":["request_human_approval","connect_agent","get_agent_connection","disconnect_agent","get_lsa_account_report","get_lsa_setup","sync_lsa","list_lsa_leads","get_lsa_conversations","get_lsa_report","send_lsa_reply","rate_lsa_lead","agency_profile_bootstrap","agency_profile_update","agency_profile_invite","agency_profile_accept_invite","agency_profile_revoke_invite","agency_profile_assign","agency_profile_unassign","agency_profile_revoke_member","agency_profile_issue_key","agency_offer_save","agency_offer_preview","agency_offer_publish","agency_offer_archive","agency_enrollment_start_self_service","agency_enrollment_finish_self_service","agency_enrollment_owner_save","agency_enrollment_create","agency_enrollment_save","agency_enrollment_preview","agency_enrollment_enroll","agency_enrollment_claim_owner","agency_enrollment_approve_owner","agency_enrollment_rotate_owner_link","agency_enrollment_revoke","agency_installation_preview_route_receipt","agency_installation_approve_route_receipt","agency_installation_preview_handoff","agency_installation_approve_handoff","agency_installation_resolve_update","agency_installation_run_scenarios","agency_installation_owner_preview","agency_installation_approve","agency_installation_revoke_approval","agency_installation_pause","agency_installation_retry","agency_installation_export","agency_installation_preview_offboard","agency_installation_offboard","agency_installation_preview_update","agency_installation_approve_update","agency_installation_apply_update","agency_installation_opt_into_canary","agency_report_generate","agency_report_configure","agency_billing_retry_collection","agency_billing_record_adjustment","agency_billing_set_plan","agency_billing_set_automatic_collection","agency_billing_publish_terms","agency_billing_accept_terms","agency_billing_setup_collection","agency_billing_freeze_period","agency_billing_collect","agency_care_preview_review","agency_care_prepare_review","agency_care_launch_review","agency_support_acknowledge","agency_support_measure","agency_support_complete_exercise","get_agency_workspace","request_extra_number","get_extra_number_status","retry_setup","get_setup_recovery_status","make_call","check_call_status","answer_call_question","join_call","list_recent_calls","get_transcript","share_call_example","unshare_call_example","get_call_recording","list_agents","get_business_info","get_operational_settings","configure_staff_alerts","get_call_disclosures","set_call_disclosures","get_activation_status","confirm_notification_destination","retry_activation_notification","choose_customer_route","configure_textable_links","configure_agent_business_rules","list_leads","get_lead","list_voicemails","list_sms_messages","get_inbox","set_business_hours","list_campaigns","create_campaign","launch_call_campaign","pause_call_campaign","list_workflow_templates","get_analytics","upsert_lead","send_sms","update_agent_config","request_emergency_address","request_transcript_webhook","request_agent_update","request_number_purchase","request_config_rollback","join_meeting","get_meeting","leave_meeting","get_usage","list_plans","get_checkout_status","send_message","request_email_sender","check_email_sender","record_email_consent","revoke_email_consent","draft_email_campaign","approve_email_campaign","launch_email_campaign","cancel_email_campaign","get_email_campaign","set_conversation_owner","get_business_verification","submit_text_registration","get_text_registration","save_text_registration_details","start_text_registration_checkout","set_branded_caller_id","create_customer_workspace","set_up_business","get_setup_checklist","connect_whatsapp","get_whatsapp_status","get_channel_status","get_trust_level","recheck_trust_level","get_balance","create_checkout","list_numbers","get_phone_flow","update_phone_flow","set_up_phone_system","get_phone_system_status","add_team_phone","list_conversations","get_conversation","get_webhook","set_webhook","delete_webhook","list_evals","run_eval","find_voices","list_voices","create_agent","attach_number","set_owner_phone","detach_number","search_available_numbers","buy_number","list_knowledge","upsert_knowledge","list_products","upsert_product","list_config_versions","get_change_history","rollback_config","list_observability_events","list_tool_execution_logs","list_subscription_history","list_overage_charges","list_rightsize_recommendations","report_issue"]},{"name":"acquisition","url":"https://www.kaicalls.com/api/mcp/acquisition","audience":"First-time buyers who do not have an account yet.","description":"A strict subset of the account surface: only the tools that take someone from \"I keep missing calls\" to a working business number that answers. Prefer this endpoint when helping someone set up a new phone line — it is the same authority, narrowed to the setup job, so a routing model is not choosing from the full account inventory.","tools":["request_extra_number","get_extra_number_status","retry_setup","get_setup_recovery_status","make_call","list_agents","get_business_info","get_operational_settings","configure_staff_alerts","get_activation_status","confirm_notification_destination","retry_activation_notification","choose_customer_route","configure_textable_links","configure_agent_business_rules","update_agent_config","get_usage","list_plans","get_checkout_status","create_checkout","list_numbers","get_phone_flow","update_phone_flow","set_up_phone_system","get_phone_system_status","add_team_phone","list_voices","create_agent","attach_number","set_owner_phone","search_available_numbers","buy_number","list_knowledge","upsert_knowledge","list_config_versions","get_change_history","rollback_config"],"job":[{"step":"understand_business","intent":"Read back what this business is and what it already has set up."},{"step":"choose_plan","intent":"Compare current plans and their allowances."},{"step":"check_payment","intent":"Confirm checkout billing separately from phone activation."},{"step":"choose_voice","intent":"Hear and pick the voice that answers the phone."},{"step":"start_checkout","intent":"Open hosted checkout for the selected plan; the owner authorizes payment in Stripe."},{"step":"create_secretary","intent":"Create the secretary that will answer calls."},{"step":"collect_owner_phone","intent":"Get the number Kai will text after every call and ring first before overflowing — frame it as that, not a form field: \"what's the best number for me to text you at when I take a call?\" A caller who declines is recorded as an inquiry via set_owner_phone's decline path; do not continue to find_number/buy_number for them."},{"step":"find_number","intent":"Find a phone number in the right area code."},{"step":"buy_number","intent":"Buy that number (spend is confirmed by a human, never assumed)."},{"step":"connect_number","intent":"Route the number to the secretary."},{"step":"set_up_phone_system","intent":"Turn the number into a hosted phone system: the team rings first, Kai answers as an extension, and the office line forwards in."},{"step":"confirm_live","intent":"Report the working number back and what happens next."}]}],"tools":[{"name":"request_human_approval","title":"Request Human Approval","description":"Ask a named principal for a specific decision using the provisioned voice approval channel. Requires restricted approvals:write, a configured callback host and signing secret. Returns dispatch status; the signed callback carries the decision and evidence. No approval is implied by dispatch. SMS-only delivery is unavailable.","scope":"approvals:write","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"connect_agent","title":"Connect External Agent","description":"Connect an external agent to a business and its signed event outbox. Requires current business admin membership, an assigned Kai agent, and agents:write, sms:write, webhooks:write. New SMS/WhatsApp conversations route to the external agent; explicit handoffs win. Grants no additional permissions and does not activate unregistered channels. Use a stable idempotency_key; replacements require expected_revision. The signing secret is returned only for a non-replayed connect. External realtime voice and email execution are not connected by this operation.","scope":"agents:write","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"get_agent_connection","title":"Get Agent Connection","description":"Discover the external agent connection, signed webhook configuration, scoped API operation catalog, channel readiness and remaining runtime requirements. Requires agents:read, sms:read and webhooks:read. Configuration does not prove delivery or recipient consent.","scope":"agents:read","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"disconnect_agent","title":"Disconnect External Agent","description":"Disconnect the external agent and disable its webhook atomically. Requires current business admin membership and agents:write, sms:write, webhooks:write. Pass the stored expected_revision. Inherited conversations return to Kai; explicit handoffs remain.","scope":"agents:write","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"get_lsa_account_report","title":"get lsa account report","description":"Read the authorized advertiser's live Google Local Services aggregate account report, including actual spend, currency and charged lead totals. Requires linked manager-account access. Dates are calendar dates inclusive at both ends. Source may lag by 30 minutes. Connected phone calls means duration over 30 seconds; responsiveness is the previous 90 days. This is not signed-case revenue or lead-rating reporting.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_lsa_setup","title":"get lsa setup","description":"Inspect Google LSA account selection and sync freshness, with setup steps. Saved configuration never proves a live workflow. Cloud-project production access is not shown here; Google Cloud reports it.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"sync_lsa","title":"sync lsa","description":"Sync an explicitly selected connected LSA advertiser. Requires current business admin role. Syncing runs lead ingestion, and existing business speed-to-lead configuration may contact the new leads it finds.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"list_lsa_leads","title":"list lsa leads","description":"List synced Google LSA leads, charge and credit states, source IDs and rating details. The returned LSA lead id identifies the lead in LSA commands; the separate lead_id field links to the CRM.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_lsa_conversations","title":"get lsa conversations","description":"Read the latest 200 synced Google LSA conversation events for an LSA lead, including customer and advertiser messages. History is as current as the last sync.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_lsa_report","title":"get lsa report","description":"Report LSA lead counts, types, observed statuses, ratings and credit counts for an explicit UTC window (start inclusive, end exclusive). Includes sync freshness and completeness. Removed unrated leads are counted separately because they cannot be rated here. Financial amounts, signed cases and response-time metrics are unavailable in this source and cannot be derived from counts.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"send_lsa_reply","title":"send lsa reply","description":"Send an authorized text reply inside an existing Google LSA message lead through the Ads API. This contacts the customer. Requires current business admin role and a stable idempotency_key. A retry with the same key is deduplicated; pending/unknown writes are blocked. Provider acceptance does not prove customer delivery. Attachments are unsupported.","scope":"sms:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"rate_lsa_lead","title":"rate lsa lead","description":"Submit an authorized, truthful Google LSA quality survey and return Google's actual bonus-credit decision. This is not a guaranteed refund or the retired manual dispute workflow. Requires admin role and a stable retry key. Each rating is a per-lead survey answer based on that lead, not a bulk dissatisfaction claim. The reason must match the positive/negative rating; OTHER requires a comment. Neutral takes no reason.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_profile_bootstrap","title":"Create Agency Profile","description":"Registers a new agency for the signed-in user and makes them its owner, using the given brand and support details. Requires a signed-in user session with a verified email; an API key cannot create an agency. Repeating it for an agency that already exists does not create a second one.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_update","title":"Update Agency Profile","description":"Replaces the agency brand, support details and requested commercial mode. Requires an agency owner or admin and the current profile revision; a stale revision is rejected. It does not change any published offer.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_invite","title":"Invite Agency Team Member","description":"Creates a staff invitation for an email address with the admin, operator or reader role and returns a one-time invite link that expires in 7 days. Requires an agency owner or admin; only the owner can invite an admin. It sends no email; the returned link is delivered by whoever created the invite.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_profile_accept_invite","title":"Accept Agency Invitation","description":"Joins the agency using the token from an invite link. The signed-in user must have a verified email that matches the invited address, and the invite must be unexpired and not revoked. Accepting the same invite again is a no-op.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_revoke_invite","title":"Revoke Agency Invitation","description":"Cancels a pending staff invitation so its link can no longer be used. Requires an agency owner or admin. It does not remove anyone who already accepted; revoke_member does that.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_assign","title":"Assign Staff Member to Client","description":"Gives an active agency staff member access to one client business with the admin or member business role. Requires an agency owner or admin who can manage that client; only the owner can assign an admin staff member. Assigning an existing assignment again changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_unassign","title":"Remove Staff Member from Client","description":"Removes a staff member's agency assignment to one client business, and removes the business membership if this assignment created it. Requires an agency owner or admin; only the owner can unassign an admin. It does not remove the person from the agency.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_revoke_member","title":"Remove Agency Team Member","description":"Removes a staff member from the agency: revokes their membership, all their client assignments, their accepted invites and every API key issued to them through the agency. Requires an agency owner or admin; only the owner can remove an admin, and the owner cannot be removed.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_profile_issue_key","title":"Issue Agency API Key","description":"Creates a new API key for yourself in this agency, limited to the requested scopes, and returns the secret once. Readers cannot get write scopes, only the agency owner can get billing:write, and a delegated key cannot issue a key broader than itself. Each call creates another key (up to 20 active per user).","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_offer_save","title":"Save Agency Offer Draft","description":"Creates a new offer draft, or replaces an existing draft when offerId and its current revision are given. Requires an agency owner or admin. Saving changes only the draft; clients see nothing until it is published.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_offer_preview","title":"Preview Agency Offer","description":"Builds the publishable manifest and sales kit for an offer draft and returns its fingerprint and revision for publishing. Requires an agency owner or admin. It saves nothing and fails if a package release, variant or claim is not supported.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_offer_publish","title":"Publish Agency Offer","description":"Publishes the previewed offer as a new immutable version and returns its enrollment link. Requires an agency owner or admin, plus the fingerprint and revision from preview; partner-billed offers also need billing collection to be ready. Publishing the same fingerprint again returns the existing version.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_offer_archive","title":"Archive Agency Offer","description":"Archives an offer so it can no longer be published or used for new enrollments. Requires an agency owner or admin and the current offer revision. Existing installations are not removed.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_start_self_service","title":"Start Self-Service Enrollment","description":"Starts a business owner's own enrollment in a published agency offer, using the business name and intake facts. Requires a signed-in user session with a verified email and an idempotency key; the same key replays the same session. Nothing is installed until the owner approves and finishes.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_finish_self_service","title":"Finish Self-Service Enrollment","description":"Completes a self-service enrollment after the owner has approved the current intake: creates the client business and queues its package installations, which later configure the business's voice agent. Only the owner who started it can finish it. Repeating it returns the recorded result.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_enrollment_owner_save","title":"Save Owner Intake Facts","description":"Lets the client owner replace the intake facts on their own enrollment link. Requires the owner who claimed the link and the session's current revision. Saving clears any earlier owner approval, so the owner must approve again.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_create","title":"Create Client Enrollment Batch","description":"Creates an enrollment session for 1-50 existing or new clients against a published offer version and returns one owner approval link per new client. Requires an agency owner, admin or operator with access to each existing client, and an idempotency key; a replay returns the session without the links. It sends no email and installs nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_save","title":"Save Client Enrollment Batch","description":"Replaces the client entries of an uncommitted enrollment session. Requires the session creator (or an agency owner/admin) and the current session revision. Saving revokes all outstanding owner approval links for the batch, so owners must be sent new links.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_preview","title":"Preview Client Enrollment","description":"Checks every client in the batch for missing facts, owner approval and payer conflicts, and returns what enrolling would install, with the fingerprint and approval IDs needed to enroll. Requires an agency owner, admin or operator. It records the preview on the session but installs nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_enroll","title":"Enroll Clients in Offer","description":"Commits the previewed batch: creates new client businesses, records owner approvals and queues package installations for every ready client; installations later configure each client voice agent. Requires an agency owner, admin or operator who created the session, its idempotency key, and the fingerprint and revision from preview. Clients that are not ready are reported with their next step instead of being installed.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_enrollment_claim_owner","title":"Claim Owner Enrollment Link","description":"Links the signed-in client owner to their enrollment link using its token. The user's verified email must match the owner email on the link. It approves nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_approve_owner","title":"Approve Owner Enrollment","description":"Records the client owner's approval of the exact offer and intake facts on their enrollment link. Requires the owner who claimed the link, the session's current revision and its fingerprint. It does not enroll; the agency still enrolls the batch.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_enrollment_rotate_owner_link","title":"Replace Owner Enrollment Link","description":"Issues a new owner link for a client in the batch and invalidates the old one, clearing any earlier claim and approval. Requires the session creator (or an agency owner/admin) and the link's current revision. It sends nothing; the returned link is delivered by whoever re-issued it.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_enrollment_revoke","title":"Revoke Enrollment Session","description":"Revokes an enrollment session and all of its owner links so nothing more can be approved or enrolled from it. Requires the session creator or an agency owner/admin. Installations that were already enrolled are not removed.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_preview_route_receipt","title":"Preview Route Test Receipt","description":"Returns the evidence that a real call reached the client's voice line and produced a delivered lead notification, with a fingerprint for acknowledgement. Only for voice intake installations whose training is complete, and only the client owner who received that notification can view it. It changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_approve_route_receipt","title":"Acknowledge Route Test Receipt","description":"Records the client owner acknowledging the route test receipt they reviewed. Requires the client owner who received the notification and the fingerprint from preview_route_receipt. It does not place any call.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_preview_handoff","title":"Preview Staff Handoff","description":"Returns the staff handoff for an installation with a fingerprint for approval. Requires client membership or agency assignment to the client. It changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_approve_handoff","title":"Approve Staff Handoff","description":"Records the client owner approving the exact staff handoff they reviewed. Requires the client owner and the fingerprint from preview_handoff.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_resolve_update","title":"Resolve Update Conflicts","description":"Chooses, for each conflicting setting in a proposed package update, whether to keep the client's current value or use the package value, and saves the resolved update. Requires the client owner and the update's fingerprint; client facts cannot be overridden this way. It does not apply the update, and the resolved version needs fresh owner approval.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_run_scenarios","title":"Run Installation Test Scenarios","description":"Run approved verification scenarios for an existing client installation at its expected revision using voice agent compute under existing entitlement. Requires current assigned client authority, current owner approval and evals:write. Saves test evidence and can incur irreversible usage charges; a new request key can run and charge again. Makes no real customer calls.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_installation_owner_preview","title":"Preview Client Facts and Script","description":"Shows the client owner the exact intake facts and voice script prepared for their business, with the hashes needed to approve each. Only the client owner can view it, and only after the agency prepared a complete preview. It changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_approve","title":"Approve Client Facts or Script","description":"Records the client owner approving either the intake facts or the voice script they reviewed. Requires the client owner and the matching hash from owner_preview. It does not install anything by itself.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_revoke_approval","title":"Revoke Client Approval","description":"Withdraws one of the client owner's earlier approvals. Requires the client owner. Work that depends on that approval waits until it is approved again.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_pause","title":"Pause Installation","description":"Pauses an installation so its package setup and scheduled package work stop. Requires agency write access to the client or the client owner, and the current revision. It does not delete anything; use retry to queue it again.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_retry","title":"Retry Installation","description":"Re-queues an installation so setup runs again, clearing its last error; setup configures the client's voice agent. Requires agency write access to the client or the client owner, and the current revision.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"agency_installation_export","title":"Export Installation Configuration","description":"Returns the installation release, intake facts, approved script, staff sheet and checks for handoff or records. Requires client membership or agency assignment to the client. It changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_preview_offboard","title":"Preview Installation Offboarding","description":"Shows what offboarding would stop and what it keeps (phone number, sender, connections, billing plan and history), with a fingerprint for approval. Only the client owner can view it. It changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_offboard","title":"Offboard Installation","description":"Starts offboarding: stops the package's jobs, revokes its future automation authority and turns off its scheduled reports. Requires the client owner, accepted set to true and the fingerprint from preview_offboard. The phone number, connections, billing plan and history are kept.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_preview_update","title":"Preview Installation Update","description":"Prepares a proposed update to a newer published offer version, or a rollback to an earlier installation revision, and lists any conflicts with client changes. Requires agency write access to the client or the client owner. It saves the proposal for review but does not apply it; client facts are always kept.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_approve_update","title":"Approve Installation Update","description":"Records the client owner approving the updated script of a proposed update. Requires the client owner, the updateId and its fingerprint. It does not apply the update.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_installation_apply_update","title":"Apply Installation Update","description":"Applies an approved update and re-queues setup, which replaces the client's live voice agent configuration. Requires agency write access or the client owner, a resolved update with no open conflicts, fresh owner approval, and (unless this client is the canary) an active canary on the same release. Applying an already-applied update changes nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_installation_opt_into_canary","title":"Opt Installation into Canary","description":"Marks the client's installation as a canary, so it can receive package updates before other clients of the same agency. Requires the client owner and accepted set to true. It applies no update by itself.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_report_generate","title":"Generate Activity Report","description":"Generate and save an activity report snapshot for an existing client installation at its expected revision. Requires current client membership and agency access. Queues report email for due owner-approved subscriptions to existing verified client members and advances their schedule; queued does not mean delivered.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_report_configure","title":"Schedule Activity Report Emails","description":"Sets the weekly or monthly activity report email schedule for an installation and replaces the previous recipient list. Requires the client owner; recipients must be verified members of the client's business. The first report is sent by the scheduled job, not by this call.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_billing_retry_collection","title":"Retry Wholesale Payment","description":"Retries payment of an existing open wholesale invoice with the agency's verified payment method. Requires the agency owner and a ready collection method; a paid invoice is reported, not charged again. Settlement is confirmed later by the payment provider.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_billing_record_adjustment","title":"Record Billing Adjustment","description":"Record an already-issued provider credit note or debit invoice against an existing agency billing line. Platform finance operators only: requires the existing admin key and wildcard scope; agency owner status is insufficient. Verifies exact provider receipt, currency and amount before recording bookkeeping. Creates no invoice, payment or subscription.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_billing_set_plan","title":"Set Client Partner Plan","description":"Puts a partner-created client on an agency-billed plan, or stops it when plan is null. Requires the agency owner who is also a client admin; starting a plan needs accepted terms and a ready collection method. Stopping parks the client service, which detaches its phone numbers from the voice agent under the existing parking policy.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_billing_set_automatic_collection","title":"Set Automatic Collection","description":"Turns monthly automatic collection of wholesale charges on or off under the accepted terms. Requires the agency owner and accepted terms; it cannot be turned off while any client is on an active partner plan. It charges nothing by itself.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_billing_publish_terms","title":"Publish Wholesale Terms","description":"Publishes a new set of wholesale commercial terms (discount, grace days, document and start date) for one agency, or for all agencies when partnerId is null. Platform commercial operators only. Each call publishes another version; agencies must still accept it.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_billing_accept_terms","title":"Accept Wholesale Terms","description":"Accepts published wholesale terms for the agency and applies their discount. Requires the agency owner, and the terms must be in effect and apply to this agency. It charges nothing and doesn't set up payment.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_billing_setup_collection","title":"Set Up Wholesale Payment Method","description":"Creates the agency's customer record at the payment provider if needed and returns a hosted link where the owner adds a payment method. Requires the agency owner and accepted terms. It charges nothing, and the method is ready only after the provider confirms it.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_billing_freeze_period","title":"Freeze Wholesale Billing Period","description":"Calculates and locks the wholesale statement for one closed calendar month (UTC) from the agency's billable client intervals. Requires the agency owner. Freezing the same month again returns the same period; it does not charge.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_billing_collect","title":"Collect Wholesale Payment","description":"Creates and finalizes the payment provider invoice for a frozen billing period and charges the agency's verified payment method automatically. Requires the agency owner and a verified collection method. Repeating it reuses the same invoice instead of charging twice.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"agency_care_preview_review","title":"Preview Review Request Texts","description":"Shows the exact review-request text, sender number and recipients for customers with a completed service, with a fingerprint for approval. Requires the client owner, the sms:write scope, and an SMS review installation where Kai is confirmed as the review tool. It sends nothing and saves nothing.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_care_prepare_review","title":"Prepare Review Request Campaign","description":"Saves the approved review-request texts as a draft campaign and reserves the listed customers. Requires the client owner, the sms:write scope, accepted set to true and the fingerprint from preview_review. It sends nothing; launch_review sends it.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_care_launch_review","title":"Send Review Request Texts","description":"Launches the approved review-request campaign, queuing text messages to the listed customers from the business number. Requires the client owner, the sms:write scope, accepted set to true and the fingerprint from preview_review. A campaign that is already sending can't be launched again.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"agency_support_acknowledge","title":"Acknowledge Agency Incident","description":"Marks an agency incident as acknowledged and assigns its follow-up to you. Requires an agency owner, admin or operator. It does not resolve the incident; recovery is confirmed separately.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"agency_support_measure","title":"Record Agency Work Measurement","description":"Records time spent or money for one client (setup, support, fulfillment, provider cost or retail receipt) with a note. Requires an agency owner, admin or operator with write access to that client. Each call adds a new record.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"agency_support_complete_exercise","title":"Complete Training Exercise","description":"Save completion evidence for a named operational exercise on an existing client installation. Requires current assigned client authority. Replaces any previous proof reference and completion time for that exercise; does not prove live customer delivery.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"receipt":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"get_agency_workspace","title":"Read agency workspace","description":"Read assigned installations, grouped support incidents, accepted billing evidence (also billing:read), or inventory one authorized client's saved facts and actual channel readiness. Suggestions and unknowns remain explicit.","scope":"workspaces:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"state":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"request_extra_number","title":"Review an Extra Number","description":"Reserve an exact pool number and request an owner-only browser review of its recurring extra-line price. Requires numbers:write and billing:write. It never charges included or prepaid capacity; included allocation goes through attach_number. This tool does not approve payment or prove activation.","scope":"billing:write","acquisitionStep":"buy_number","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_extra_number_status","title":"Get Extra Number Request Status","description":"Read an owner-authorized extra-number request. Billing, assignment and live activation are distinct. Unknown checkout or provider outcomes retain the original request and number, so no replacement purchase is needed or started.","scope":"numbers:read","acquisitionStep":"connect_number","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"retry_setup","title":"Reconcile Existing Setup","description":"Reconcile database pointers for an existing imported signup phone reservation. Owner-only, entitlement-checked, single-flight and idempotent. Never creates agents, buys numbers, changes provider routing or sends messages. PBX, missing imports, and stale claims return review blockers. Reusing the same key reads or replays the outcome; a failed request is held for review before a new key is accepted. Ready means database agreement, not activation.","scope":"numbers:write","acquisitionStep":"confirm_live","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"get_setup_recovery_status","title":"Get Setup Recovery Status","description":"Read an owner-authorized setup recovery request by its business and idempotency key. Running requests are never automatically stolen, including stale requests. A ready receipt does not prove live activation.","scope":"numbers:read","acquisitionStep":"confirm_live","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"make_call","title":"Make Call","description":"Place an outbound call through a KaiCalls AI agent: call back a customer who previously called this business, give the owner a voice preview, or call on the owner's behalf (a landlord, clinic, pharmacy, school or utility) with the task in context. For a customer callback, pass the existing lead_id and callback goal in context. Kai verifies the business's inbound-call consent for the exact destination; a verified callback can go directly to a cell phone without connecting the owner. Contact existence alone is not callback permission, and opt-outs still block calls. A call never proves inbound routing or advances activation. report_language sets the language the result is reported in, and Kai then confirms exact details for that reader; Kai speaks call_language (English by default) on the phone. A new account's first call to a US or Canada business line is free; after that the account needs a plan. Kai calls businesses, not personal cell phones, on a free call. For a business that answers on a cell phone, connect_me has Kai ring the person's own saved phone and connect them, so they do the talking. An idempotency_key makes the request safely retryable.","scope":"calls:write","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"replayed":{"type":"boolean"},"intent_id":{"type":"string"},"idempotency_key":{"type":"string"},"external_ref":{"type":["string","null"]},"preview_only":{"type":"boolean"},"counts_toward_activation":{"type":"boolean"},"call_language":{"type":"string"},"report_language":{"type":"string"},"call":{"type":"object","properties":{"id":{"type":["string","null"]},"conversation_id":{"type":["string","null"]},"status":{"type":"string"},"agent_id":{"type":"string"},"business_id":{"type":"string"},"lead_id":{"type":["string","null"]},"to":{"type":"string"}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"check_call_status","title":"Check Call Status","description":"Check the status of a call by its ID, and any question Kai is waiting on (pending_question)","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"pending_question":{"type":["object","null"],"properties":{"question_id":{"type":"string"},"question":{"type":"string"},"asked_at":{"type":"string"},"seconds_waiting":{"type":["integer","null"]},"answer_within_seconds":{"type":"integer"},"open_questions":{"type":"integer"}}},"call":{"type":"object","properties":{"id":{"type":"string"},"conversation_id":{"type":["string","null"]},"status":{"type":"string"},"duration_seconds":{"type":["number","null"]},"agent_id":{"type":["string","null"]},"agent_name":{"type":["string","null"]},"business_id":{"type":"string"},"lead_id":{"type":["string","null"]},"summary":{"type":["string","null"]},"recording_url":{"type":["string","null"]},"quality_dimensions":{"type":["object","array","null"]},"created_at":{"type":"string"}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"answer_call_question","title":"Answer Call Question","description":"Send the person's answer to a live call's pending_question, or decline. Send only what they said; answered once.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"code":{"type":"string"},"call_id":{"type":"string"},"question_id":{"type":["string","null"]},"replayed":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"join_call","title":"Join Call","description":"Join a live errand call. take_over connects the person's own phone; listen returns a signed-in dashboard link.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"mode":{"type":"string"},"call_id":{"type":"string"},"takeover_status":{"type":"string"},"listen_link":{"type":"string"},"replayed":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"list_recent_calls","title":"List Recent Calls","description":"List and search the business's calls, newest first, each with who called (when known) and a short summary of what they wanted. Search by caller phone, by words in the call summary (\"water heater\", \"quote\"), and by date window; filters combine. Use get_transcript for the full call.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"calls":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"filters":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_transcript","title":"Get Transcript","description":"Get the transcript and summary of a completed call","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"call":{"type":"object"},"transcript_available":{"type":"boolean"},"transcript":{"type":["string","null"]},"transcript_truncated":{"type":"boolean"},"transcript_length":{"type":"integer"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"share_call_example","title":"Share Call Example","description":"Owner only: publish a finished errand call as a redacted transcript example (no audio, business shown as a category). Call once for a preview, show it, then confirm with its preview_hash.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"published":{"type":"boolean"},"preview":{"type":"object"},"shared_at":{"type":["string","null"]},"examples_url":{"type":"string"},"code":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"unshare_call_example","title":"Unshare Call Example","description":"Owner only: take a shared call example down.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"unshared":{"type":"boolean"},"unshared_at":{"type":["string","null"]},"code":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_call_recording","title":"Get Call Recording","description":"Get the real call recording URL for a call so reviewers can listen to the voice/audio instead of relying only on the transcript.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"recording_available":{"type":"boolean"},"call":{"type":"object","properties":{"id":{"type":"string"},"conversation_id":{"type":["string","null"]},"status":{"type":"string"},"duration_seconds":{"type":["number","null"]},"recording_url":{"type":["string","null"]},"agent_id":{"type":["string","null"]},"agent_name":{"type":["string","null"]},"business_id":{"type":"string"},"created_at":{"type":"string"}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_agents","title":"List Agents","description":"List the KaiCalls agents on the authenticated account. Shows whether this business already has a secretary answering its calls.","scope":"agents:read","acquisitionStep":"understand_business","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"agents":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"filters":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_business_info","title":"Get Business Info","description":"Read back what a business already has: profile details, how many agents are configured, and recent call volume. This shows whether a business number that answers missed calls already exists. When the business has no working phone line yet, `next_step` names the tool that sets one up.","scope":"agents:read","acquisitionStep":"understand_business","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business":{"type":"object"},"agent_count":{"type":"integer"},"calls_last_30_days":{"type":"integer"},"next_step":{"type":["object","null"],"description":"Present when the business has no working phone line yet: code, the tool to call next, and the instruction to follow. Null once the line is set up."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_operational_settings","title":"Get Operational Settings","description":"Read the business-level operational setup of a live account: staff alert recipients, SMS/email alert flags, escalation rules, textable send-link entries, and assigned agent voice/model/greeting metadata.","scope":"agents:read","acquisitionStep":"understand_business","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business":{"type":"object"},"notification_settings":{"type":["object","null"]},"business_links":{"type":"array","items":{"type":"object"}},"agents":{"type":"array","items":{"type":"object"}},"available_setup_tools":{"type":"array","items":{"type":"string"}},"next_step":{"type":["object","null"],"description":"Present when the business has no working phone line yet: code, the tool to call next, and the instruction to follow. Null once the line is set up."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"configure_staff_alerts","title":"Configure Staff Alerts","description":"Save business-owned staff alert recipients and post-call escalation rules. Saving settings does not prove provider delivery or owner receipt; activation notification proof is tracked separately.","scope":"agents:write","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"settings":{"type":"object"},"dry_run":{"type":"boolean"},"current_settings":{"type":["object","null"]},"proposed_settings":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"get_call_disclosures","title":"Get Call Disclosures","description":"Read the recording notice and AI notice callers hear before the greeting, and when each plays: always, state_gated (only for callers in states whose law calls for it, e.g. all-party-consent states for recording), or never. Shows the defaults when the business has not set its own.","scope":"agents:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"settings":{"type":"object"},"is_default":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"set_call_disclosures","title":"Set Call Disclosures","description":"Change the recording notice or AI notice callers hear before the greeting, or when each plays. The next call uses the new wording. Requires the business owner. Turning a notice to never can break recording or AI-disclosure law for callers in states that require one; state_gated is the safe default. Every change is logged with the previous value.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"settings":{"type":"object"},"previous":{"type":["object","null"]},"dry_run":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"get_activation_status","title":"Get Activation Status","description":"Read current call readiness and persisted private-test proof for one accessible business. Only a currently entitled owner with a coherent assigned number gets the existing private-test setup link. Missing entitlement, incomplete setup or stale sessions do not authorize a call. It cannot assert or advance proof. A completed private test is separate from customer-route coverage; forwarding is optional and does not define whether the assigned phone works.","scope":"agents:read","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"activation_session_id":{"type":["string","null"]},"state":{"type":["string","null"]},"next_action":{"type":"string"},"call_readiness":{"type":"object"},"command_center_unlocked":{"type":"boolean"},"owner_phone_on_file":{"type":"boolean","description":"Whether the owner's own mobile number is on file for SMS alerts or ring-first. Its absence does not invalidate an email-confirmed private test or require forwarding."},"proof":{"type":"object"},"notification_attempts":{"type":"array","items":{"type":"object"}},"routes":{"type":"array","items":{"type":"object"}},"activation_receipt":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"confirm_notification_destination","title":"Confirm Activation Notification Destination","description":"APPROVAL-GATED. Save the owner-approved phone number (SMS) or email address where KaiCalls sends the owner the result of their first test call, for the exact active activation session. Once that test call's record is ready, KaiCalls sends a real text or email to that destination through its messaging provider; saving the destination alone is not proof anything was delivered. Replaces any destination saved earlier for the session.","scope":"agents:write","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"business_id":{"type":"string"},"activation_session_id":{"type":"string"},"destination_masked":{"type":["string","null"]},"delivery_started":{"type":"boolean"},"attempt":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"retry_activation_notification","title":"Retry Activation Notification","description":"APPROVAL-GATED. Send the owner's activation notification again, as a real text or email through KaiCalls' messaging provider, for the exact active activation session. Only retries a channel whose last attempt failed or has waited long enough; an attempt whose outcome is unknown is never blindly resent. Requires a new idempotency_key.","scope":"agents:write","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"business_id":{"type":"string"},"activation_session_id":{"type":"string"},"attempt":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"choose_customer_route","title":"Choose Customer Route","description":"APPROVAL-GATED. After private-test proof is complete, save forwarding, published_number, both, or testing. This unlocks the command center but does not claim customer coverage; selected customer routes remain pending until independently verified. Forwarding is optional; testing keeps the existing private-test result without connecting a customer route.","scope":"numbers:write","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"business_id":{"type":"string"},"activation_session_id":{"type":"string"},"deployment_choice":{"type":"string"},"command_center_unlocked":{"type":"boolean"},"customer_coverage_active":{"type":"boolean"},"routes":{"type":"array","items":{"type":"object"}},"instructions":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"configure_textable_links","title":"Configure Textable Links","description":"Create or repair the business_links entries used by the send_link/send_sms tools. These entries let callers receive booking, directions, cancellation, sister-location, or service-specific links by text without raw URLs in the voice prompt.","scope":"agents:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"links":{"type":"array","items":{"type":"object"}},"dry_run":{"type":"boolean"},"plan":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"configure_agent_business_rules","title":"Configure Agent Business Rules","description":"Safely add or replace a named operational rules section inside an agent inbound prompt, then route the prompt patch through the governed agent.patch broker. It covers cross-business handoffs, callback language, alert promises, and client-specific operating rules, and leaves the rest of the prompt unchanged.","scope":"agents:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"business_id":{"type":["string","null"]},"agent_id":{"type":["string","null"]},"section_title":{"type":["string","null"]},"rules_count":{"type":["integer","null"]},"request_id":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"list_leads","title":"List Leads","description":"List leads for the authenticated business, with optional status/source/agent filters. Includes the latest AI lead score when available.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"leads":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"filters":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_lead","title":"Get Lead","description":"Get full details for a single lead by ID, including the latest AI lead score and explanation.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"lead":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_voicemails","title":"List Voicemails","description":"List recent voicemails for the authenticated business, including transcripts and recording URLs.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"voicemails":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_sms_messages","title":"List SMS Messages","description":"Read SMS and WhatsApp message evidence for accessible businesses (sms:read), including provider message ID, carrier status, delivery/failure timestamps and failure code. Filter by business_id, conversation or direction, and search by phone number (either side), words in the message, and date window. Provider acceptance is not delivery; delivered_at and carrier status record delivery. Mirrors GET /api/v1/sms/messages; uses offset pagination.","scope":"sms:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"messages":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"filters":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_inbox","title":"Get Inbox","description":"Answer \"what did I miss?\" in one read: the business's calls since a moment (default the last 24 hours, at most 30 days) with who called and what they wanted, every unheard voicemail with its transcript, texts that came in (needs sms:read), and open to-dos and callbacks. Read-only. Follow up with get_transcript, send_message to reply, or list_recent_calls / list_sms_messages to search further back.","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"since":{"type":"string"},"calls":{"type":"array","items":{"type":"object"}},"voicemails":{"type":"array","items":{"type":"object"}},"texts":{"type":["array","null"],"items":{"type":"object"}},"todos":{"type":"array","items":{"type":"object"}},"has_more":{"type":"object"},"sections_not_read":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"set_business_hours","title":"Set Business Hours","description":"Change the business's opening hours, timezone, or one-off closed dates (\"we're closed Friday the 27th\"). Same change as the dashboard's hours page, admin role required. Only the days you pass change; every other day keeps what it had. A day is { open: 'HH:MM', close: 'HH:MM' } in 24-hour time, or { closed: true }. closed_dates adds dates the business is shut; reopen_dates removes them. Call routing that follows business hours uses the new hours from the next call. Returns the saved week as read back.","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"business_hours":{"type":["object","null"]},"timezone":{"type":"string"},"holidays":{"type":"array","items":{"type":"object"}},"changed_days":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_campaigns","title":"List Campaigns","description":"List outbound call campaigns for the authenticated business.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"campaigns":{"type":"array","items":{"type":"object"}},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]},"filters":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_campaign","title":"Create Campaign","description":"Create an outbound call campaign (cadence + lead batch) and optionally launch it immediately. Launching queues calls for the orchestrator; existing TCPA/consent gating still applies at dial time. Requires admin role on the business.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"campaign":{"type":"object"},"launched":{"type":"boolean"},"sequence_id":{"type":["string","null"]},"queued":{"type":["integer","null"]},"total_leads":{"type":["integer","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"launch_call_campaign","title":"Launch Call Campaign","description":"Start or resume an existing outbound call campaign so Kai begins calling its leads. Needs campaign_id and agent_id (an agent assigned to the same business), the calls:write scope and an admin role in the business. Queues the campaign's pending calls within its call windows; real people get phone calls once it runs. A queued result does not mean any call was answered or completed. pause_call_campaign stops it. Not for email campaigns.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"campaign_id":{"type":"string"},"action":{"type":"string"},"sequence_id":{"type":["string","null"]},"queued":{"type":["integer","null"]},"paused_jobs":{"type":["integer","null"]},"cancelled_attempts":{"type":["integer","null"]},"reset_leads":{"type":["integer","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"pause_call_campaign","title":"Pause Call Campaign","description":"Pause an outbound call campaign. Stops its queued and scheduled calls and cancels pending call attempts; a call already in progress may finish. Leads are kept and the campaign can be resumed later with launch_call_campaign. Needs campaign_id, the calls:write scope and an admin role in the business. Pausing an already paused campaign changes nothing.","scope":"calls:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"campaign_id":{"type":"string"},"action":{"type":"string"},"sequence_id":{"type":["string","null"]},"queued":{"type":["integer","null"]},"paused_jobs":{"type":["integer","null"]},"cancelled_attempts":{"type":["integer","null"]},"reset_leads":{"type":["integer","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_workflow_templates","title":"List Workflow Templates","description":"List the cadence/campaign workflow templates KaiCalls can run (standard, aggressive, nurture, custom), including each template's retry interval, defaults (call windows, days, attempts), and a ready-to-use cadence_config example. The cadence_config examples match the shape create_campaign accepts, including multi-step sequences with launch=true. Static catalog — no per-business state.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"templates":{"type":"array","items":{"type":"object"}},"cadence_config_fields":{"type":"array","items":{"type":"object"}},"defaults":{"type":"object"},"usage":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_analytics","title":"Get Analytics","description":"Get a dashboard summary (lead counts by status, conversion rate, call volume and duration, top agents, and business outcomes by type) over a recent time window.","scope":"calls:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"period":{"type":"object"},"leads":{"type":"object"},"calls":{"type":"object"},"agents":{"type":"object"},"outcomes":{"type":"object"},"outcomes_total":{"type":"integer"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"upsert_lead","title":"Create or Update Lead","description":"Create a new lead or update existing leads for the authenticated business, routed through the governed leads API (business access-checked, usage-logged, and audited). To create one, pass `lead` with at least one of name/phone/email plus optional status/source/notes/agent_id/etc. To update, pass `updates`: an array of { id, ...fields } for one or many existing leads (status, name, phone, email, notes, address, city, state, zip). Updates are access-checked per row and report partial success.","scope":"leads:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"operation":{"type":"string","description":"create or update"},"lead":{"type":["object","null"]},"updated":{"type":["integer","null"]},"failed":{"type":["integer","null"]},"results":{"type":["array","null"],"items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"send_sms","title":"Send SMS","description":"Send a text from an agent's phone line through the governed messaging API. Provide from_agent_id, to, and message. For the immediate confirmation a customer just requested on a booking form, add purpose: booking_confirmation, the form's actual sms_consent: true, and idempotency_key; this records service consent and allows the requested confirmation after hours. Booking alerts to this business's active admin phone use purpose: booking_alert and idempotency_key. Explicit opt-outs, content controls and rate limits remain enforced. Use dispatch_policy: queue_if_needed to defer ordinary messages outside their allowed window. Optionally link lead_id; it must belong to this business and match the recipient phone.","scope":"sms:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"message_sid":{"type":["string","null"]},"to":{"type":["string","null"]},"from":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"update_agent_config","title":"Update Agent Configuration","description":"Edit an agent's live runtime configuration — greeting/first message, inbound or SMS prompt, voice, language model, max call duration, and call-transfer settings — routed through the governed update broker so every change keeps the consent + audit trail (a versioned config snapshot and change history). Every write here is reversible: get_change_history and list_config_versions list what changed, and rollback_config undoes it. Mutating changes need an idempotency_key. When the business owner or an admin is signed in through this connector, their own changes apply immediately. High-impact live changes made with an API key or on someone else's behalf queue for the owner's review instead (the owner is notified with a review link). configure_agent_business_rules edits a single named operational-rules section.","scope":"agents:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"business_id":{"type":["string","null"]},"agent_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"request_emergency_address","title":"Set Emergency (911) Address","description":"Set the emergency (E911) service address for one of the business's phone numbers with the phone carrier, so a 911 call from that line reaches the right dispatcher. Needs phone_number, the full street address and disclosure_acknowledged true after the owner reads the 911 notice, plus the owner's confirmed approval. Replaces any address on file for that number. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.","scope":"numbers:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"intent":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"missing_fields":{"type":["array","null"],"items":{"type":"string"}},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"request_transcript_webhook","title":"Send Call Transcripts to a Webhook","description":"Create or update a webhook that receives the business's completed-call events (which can include transcripts) at a URL the business controls. Needs webhook_url and the owner's confirmed approval because call data leaves KaiCalls. A new webhook's signing secret is returned once. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.","scope":"webhooks:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"intent":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"missing_fields":{"type":["array","null"],"items":{"type":"string"}},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"request_agent_update","title":"Request Agent Change With Approval","description":"Change a live agent's name, greeting, prompts, voice, model, call length or call transfer through the approval-gated path, for changes made on the owner's behalf that need a recorded approval. Needs agent_id, at least one field to change and the owner's confirmed approval. Callers hear the change on their next call. Direct edits by the owner go through update_agent_config. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"intent":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"missing_fields":{"type":["array","null"],"items":{"type":"string"}},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"request_number_purchase","title":"Request Phone Number Purchase","description":"Buy a specific available phone number for the business from the phone carrier, with the owner's confirmed approval. The carrier bills the number to the business right away. Available numbers come from search_available_numbers. Optionally connects it to agent_id. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.","scope":"numbers:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"intent":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"missing_fields":{"type":["array","null"],"items":{"type":"string"}},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"request_config_rollback","title":"Request Agent Rollback With Approval","description":"Put a live agent back on a saved earlier version of its configuration (listed by list_config_versions), with the owner's confirmed approval. Replaces the current live configuration; callers hear the restored version on their next call. Needs agent_id and version_number or version_id. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"intent":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"missing_fields":{"type":["array","null"],"items":{"type":"string"}},"result":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"join_meeting","title":"Send Kai Into a Meeting","description":"Send Kai into a Zoom, Google Meet, Microsoft Teams or Webex meeting by its link. Kai joins under the agent name, takes notes, and emails the owner a summary when the meeting ends. If the meeting has a waiting room, the host must admit Kai. In the default listen mode it answers out loud when someone says its name and counts against the plan's monthly meeting minutes (a business whose plan includes none gets its first hour free, once); avatar mode joins with a talking video face and counts one avatar meeting. Mirrors POST /api/v1/meetings.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"meeting":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_meeting","title":"Get Meetings","description":"List the meetings Kai was sent into (newest first), or one meeting by id with its live status, minutes used and summary, plus the plan's remaining meeting minutes this month. Mirrors GET /api/v1/meetings.","scope":"agents:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"meetings":{"type":"array","items":{"type":"object"}},"allowance":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"leave_meeting","title":"Take Kai Out of a Meeting","description":"Have Kai leave a video meeting it is in, or stop trying to join one. Kai drops out of the live call for everyone in it and stops taking notes; this cannot be undone, and joining again takes a new join_meeting request. Notes taken so far are kept and can be read with get_meeting. Mirrors DELETE /api/v1/meetings.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"meeting":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"get_usage","title":"Get API Usage","description":"List recent API usage events (endpoint, method, status code, cost) for the caller's account. Mirrors GET /api/v1/usage.","scope":"events:read","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"usage":{"type":"array","items":{"type":"object"}},"has_more":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_plans","title":"List Plans","description":"Read the canonical public KaiCalls plan catalog, monthly USD prices and allowances. Does not select a plan, create checkout, or change billing.","scope":"billing:read","acquisitionStep":"choose_plan","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"plans":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_checkout_status","title":"Get Checkout Status","description":"Read a Stripe-verified subscription checkout receipt for a business you own. Requires business_id and session_id from checkout. Confirmed billing does not prove agent, number, or call activation; get_activation_status reports setup proof. This tool never creates checkout or retries provisioning.","scope":"billing:read","acquisitionStep":"check_payment","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"checkout":{"type":"object"},"billing_only":{"type":"boolean"},"activation_verified":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"send_message","title":"Send Message","description":"Send one message to a business's customer on the channel you choose: a text (sms) from one of the business's agent lines, or a WhatsApp message from its connected WhatsApp number. The same consent, Do-Not-Call, quiet-hours and rate gates as the dashboard apply, and a refusal says which one. sms needs from_agent_id; whatsapp needs a number the owner connected to WhatsApp (pass from when there is more than one) and a customer who messaged that number in the last 24 hours. Email is not sent here; draft_email_campaign drafts a campaign the owner reviews and approves. business_id is required when the account has more than one business. The result reports that the provider accepted the message, not that it was delivered.","scope":"sms:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"id":{"type":["string","null"]},"channel":{"type":["string","null"]},"status":{"type":["string","null"]},"to":{"type":["string","null"]},"from":{"type":["string","null"]},"provider":{"type":["string","null"]},"replayed":{"type":["boolean","null"]},"code":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"request_email_sender","title":"Request Email Sending Domain","description":"Set up a sending address for a business's email campaigns on a domain the business controls (for example mail.example.com). Registers the domain with the email delivery provider and returns the DNS records the owner must add where the domain is hosted. May replace an existing reply address, enabled state and sending limit, and may provision provider inbound routing, inbox and webhook. Sends no email. The sender becomes ready on its own once the records verify; check_email_sender re-checks now. Needs an admin of the business. Campaign email only goes from the business’s own verified sending domain, to customers with recorded email permission who are not on the do-not-email list, within the daily amount the business’s Kai level allows.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"check_email_sender","title":"Check Email Sending Domain","description":"Re-check a sending domain's DNS records with the email delivery provider now and replace its saved verification proof; may finish provider inbound routing, inbox and webhook setup. Returns what is still missing; an empty list means the sender is ready. Sends no email. Any member of the business may check.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"record_email_consent","title":"Record Email Permission","description":"Record that existing customers gave the business permission to email them, with evidence_ref saying where that permission came from. Pass lead_id and email for one customer, or emails for up to 200. Addresses that are not existing customers are skipped and listed. Sends no email. Needs an admin of the business. Each record states that the owner holds that permission.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"revoke_email_consent","title":"Revoke Email Permission","description":"Take back email permission for existing customers so no campaign can email them. Pass lead_id and email for one customer, or emails for up to 200, with evidence_ref saying why. Needs an admin of the business.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"draft_email_campaign","title":"Draft Email Campaign","description":"Save an email campaign for the owner to review: a subject, a plain-text body, the customers to email (lead_ids, each with recorded email permission) and the verified sender. Returns the campaign id and the fingerprint of this exact revision. Sends nothing; the owner approves it with approve_email_campaign and it only goes out after launch_email_campaign. Needs an admin of the business. Campaign email only goes from the business’s own verified sending domain, to customers with recorded email permission who are not on the do-not-email list, within the daily amount the business’s Kai level allows.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"approve_email_campaign","title":"Approve Email Campaign","description":"The business owner approves one exact revision of a drafted email campaign, named by campaign_id and the fingerprint returned by draft_email_campaign or get_email_campaign. A changed draft has a new fingerprint and needs a new approval. Sends nothing; launch_email_campaign queues it. Business owner only.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"launch_email_campaign","title":"Launch Email Campaign","description":"Queue an owner-approved email campaign for sending to real customers, within its daily limit. Business owner only. Emails cannot be unsent once delivered; cancel_email_campaign stops what has not gone out yet. A queued result is not proof any email was delivered. Campaign email only goes from the business’s own verified sending domain, to customers with recorded email permission who are not on the do-not-email list, within the daily amount the business’s Kai level allows.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"cancel_email_campaign","title":"Cancel Email Campaign","description":"Stop an email campaign so nothing more is sent from it. Emails already delivered stay delivered. Needs campaign_id and the fingerprint of its current revision. Business owner only.","scope":"emails:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"action":{"type":["string","null"]},"code":{"type":["string","null"]},"id":{"type":["string","null"]},"senderId":{"type":["string","null"]},"fingerprint":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"get_email_campaign","title":"Get Email Campaign","description":"Read a business's email campaigns: its sending addresses and their setup readiness, recent campaigns with status, revision fingerprint and outcome counts, and the customers who can be emailed (recorded consent, not on the do-not-email list). Pass campaign_id for one campaign, or sender_id for the DNS records that sending address's domain needs. Read-only; any member of the business can read.","scope":"emails:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"code":{"type":["string","null"]},"senders":{"type":"array","items":{"type":"object"}},"campaigns":{"type":"array","items":{"type":"object"}},"audience":{"type":"array","items":{"type":"object"}},"records":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"set_conversation_owner","title":"Set Conversation Owner","description":"Set who answers a customer's text conversation. owner 'ai' (the default): Kai replies. 'human': Kai stays quiet and the business owner answers. 'external': Kai stays quiet and the business's own system answers; it receives the sms.received webhook and replies with send_message or POST /v1/messages. With external_reply_timeout_seconds (external only, 60 to 86400), Kai answers a message nothing replied to in that time. Messages are always stored and sms.received always fires. Pass conversation_id for one conversation, or phone for every conversation the business has with that customer. Re-sending the same owner changes nothing.","scope":"sms:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"conversation_id":{"type":["string","null"]},"owner":{"type":["string","null"]},"owner_set_at":{"type":["string","null"]},"external_reply_timeout_seconds":{"type":["integer","null"]},"conversations":{"type":"array"},"code":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_business_verification","title":"Get Business Verification Documents","description":"Read tenant-scoped business-verification document references, pending/approved/rejected staff-review states and secure upload requirements. No file bytes, storage paths, signed URLs or tax identifiers. Uploads happen on the secure owner page, by an admin; rejected documents can be corrected and uploaded again. Internal staff verification is separate from carrier registration. Reviewer notes are returned as staff-written data.","scope":"workspaces:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"documents":{"type":"array","items":{"type":"object"}},"has_more":{"type":"boolean"},"upload_url":{"type":"string"},"upload_requirements":{"type":"object"},"provider_submission":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"submit_text_registration","title":"Text Registration Submission Availability","description":"Reserved submission contract; execution is currently unavailable and returns submission_unavailable without filing. Shared durable reservation and unknown-outcome reconciliation across dashboard, checkout and cron are prerequisites. Preparation and status are handled by get_text_registration and save_text_registration_details. Saving corrected details does not resubmit existing rejected provider objects: operator reconciliation is required. Another entry point or a new paid registration would duplicate the filing. It accepts no tax identifiers, credentials, file contents or legal attestations. Owner membership and billing:write required.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"prerequisite":{"type":"string"},"submission_attempted":{"type":"boolean","const":false}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"get_text_registration","title":"Get Text Registration","description":"Read where a business stands on its own carrier registration for business texting: saved details (never the EIN; only whether one is on file), payment, filing stage, whether sales texts are allowed, and the one next step. In MCP, `known` excludes fields the canonical flow still requires the owner to confirm; `suggestions` preserves those nonprivate values and available provenance. `missing` is the ordered outstanding field-question list, with missing_value or confirmation_required reasons; `next_question` is its first item. `question_progress` counts field questions including next, not website screens. Website screens group several fields and may include a private identity step; unequal counts can be valid. The MCP presentation separates configured registration/enrollment from recipient-specific sending permission and delivery, which remain not_checked. A null own registration does not prove an enrolled platform route cannot text; configured lines do not prove a send is authorized. Dashboard/API presentation is unchanged. Read-only.","scope":"billing:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"registration":{"type":["object","null"]},"sending_permission":{"type":"string","enum":["not_checked"]},"delivery":{"type":"string","enum":["not_checked"]},"account_route":{"type":"string","enum":["not_checked"]},"recipient_checks":{"type":"string","enum":["not_checked"]},"textingLines":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string"},"state":{"type":"string","enum":["configured","adding","in_review","sent_back","registering_next","not_registered","paused"]},"text":{"type":"string"},"configuration_state":{"type":"string","enum":["registration_or_enrollment_recorded"]},"sending_permission":{"type":"string","enum":["not_checked"]}},"required":["number","state","text","sending_permission"]}},"chasers":{"type":"object"},"addon":{"type":"object"},"known":{"type":"object","properties":{"legal_business_name":{"type":"string"},"business_type":{"type":"string"},"industry":{"type":"string"},"website_url":{"type":"string"},"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postal_code":{"type":"string"},"contact_first_name":{"type":"string"},"contact_last_name":{"type":"string"},"contact_email":{"type":"string"},"contact_phone":{"type":"string"},"contact_job_position":{"type":"string"},"contact_title":{"type":"string"},"text_types":{"type":"string"}},"additionalProperties":false},"suggestions":{"type":"object","properties":{"legal_business_name":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"business_type":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"industry":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"website_url":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"street":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"city":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"state":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"postal_code":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_first_name":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_last_name":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_email":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_phone":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_job_position":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"contact_title":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false},"text_types":{"type":"object","properties":{"value":{"type":"string"},"source":{"type":"string","enum":["saved","caller_id","business","owner","default"]}},"required":["value"],"additionalProperties":false}},"additionalProperties":false},"missing":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["legal_business_name","business_type","industry","website_url","street","city","state","postal_code","contact_first_name","contact_last_name","contact_email","contact_phone","contact_job_position","contact_title","text_types"]},"question":{"type":"string"},"why":{"type":"string"},"suggestion":{"type":"string"},"reason":{"type":"string","enum":["missing_value","confirmation_required"]}},"required":["field","question","reason"],"additionalProperties":false}},"next_question":{"anyOf":[{"type":"object","properties":{"field":{"type":"string","enum":["legal_business_name","business_type","industry","website_url","street","city","state","postal_code","contact_first_name","contact_last_name","contact_email","contact_phone","contact_job_position","contact_title","text_types"]},"question":{"type":"string"},"why":{"type":"string"},"suggestion":{"type":"string"},"reason":{"type":"string","enum":["missing_value","confirmation_required"]}},"required":["field","question","reason"],"additionalProperties":false},{"type":"null"}]},"question_progress":{"type":"object","properties":{"unit":{"type":"string","enum":["field_questions"]},"remaining":{"type":"integer","minimum":0},"includes_next_question":{"const":true}},"required":["unit","remaining","includes_next_question"],"additionalProperties":false},"ein_on_file":{"type":"boolean"},"next_step":{"type":"string"},"next_step_text":{"type":"string"},"setup_url":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"save_text_registration_details","title":"Save Text Registration Details","description":"Save a business's legal name, entity type, industry, website, address, authorized contact and what it will text (service only, or service and sales) for its own carrier registration. Business owner only. Each field holds an answer from the owner; anything omitted is filled from what is already on file (see get_text_registration `known`). Answers can be saved one at a time: answers given so far are kept, and while questions remain the result lists `saved_steps`, `missing` and `next_question`. The owner can finish here or on the registration page. Never takes the EIN: the owner types it on the registration page returned as setup_url. Each saved answer replaces the value on file for that field. Refused once a filing is already with the carriers. Charges nothing and files nothing.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"saved":{"type":"boolean"},"saved_steps":{"type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"object"}},"next_question":{"type":"object"},"registration":{"type":"object"},"consent_url":{"type":"string"},"next_step":{"type":"string"},"next_step_text":{"type":"string"},"setup_url":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"start_text_registration_checkout","title":"Start Text Registration Checkout","description":"Create the payment link for a business's own carrier registration (a one-time filing fee plus a monthly campaign fee). Business owner only, and only once the details and the EIN are saved. Returns checkout_url for the owner to open and pay; nothing is charged by this tool, and filing starts only after payment. A checkout_url means neither payment nor filing. On a plan that includes registration there is nothing to pay: the tool sends it to the carriers straight away and returns included_in_plan and filed true instead of a link, so that path requires confirm_submission true, which records that the owner reviewed and confirmed the saved details and external submission. Submission is not carrier approval. The tool takes no EIN, document contents, credentials or legal attestations.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"checkout_url":{"type":"string"},"one_time_usd":{"type":"number"},"monthly_usd":{"type":"number"},"charged":{"type":"boolean"},"included_in_plan":{"type":"boolean"},"filed":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"set_branded_caller_id","title":"Set Branded Caller ID","description":"File the business name that landlines show when the business's number calls out (caller ID name). Included with the business's own text registration once it is paid; charges nothing. Business owner only. The name must be at most 15 characters, start with a letter, and use only letters, numbers, periods, commas and spaces (get_text_registration returns a suggestion in branded_caller_id.suggestedName). Files with the carriers once the business profile is approved; review then takes a day or two and carriers show it within 72 hours. US local numbers only. The result confirms the filing, not that the name is showing on calls.","scope":"billing:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"branded_caller_id":{"type":"object"},"charged":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"create_customer_workspace","title":"Create Customer Workspace","description":"Create a new KaiCalls account for a business, owned by the business owner's own email address. It lets a partner or helper set up KaiCalls for a business owner. The account starts without a plan or phone number: the result includes a link the owner opens themselves to choose a plan and add their card, and the line is set up only after they pay. This tool charges nothing. By default the caller is added as an admin of the new account so they can continue setup (get_setup_checklist lists the steps); join_as_admin false skips that. partner_code credits a referring partner and does not apply to a partner's own account. Fails, creating nothing, if the email already has a KaiCalls account.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"owner_email":{"type":"string"},"checkout_url":{"type":["string","null"]},"joined_as_admin":{"type":"boolean"},"partner_linked":{"type":"boolean","description":"Present for a partner-scoped key: the new business is linked to the partner."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"set_up_business","title":"Customize Business Line","description":"Optional line customization: sets the business name and greeting Kai answers with, as the owner requested. Not required to make calls, and never changes payment, usage or fraud limits. Extra business details are optional; no business-qualification questionnaire is needed. An existing business greeting is left unchanged.","scope":"workspaces:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"already_business":{"type":"boolean"},"changed":{"type":"boolean"},"persona_mode":{"type":"string"},"greeting_updated":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_setup_checklist","title":"Get Setup Checklist","description":"Read where one business stands on setup: plan, phone number, texting registration, WhatsApp, call and lead alerts, connected mailbox for follow-up email, and email campaign sender. Each step has a state (done, in_progress, needs_owner, needs_action or unavailable) and one next action: either the tool that moves it forward, or the page the owner must open for steps only they can do, such as paying, typing their EIN or signing in to Facebook or Google. Read-only; changes nothing and contacts no one.","scope":"workspaces:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"checklist":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"connect_whatsapp","title":"Connect WhatsApp","description":"Get the one link a business owner opens to put WhatsApp on their KaiCalls number. They sign in to Facebook as an admin of the business's Meta Business account and verify the number; the business owns its WhatsApp account. Uses the business's oldest KaiCalls line unless phone_number names another of its lines. Returns the same link while it is still valid (up to 3 days). Owner or admin only. Creates nothing billable and connects nothing by itself: get_whatsapp_status reports the connection after the owner finishes, and WhatsApp is not connected until it says so.","scope":"sms:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"whatsapp":{"type":"object"},"created":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_whatsapp_status","title":"Get WhatsApp Status","description":"Check whether WhatsApp is connected on a business's KaiCalls number, read live from the carrier. Connected only once the number is verified for WhatsApp; otherwise says whether the owner's link is still waiting, expired or failed.","scope":"sms:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"connected":{"type":"boolean"},"connections":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_channel_status","title":"Get Channel Status","description":"Read customer channel setup. Phone calls report configured number resources only: state configured or needs_setup, with canSend/canReceive null because operational availability is unknown. SMS has state not_checked and null send/receive flags; shared_setup_state retains the existing configuration summary, not recipient-specific permission. Registration detail requires billing:read; this SMS-scope summary reads no new billing details. Other channels retain their existing states and flags. private_test_readiness checks owner-private call setup only when the token also has agents:read; otherwise it is not_checked with reconnect scope guidance. Private testing does not establish customer coverage or outbound call permission, which remain not_checked. Email includes separate managedEmail campaign sender readiness; a connected mailbox does not prove campaign approval or delivery. Read-only; changes nothing.","scope":"sms:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"private_test_readiness":{"type":"object","oneOf":[{"properties":{"status":{"type":"string","enum":["not_checked"]},"required_scope":{"type":"string","enum":["agents:read"]},"next_tool":{"type":"string","enum":["get_activation_status"]}},"required":["status","required_scope","next_tool"],"additionalProperties":false},{"properties":{"status":{"type":"string","enum":["ready","owner_required","entitlement_required","number_not_ready","session_stale","unavailable"]},"next_action":{"type":["string","null"]}},"required":["status","next_action"],"additionalProperties":false}]},"customer_coverage":{"type":"string","enum":["not_checked"]},"outbound_call_permission":{"type":"string","enum":["not_checked"]},"channels":{"type":"array","items":{"type":"object","allOf":[{"if":{"properties":{"channel":{"const":"sms"}},"required":["channel"]},"then":{"properties":{"state":{"const":"not_checked"},"canSend":{"type":"null"},"canReceive":{"type":"null"}},"required":["state","canSend","canReceive","shared_setup_state","shared_setup_next_step","sending_permission","delivery","account_route","recipient_checks"]}}],"properties":{"channel":{"type":"string"},"label":{"type":"string"},"availability":{"type":"string","enum":["live","built_off","planned"]},"state":{"type":"string","enum":["not_checked","configured","ready","needs_setup","blocked","not_available"]},"canSend":{"type":["boolean","null"]},"canReceive":{"type":["boolean","null"]},"nextStep":{"type":["object","null"]},"shared_setup_state":{"type":"string","enum":["ready","needs_setup","blocked","not_available"]},"shared_setup_next_step":{"type":["object","null"]},"sending_permission":{"type":"string","enum":["not_checked"]},"delivery":{"type":"string","enum":["not_checked"]},"account_route":{"type":"string","enum":["not_checked"]},"recipient_checks":{"type":"string","enum":["not_checked"]},"configuration_state":{"type":"string","enum":["number_assigned","number_missing"]}}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"get_trust_level","title":"Get Trust Level","description":"Read one business's KaiCalls trust level (Sprout, Verified, Trusted, Pro, Partner): the current level, the steps to the next one with progress, what each level unlocks, today's outbound calls and texts against current effective account limits, and any hold. Badge progress does not itself establish higher call or text caps. focus 'ladder' explains every level; focus 'level' with level explains one. Read-only: returns saved standing or computes missing/stale standing without saving it or sending notifications. recheck_trust_level recomputes and saves current standing. Levels are earned, never set: no tool can raise one.","scope":"agents:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"level":{"type":"object"},"next":{"type":["object","null"]},"next_opens_later":{"type":"boolean"},"quests":{"type":"array","items":{"type":"object"}},"progress":{"type":"number"},"held":{"type":["string","null"]},"ladder":{"type":"array","items":{"type":"object"}},"meters":{"type":"array","items":{"type":"object"}},"detail":{"type":["object","null"]},"rechecked":{"type":"boolean"},"moved":{"type":["string","null"],"enum":["up","down",null]},"previous_level":{"type":["string","null"]},"computed_at":{"type":"string"},"line":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"recheck_trust_level","title":"Recheck Trust Level","description":"Recompute one business's KaiCalls trust level now from its live account activity (card on file, paid bills, days active, real customer calls) and save the result, the same recheck the dashboard runs, for example right after the owner adds a card. Returns the same view as get_trust_level plus whether the level moved up or down. Requires current business membership. Replaces the saved derived state, may record level-change history and may email the current owner when standing changes. It can only reflect what the account has earned; it never sets or raises a level by request.","scope":"agents:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"level":{"type":"object"},"next":{"type":["object","null"]},"next_opens_later":{"type":"boolean"},"quests":{"type":"array","items":{"type":"object"}},"progress":{"type":"number"},"held":{"type":["string","null"]},"ladder":{"type":"array","items":{"type":"object"}},"meters":{"type":"array","items":{"type":"object"}},"detail":{"type":["object","null"]},"rechecked":{"type":"boolean"},"moved":{"type":["string","null"],"enum":["up","down",null]},"previous_level":{"type":["string","null"]},"computed_at":{"type":"string"},"line":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"get_balance","title":"Get Balance","description":"Get plan terms and usage for accessible businesses. No-card trials report 25 lifetime minutes, zero price and no overage; paid plans report the mapped subscription price and billing-cycle usage. Answered-call allowance usage is the raw billable call count, matching dashboard and right-sizing. A separate weighted count is informational only, not allowance consumption or right-sizing. Phone allowance includes purchased extra lines. A balance does not prove activation or inbound routing. Mirrors GET /api/v1/balance; unavailable billing data returns an error.","scope":"billing:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"businesses":{"type":"array","items":{"type":"object","properties":{"business_id":{"type":"string"},"plan_key":{"type":"string"},"plan_name":{"type":"string"},"price_monthly":{"type":"number","description":"Mapped subscription base price in USD; zero for no-card trial. Excludes add-ons and tax."},"allowance_model":{"type":"string","enum":["minutes","answered_calls"]},"minutes_used":{"type":"number"},"minutes_allowance":{"type":"number"},"answered_calls_used":{"type":["number","null"],"description":"Raw billable call count used for allowance reporting, matching dashboard and right-sizing; null for minute plans."},"answered_calls_raw":{"type":["number","null"],"description":"Unweighted billable call count for reporting."},"answered_calls_weighted":{"type":["number","null"],"description":"Informational only, not allowance consumption or right-sizing: ordinary calls 1, human-answered silent-listen calls 0.5; null for minute plans."},"answered_calls_allowance":{"type":["number","null"]},"phone_numbers":{"type":"integer","description":"Active registered numbers, including unassigned numbers."},"phone_numbers_allowance":{"type":"integer"},"subscription_status":{"type":"string"},"overage_allowed":{"type":"boolean"},"period_start":{"type":"string"},"period_end":{"type":["string","null"],"description":"Null for lifetime trial usage; does not imply the trial cannot expire."},"period_kind":{"type":"string","enum":["lifetime_trial","billing_cycle"]}},"required":["business_id","plan_key","plan_name","price_monthly","allowance_model","minutes_used","minutes_allowance","answered_calls_used","answered_calls_raw","answered_calls_weighted","answered_calls_allowance","phone_numbers","phone_numbers_allowance","subscription_status","overage_allowed","period_start","period_end","period_kind"]}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_checkout","title":"Create or Resume Checkout","description":"Create, or reuse, a secure payment page hosted by Stripe where the business owner pays for a KaiCalls plan from list_plans with their own card. Needs business_id, plan_id and an idempotency_key: retrying with the same key returns the same page, and choosing a different plan needs a new key. This tool charges nothing; only the owner can pay, by opening the page themselves. It never proves payment or that the phone line is live: get_checkout_status reports payment for the returned session_id.","scope":"billing:write","acquisitionStep":"start_checkout","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"url":{"type":["string","null"]},"session_id":{"type":["string","null"]},"status":{"type":["string","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}},{"name":"list_numbers","title":"List Phone Numbers","description":"List phone numbers assigned to the accessible business(es), with capability and compliance flags. Assignment does not prove a successful inbound test or customer coverage. get_activation_status reports current readiness and private-test proof. Forwarding is an optional customer route. Mirrors GET /api/v1/numbers.","scope":"numbers:read","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"numbers":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_phone_flow","title":"Get Phone Flow","description":"Read how calls ring on the business's hosted phone system: which cells and desk phones ring, for how many seconds, and whether after-hours callers go straight to Kai. Reconciled from the phone system on every call. Mirrors POST /api/v1/phone-system action=get_flow. Returns 409 when the hosted phone system is not set up for this business.","scope":"numbers:read","acquisitionStep":"set_up_phone_system","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"flow":{"type":"object"},"readback":{"type":"string","description":"One-sentence plain-English description."},"line":{"type":["string","null"]},"kai_extension":{"type":"string"},"business_hours_available":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_phone_flow","title":"Update Phone Flow","description":"Replace how calls ring on the business's hosted phone system with a full phone flow: { version: 1, hours: { mode: 'always' | 'business_hours', afterHours: 'kai' }, ring: { members: [{ kind: 'cell', phone: E.164, label, requirePressOne } | { kind: 'desk_phone' | 'user', userId, label }], timeoutSeconds: 5-120 }, overflow: 'kai' }. Applied idempotently (only real differences are written); every member passes the forwarding-loop guard; business_hours mode derives the schedule from the business hours already on file. Because it replaces the whole flow, the input is the full flow as get_phone_flow returns it, with changes applied. Mirrors POST /api/v1/phone-system action=save_flow.","scope":"numbers:write","acquisitionStep":"set_up_phone_system","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"flow":{"type":"object"},"readback":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"set_up_phone_system","title":"Set Up Phone System","description":"Turn the business's number into a hosted phone system: Kai is installed as extension 700, the owner's mobile joins the list of phones to ring first, and calls reach Kai when nobody picks up. Idempotent and resumable — a re-run reuses everything already created and reports it under `reused`. Needs a complete US street address on file (the emergency-services and tax location) and the owner's mobile: when either is missing the tool fails with `code` missing_address or missing_owner_mobile plus `required_field` and `next_action` naming exactly what is missing, which business_address or owner_mobile accepts. Returns the status shape (existing setup IDs, extension and the phone-system line) and `next_step`, the owner's next action in one line (forward your line here / dial 700 from any office phone). Mirrors POST /api/v1/phone-system action=provision.","scope":"numbers:write","acquisitionStep":"set_up_phone_system","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"provisioned":{"type":"boolean"},"kai_extension":{"type":"string"},"ids":{"type":"object"},"line":{"type":["string","null"],"description":"The phone-system line (E.164), if a number is attached."},"created":{"type":"array","items":{"type":"string"}},"reused":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"next_step":{"type":"string","description":"The one line to relay to the owner."},"code":{"type":"string","description":"Present when success is false."},"required_field":{"type":"string","enum":["business_address","owner_mobile"],"description":"Present when setup is blocked on a missing input."},"next_action":{"type":"string","description":"What to collect and how to retry, when blocked."},"issues":{"type":"array","description":"Address fields to correct when code is invalid_address.","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"get_phone_system_status","title":"Get Phone System Status","description":"Read saved phone-system configuration: extension, resource IDs (never secrets), assigned line, and agreement. phone_system_configuration.configuration_allows_calls means provisioned resources plus a permitting agreement only; it does not verify calls can connect. ready_for_calls is null because operational availability is unknown. private_test_readiness uses the existing owner-private call setup authority only with agents:read; otherwise not_checked. Customer coverage and outbound call permission remain not_checked. This read differs from the shared phone-system API configuration flag and changes nothing.","scope":"numbers:read","acquisitionStep":"confirm_live","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"ready_for_calls":{"type":"null"},"phone_system_configuration":{"type":"object","properties":{"provisioned":{"type":"boolean"},"agreement":{"type":"string"},"configuration_allows_calls":{"type":"boolean"}},"required":["provisioned","agreement","configuration_allows_calls"],"additionalProperties":false},"private_test_readiness":{"type":"object","oneOf":[{"properties":{"status":{"type":"string","enum":["not_checked"]},"required_scope":{"type":"string","enum":["agents:read"]},"next_tool":{"type":"string","enum":["get_activation_status"]}},"required":["status","required_scope","next_tool"],"additionalProperties":false},{"properties":{"status":{"type":"string","enum":["ready","owner_required","entitlement_required","number_not_ready","session_stale","unavailable"]},"next_action":{"type":["string","null"]}},"required":["status","next_action"],"additionalProperties":false}]},"customer_coverage":{"type":"string","enum":["not_checked"]},"outbound_call_permission":{"type":"string","enum":["not_checked"]},"provisioned":{"type":"boolean"},"provisioned_at":{"type":["string","null"]},"kai_extension":{"type":["string","null"]},"ids":{"type":"object"},"line":{"type":["string","null"]},"next_step":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"add_team_phone","title":"Add Team Phone","description":"Add a teammate's (or the owner's) cell to the phones that ring before Kai answers. Idempotent — a cell already listed is reported as already included. Owners and admins are also registered on the admin roster, so calling the business line from that cell reaches the admin secretary; a member only rings. The business's own forwarded-from office line is refused (forwarding_loop) because ringing it would bounce the call straight back. Requires the phone system to be set up first (set_up_phone_system). Mirrors POST /api/v1/phone-system action=add_ring_group_member.","scope":"numbers:write","acquisitionStep":"set_up_phone_system","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"member":{"type":"object","properties":{"phone_number":{"type":"string"},"name":{"type":["string","null"]},"role":{"type":"string"},"ring_group":{"type":"string","enum":["added","already_member"]},"admin_roster":{"type":"string","enum":["registered","skipped_member_role","failed"]}}},"code":{"type":"string","description":"Present when success is false."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"list_conversations","title":"List SMS Conversations","description":"List SMS conversation threads (counterparty timeline metadata) for the authenticated business, most recent first. Mirrors GET /api/v1/sms/conversations.","scope":"sms:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"conversations":{"type":"array","items":{"type":"object"}},"has_more":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_conversation","title":"Get SMS Conversation","description":"Get a single SMS conversation thread by ID. Mirrors GET /api/v1/sms/conversations?id=.","scope":"sms:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"conversation":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_webhook","title":"Get Webhook Configuration","description":"List the configured outbound webhook(s) for a business, including supported event types. Mirrors GET /api/v1/webhooks.","scope":"webhooks:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"webhooks":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"set_webhook","title":"Set Webhook","description":"Create or update a business outbound webhook (URL + subscribed events). Returns a webhook secret on first creation only. Mirrors POST /api/v1/webhooks.","scope":"webhooks:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"webhook":{"type":"object"},"webhook_secret":{"type":["string","null"]},"events":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"delete_webhook","title":"Delete Webhook","description":"Remove a business outbound webhook by ID. Mirrors DELETE /api/v1/webhooks.","scope":"webhooks:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"message":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_evals","title":"List Agent Evals","description":"List canned mock-conversation eval scenarios for an agent (or all accessible agents). Mirrors GET /api/v1/evals.","scope":"evals:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"evals":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"run_eval","title":"Run Agent Eval","description":"Run a saved test scenario against one of the business's agents and grade the agent's replies: pass eval_id for one scenario, or agent_id for every scenario saved for that agent (see list_evals). The test is a simulated text conversation with the agent's current live configuration; no phone call is placed, no customer is contacted and the agent's configuration is not changed. Each run uses paid voice-agent provider capacity and is recorded with its result. Returns pass or fail per scenario with the grader's reasons. Mirrors POST /api/v1/evals/run.","scope":"evals:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"run_id":{"type":["string","null"]},"provider_run_id":{"type":["string","null"]},"status":{"type":["string","null"]},"passed":{"type":["boolean","null"]},"results":{"type":["array","object","null"]},"total":{"type":["integer","null"]},"completed":{"type":["integer","null"]},"failed":{"type":["integer","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}},{"name":"find_voices","title":"Find Voices for an Agent","description":"Find the three voices that best match a plain description of what the owner wants (for example 'a Southern man who can also speak Spanish' or 'warm older woman, calm'), and get a page link where the owner can play each one in English and Spanish, pick one to switch the agent's voice, and undo within 24 hours. Show the owner the page link; nothing changes until they pick. The link expires in 7 days.","scope":"agents:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"page_url":{"type":"string"},"expires_at":{"type":"string"},"voices":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_voices","title":"List Voice Catalog","description":"List the curated, credential-free voice catalog (id, display name, accent, language, gender, sample URL) used to configure agent voices. Mirrors GET /api/v1/voices.","scope":"agents:read","acquisitionStep":"choose_voice","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"voices":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_agent","title":"Create Agent","description":"Create a new KaiCalls agent — the secretary that answers this business’s calls (the live voice agent plus KaiCalls records) — with a system prompt, greeting, voice, and model. Mirrors POST /api/v1/agents. Every subsequent mutation to this agent is versioned (assistant_config_versions) and reversible via rollback_config — history is listed by get_change_history / list_config_versions. Compliance: KaiCalls automatically applies state-aware AI-disclosure and consent handling to every agent it provisions, and flags high-risk business categories for extra review.","scope":"agents:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"agent":{"type":"object"},"compliance":{"type":"object","properties":{"high_risk_category":{"type":"boolean"},"disclosure_note":{"type":"string"}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"attach_number","title":"Attach Phone Number","description":"Assign a phone number already in the KaiCalls registry pool to a business (and optionally route it directly to an agent). Does NOT purchase a new number; search_available_numbers and buy_number handle purchases. Mirrors POST /api/v1/phone-numbers.","scope":"numbers:write","acquisitionStep":"connect_number","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"number":{"type":"object"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"set_owner_phone","title":"Set Owner Phone","description":"Saves the owner's own mobile number on the business record (the number Kai texts whenever it takes a call for the owner) so Kai can ring it first and so activation/forwarding follow-ups can reach a human — connecting a number alone does not prove the owner can be reached. In the acquisition flow this step comes before search_available_numbers and buy_number (#2086). US numbers only; normalized to E.164 and rejected if it cannot be validated as a US mobile/landline number. When ring_first is true (default), also configures ring-first routing so calls hit this cell before overflowing to the secretary — the same path used at signup. declined=true, in place of owner_phone, records a caller who declines to give a number as an inquiry: a KaiCalls lead, with no provisioned business or number.","scope":"agents:write","acquisitionStep":"collect_owner_phone","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"business_id":{"type":"string"},"owner_phone_masked":{"type":["string","null"]},"owner_phone_present":{"type":"boolean"},"ring_first_applied":{"type":"boolean"},"ring_first_status":{"type":["string","null"]},"next_step":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"detach_number","title":"Detach Phone Number","description":"Release a phone number from a business back to the unassigned registry pool. Mirrors DELETE /api/v1/phone-numbers.","scope":"numbers:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"released_phone_number":{"type":"string"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"search_available_numbers","title":"Search Available Numbers","description":"Search the carrier for phone numbers available to purchase (live number inventory). Mirrors GET /api/v1/phone-numbers/search. In the acquisition flow this follows set_owner_phone, which saves a reachable owner number or records a decline.","scope":"numbers:read","acquisitionStep":"find_number","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"available_numbers":{"type":"array","items":{"type":"string"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"buy_number","title":"Buy Phone Number","description":"Request a real phone-number purchase. This is APPROVAL-GATED: the carrier bills immediately on execution, so the tool only prepares a request for authenticated owner review. Caller-supplied human_confirmed, dashboard_session, or system_policy fields never authorize execution. Returns the stored request and a review URL for the owner; while approval is pending, no number has been purchased. Existing entitlement and carrier reservation checks still apply. Mirrors POST /api/v1/phone-numbers/purchase via numbers.purchase. In the acquisition flow this follows set_owner_phone, which saves a reachable owner number or records a decline.","scope":"numbers:write","acquisitionStep":"buy_number","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"result":{"type":["object","null"],"description":"On executed: { number, vapi_registered, agent_attached, compliance: { high_risk_category, disclosure_note } }."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true}},{"name":"list_knowledge","title":"List Agent Knowledge","description":"List agent knowledge base entries for a business. Mirrors GET /api/v1/knowledge.","scope":"knowledge:read","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"knowledge":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"upsert_knowledge","title":"Create or Update Agent Knowledge","description":"Create a new agent knowledge base entry, or update one when `id` is provided. Mirrors POST /api/v1/knowledge. Creating requires title, content, and content_type.","scope":"knowledge:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"knowledge":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"list_products","title":"List Agent Products","description":"List a business's agent product catalog. Mirrors GET /api/v1/products.","scope":"products:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"products":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"upsert_product","title":"Create or Update Agent Product","description":"Create a new product row, or update one when `id` is provided. Mirrors POST /api/v1/products. Creating requires name and business_id. Pass `quantity` to set/update inventory.","scope":"products:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"product":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},{"name":"list_config_versions","title":"List Agent Config Versions","description":"List an agent's hashed, redacted assistant config version history (rollback lineage included). Pass `version` to fetch one version's full redacted config_snapshot instead of the list. Mirrors GET /api/v1/agents/versions.","scope":"agents:read","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"agent_id":{"type":"string"},"versions":{"type":"array","items":{"type":"object"}},"version":{"type":["object","null"]}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_change_history","title":"Get Agent Change History","description":"List an agent's recent config-change audit trail (change_type, change_source, old/new value, timestamp) from admin_change_history — the same record the admin_get_change_history voice tool reads over the phone. Every mutation KaiCalls makes to an agent (via update_agent_config, configure_agent_business_rules, the admin call-in secretary, or the dashboard) is logged here and reversible with rollback_config.","scope":"agents:read","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"agent_id":{"type":"string"},"changes":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"rollback_config","title":"Rollback Agent Configuration","description":"Request a rollback to a prior assistant_config_versions snapshot. This changes live greeting, voice, prompt and model settings. When the business owner or an admin is signed in through this connector, the rollback applies immediately; otherwise authenticated owner review of the exact stored request is required (the owner is notified with a review link). Caller-supplied authority fields never authorize execution. Targets are listed by list_config_versions and get_change_history; a pending request returns its review URL for the owner. The agent.config.rollback executor preserves version recording and secret exclusion after trusted approval.","scope":"agents:write","acquisitionStep":"create_secretary","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"status":{"type":"string"},"code":{"type":["string","null"]},"agent_id":{"type":"string"},"business_id":{"type":["string","null"]},"request_id":{"type":["string","null"]},"risk_level":{"type":["string","null"]},"message":{"type":["string","null"]},"approval":{"type":["object","null"]},"summary":{"type":["object","null"]},"result":{"type":["object","null"],"description":"On executed: { agent_id, restored_from_version, restored_fields, skipped_fields, new_version_number, warning? }."}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_observability_events","title":"List Observability Events","description":"List a business-scoped timeline of compact call-runtime events and redacted integration-delivery attempts. Mirrors GET /api/v1/observability-events and uses bounded keyset pagination.","scope":"events:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"events":{"type":"array","items":{"type":"object"}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_tool_execution_logs","title":"List Tool Execution Logs","description":"List per-call voice-agent tool execution traces — outcome, latency, timeout, and a redacted result preview for each routed tool call. Mirrors GET /api/v1/tool-execution-logs. Answers \"did this tool call actually work\".","scope":"events:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"logs":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_subscription_history","title":"List Subscription Change History","description":"List plan/price change history from subscription_change_history — the billing analogue of admin_change_history, written from the Stripe webhook and the right-size apply job. Mirrors GET /api/v1/subscription-history.","scope":"billing:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"changes":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_overage_charges","title":"List Overage Charges","description":"List the idempotent overage-minutes ledger from billing_overage_charges (legacy per-minute-overage tiers only — 2026 plans carry no overage). GET /v1/balance/get_balance only returns an aggregate; this returns the underlying per-period ledger rows. Mirrors GET /api/v1/overage-charges.","scope":"billing:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"charges":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_rightsize_recommendations","title":"List Plan Right-Size Recommendations","description":"List per-period auto-right-size decisions from plan_rightsize_recommendations, including the dry_run -> notified -> (kept | applied | superseded) lifecycle. Answers \"is this business about to get right-sized\". Mirrors GET /api/v1/rightsize-recommendations.","scope":"billing:read","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"recommendations":{"type":"array","items":{"type":"object"}}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"report_issue","title":"Report an Issue","description":"Report a problem with your KaiCalls agent, phone number, billing, or account. Saves the report to your change history and notifies KaiCalls support so a person can follow up on anything broken or not working as expected.","scope":"support:write","outputSchema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the tool completed successfully"},"error":{"type":"string","description":"Present when success is false"},"business_id":{"type":"string"},"report_id":{"type":"string"},"severity":{"type":"string"},"category":{"type":"string"},"support_notified":{"type":"boolean"}},"required":["success"],"additionalProperties":true},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"protocol":"MCP","transports":["streamable-http"]}