{"name":"Mango Desk","description":"AI office manager for service businesses. Public REST and authenticated MCP expose explicit scope-filtered integrations; Console Aimee uses a separate session-bound private MCP registry for owner operations.","documentation":"https://mangodesk.app/developers","llms_txt":"https://mangodesk.app/llms.txt","status":"live","contact":"developers@mangoreceptionist.com","mcp":{"protocol":{"supported_versions":["2026-07-28","2025-11-25","2025-06-18","2025-03-26"],"default_for_standard_clients":"2025-11-25","handshake":"Send a normal JSON-RPC `initialize` with your protocolVersion, capabilities and clientInfo. The server negotiates a supported revision and replies with capabilities and serverInfo. Mcp-Session-Id is accepted and ignored; no bespoke headers are needed.","stateless_dialect":{"version":"2026-07-28","note":"Opt-in only. Declare this version in MCP-Protocol-Version (and params._meta) to use the stateless dialect: no handshake, per-request _meta, and Mcp-Method / Mcp-Name headers that must match the request."}},"marketing":{"url":"https://mangodesk.app/mcp","transport":"streamable-http","auth":"none","status":"live"},"public_receptionist":{"url":"https://mangodesk.app/mcp/t/{embedKey}","transport":"streamable-http","auth":"embed_key_path","status":"live"},"authenticated":{"url":"https://mangodesk.app/mcp/v1","transport":"streamable-http","auth":["api_key","oauth2.1_pkce"],"status":"live","exposure":"published_scope_filtered_tools_only"},"console_internal":{"transport":"json-rpc","auth":"authenticated_member_session","status":"live","exposure":"private_console_registry; not available to API keys","owner_billing_tools":["billing_plan_options","billing_plan_switch","billing_specialist_agent_set_enabled"]}},"rest":{"base":"https://mangodesk.app/api/v1","openapi":"https://mangodesk.app/api/v1/openapi.json","status":"live"},"webhooks":{"manage":"https://mangodesk.app/console/webhook-endpoints","management_auth":"owner_or_admin_session","signature":"hmac-sha256","header":"Mango-Signature","status":"live"},"auth":{"methods":["api_key","oauth2.1_pkce"],"api_key_format":"mrk_live_… / mrk_test_…","api_key_status":"live","oauth_status":"live","oauth_metadata":"https://mangodesk.app/.well-known/oauth-protected-resource"},"scopes":["contacts:read","contacts:write","work_contexts:read","work_contexts:write","followups:write","calls:read","invoices:read","commercial_proposals:read","schedule:read","integrations:read","schedule:write","bookings:cancel","files:read","messages:send","invoices:write","invoices:issue","invoices:mark_paid","invoices:delete","commercial_proposals:send","commercial_proposals:delete","contacts:delete","work_contexts:delete","followups:delete","files:write","files:send","kb:read","imports:write"],"capability_boundaries":{"public_marketing_mcp":"Public product information and explicit commitment tools only.","public_receptionist_mcp":"Customer-facing assistant for one embed-key tenant; no private Console data.","authenticated_rest_and_mcp":"Only explicitly published, scope-filtered tenant resources and actions. It is not the full Console or internal registry.","console_internal_mcp":"Authenticated member-session projection. Owner-confirmed billing plan and specialist-agent changes live here, never on an external API key."},"capabilities":[{"id":"account.get","title":"Connection test","scope":null,"rest":{"method":"GET","path":"/me"},"mcp":{"name":"account.me","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"contacts.list","title":"List contacts","scope":"contacts:read","rest":{"method":"GET","path":"/contacts"},"mcp":{"name":"contacts.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"contacts.get","title":"Get contact","scope":"contacts:read","rest":{"method":"GET","path":"/contacts/{id}"},"mcp":{"name":"contacts.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"contacts.create","title":"Create or enrich contact","scope":"contacts:write","rest":{"method":"POST","path":"/contacts"},"mcp":{"name":"contacts.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"contacts.update","title":"Update contact","scope":"contacts:write","rest":{"method":"PATCH","path":"/contacts/{id}"},"mcp":{"name":"contacts.update","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"work_contexts.list","title":"List work contexts","scope":"work_contexts:read","rest":{"method":"GET","path":"/work-contexts"},"mcp":{"name":"work_contexts.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"work_contexts.get","title":"Get work context","scope":"work_contexts:read","rest":{"method":"GET","path":"/work-contexts/{id}"},"mcp":{"name":"work_contexts.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"work_contexts.create","title":"Create work context","scope":"work_contexts:write","rest":{"method":"POST","path":"/work-contexts"},"mcp":{"name":"work_contexts.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"work_contexts.update","title":"Update work context","scope":"work_contexts:write","rest":{"method":"PATCH","path":"/work-contexts/{id}"},"mcp":{"name":"work_contexts.update","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"work_contexts.book_appointment","title":"Book work-context appointment","scope":"work_contexts:write","rest":{"method":"POST","path":"/work-contexts/{id}/appointment"},"mcp":{"name":"work_contexts.book_appointment","readOnly":false,"destructive":false,"idempotent":true},"release":"live"},{"id":"followups.list","title":"List follow-ups","scope":"contacts:read","rest":{"method":"GET","path":"/followups"},"mcp":{"name":"followups.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"followups.get","title":"Get follow-up","scope":"contacts:read","rest":{"method":"GET","path":"/followups/{id}"},"mcp":{"name":"followups.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"followups.create","title":"Create follow-up","scope":"followups:write","rest":{"method":"POST","path":"/followups"},"mcp":{"name":"followups.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"followups.complete","title":"Complete follow-up","scope":"followups:write","rest":{"method":"POST","path":"/followups/{id}/complete"},"mcp":{"name":"followups.complete","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"calls.list","title":"List calls","scope":"calls:read","rest":{"method":"GET","path":"/calls"},"mcp":{"name":"calls.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"calls.get","title":"Get call","scope":"calls:read","rest":{"method":"GET","path":"/calls/{id}"},"mcp":{"name":"calls.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"invoices.list","title":"List invoices","scope":"invoices:read","rest":{"method":"GET","path":"/invoices"},"mcp":{"name":"invoices.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"invoices.get","title":"Get invoice","scope":"invoices:read","rest":{"method":"GET","path":"/invoices/{id}"},"mcp":{"name":"invoices.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"commercial_proposals.list","title":"List commercial proposals","scope":"commercial_proposals:read","rest":{"method":"GET","path":"/commercial-proposals"},"mcp":{"name":"commercial_proposals.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"commercial_proposals.get","title":"Get commercial proposal","scope":"commercial_proposals:read","rest":{"method":"GET","path":"/commercial-proposals/{id}"},"mcp":{"name":"commercial_proposals.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"bookings.list","title":"List bookings","scope":"schedule:read","rest":{"method":"GET","path":"/bookings"},"mcp":{"name":"bookings.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"bookings.get","title":"Get booking","scope":"schedule:read","rest":{"method":"GET","path":"/bookings/{id}"},"mcp":{"name":"bookings.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"availability.get","title":"Get availability policy","scope":"schedule:read","rest":{"method":"GET","path":"/availability"},"mcp":{"name":"availability.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"availability.slots","title":"List bookable slots","scope":"schedule:read","rest":{"method":"GET","path":"/availability/slots"},"mcp":{"name":"availability.slots","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"integrations.catalog","title":"List integration paths","scope":"integrations:read","rest":{"method":"GET","path":"/integrations"},"mcp":{"name":"integrations.catalog","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"integrations.servicem8.status","title":"Inspect ServiceM8 connection","scope":"integrations:read","rest":{"method":"GET","path":"/integrations/servicem8"},"mcp":{"name":"integrations.servicem8.status","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"bookings.create","title":"Create booking","scope":"schedule:write","rest":{"method":"POST","path":"/bookings"},"mcp":{"name":"bookings.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"bookings.reschedule","title":"Reschedule booking","scope":"schedule:write","rest":{"method":"POST","path":"/bookings/{id}/reschedule"},"mcp":{"name":"bookings.reschedule","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"bookings.cancel","title":"Cancel booking","scope":"bookings:cancel","rest":{"method":"POST","path":"/bookings/{id}/cancel"},"mcp":{"name":"bookings.cancel","readOnly":false,"destructive":true,"idempotent":false},"release":"live"},{"id":"files.list","title":"List files","scope":"files:read","rest":{"method":"GET","path":"/files"},"mcp":{"name":"files.list","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"files.get","title":"Get file metadata","scope":"files:read","rest":{"method":"GET","path":"/files/{id}"},"mcp":{"name":"files.get","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"messages.send","title":"Send message","scope":"messages:send","rest":{"method":"POST","path":"/messages"},"mcp":{"name":"messages.send","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"contacts.notes.create","title":"Add contact note","scope":"contacts:write","rest":{"method":"POST","path":"/contacts/{id}/notes"},"mcp":{"name":"contacts.notes.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"work_contexts.notes.create","title":"Add work-context note","scope":"work_contexts:write","rest":{"method":"POST","path":"/work-contexts/{id}/notes"},"mcp":{"name":"work_contexts.notes.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"invoices.create","title":"Create invoice draft","scope":"invoices:write","rest":{"method":"POST","path":"/invoices"},"mcp":{"name":"invoices.create","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"invoices.issue","title":"Issue invoice","scope":"invoices:issue","rest":{"method":"POST","path":"/invoices/{id}/issue"},"mcp":{"name":"invoices.issue","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"invoices.mark_paid","title":"Record invoice payment","scope":"invoices:mark_paid","rest":{"method":"POST","path":"/invoices/{id}/mark-paid"},"mcp":{"name":"invoices.mark_paid","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"invoices.delete","title":"Delete (void) invoice","scope":"invoices:delete","rest":{"method":"POST","path":"/invoices/{id}/delete"},"mcp":{"name":"invoices.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"commercial_proposals.send","title":"Send commercial proposal","scope":"commercial_proposals:send","rest":{"method":"POST","path":"/commercial-proposals/{id}/send"},"mcp":{"name":"commercial_proposals.send","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"commercial_proposals.delete","title":"Delete (archive) commercial proposal","scope":"commercial_proposals:delete","rest":{"method":"POST","path":"/commercial-proposals/{id}/delete"},"mcp":{"name":"commercial_proposals.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"contacts.delete","title":"Delete contact","scope":"contacts:delete","rest":{"method":"POST","path":"/contacts/{id}/delete"},"mcp":{"name":"contacts.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"work_contexts.delete","title":"Delete work context","scope":"work_contexts:delete","rest":{"method":"POST","path":"/work-contexts/{id}/delete"},"mcp":{"name":"work_contexts.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"followups.delete","title":"Delete follow-up","scope":"followups:delete","rest":{"method":"POST","path":"/followups/{id}/delete"},"mcp":{"name":"followups.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"files.delete","title":"Delete file","scope":"files:write","rest":{"method":"POST","path":"/files/{id}/delete"},"mcp":{"name":"files.delete","readOnly":false,"destructive":true,"idempotent":true},"release":"live"},{"id":"files.send","title":"Send file","scope":"files:send","rest":{"method":"POST","path":"/files/{id}/send"},"mcp":{"name":"files.send","readOnly":false,"destructive":false,"idempotent":false},"release":"live"},{"id":"kb.search","title":"Search knowledge base","scope":"kb:read","rest":{"method":"GET","path":"/kb/search"},"mcp":{"name":"kb.search","readOnly":true,"destructive":false,"idempotent":true},"release":"live"},{"id":"imports.create","title":"Import a batch of records","scope":"imports:write","rest":{"method":"POST","path":"/imports"},"mcp":{"name":"imports.create","readOnly":false,"destructive":false,"idempotent":true},"release":"live"}],"events":["webhook.ping","contact.created","booking.created","invoice.paid","payment.received","call.completed"],"integrations":{"servicem8":{"status":"configuration_required","authorization":"oauth2","modes":["read_only","read_write"],"resources":["contacts","jobs","schedule","webhooks"]}}}