Skip to main content
All tools except get_connection_info require a workspace_id argument. Call get_connection_info first, then pass its returned workspace_id into workspace-scoped tools.

Access model

Hosted OAuth connectors request Sagepilot’s full MCP capability set. The connected user’s Sagepilot role and permissions decide which tools can actually use data or make changes. Some MCP hosts may display the full Sagepilot tool list. If the connected user lacks access to a tool, Sagepilot returns an access error when that tool is called.
ToolAccessDescription
get_connection_infoReadReturn MCP session details, resolved workspace ID, and supported datasets.
get_analytics_catalogReadDiscover available analytics metrics, dimensions, and filters.
query_analyticsReadQuery tickets, messages, outbound messages, CSAT, and workforce activity.
list_ticketsReadList ticket summaries using Sagepilot ticket-list filters; not full-text search.
unified_searchReadSearch tickets, messages, customers, and voice calls through unified OpenSearch.
list_channelsReadList connected Sagepilot channels.
list_agentsReadList AI agents and human workspace members.
export_tickets_csvReadExport ticket rows as CSV, capped for MCP responses.
support_get_ticketReadGet a support ticket by ID or code.
support_get_ticket_messagesReadGet messages for a support ticket.
support_search_customersReadSearch customers by name, email, phone, or social identifier.
support_get_customerReadGet a customer by exact ID, email, or phone.
support_assign_ticketWriteAssign a support ticket to an agent, AI agent, team queue, or unassigned state.
support_update_ticket_statusWriteUpdate ticket status and optional sub-status.

Response shape

MCP tools return structured responses with stable fields. This makes the tools easier for AI hosts to inspect, validate, and reuse across follow-up calls.