{"tools":[{"name":"pagerly_get_oncall","description":"Who is on call right now, per team, with the shift window, whether an override is in effect, and who takes over next. Use this for 'who is on call' questions. For the full upcoming rotation of one team use pagerly_get_schedule; for the directory of everyone who can be paged use pagerly_list_users.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Optional team name to report on (case-insensitive, substring). Omit for every team.","type":"string"}},"required":[]},"title":"Get on-call","annotations":{"title":"Get on-call","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_incident","description":"Declare a new Pagerly incident, provision Slack channel, assign severity (P1-P4) & commander.","inputSchema":{"type":"object","properties":{"title":{"description":"Short incident title","type":"string"},"description":{"description":"Detailed incident summary or impact","type":"string"},"severity":{"description":"Severity level (e.g. P1, P2, P3, P4)","type":"string"},"service_id":{"description":"Affected Pagerly service ID if known","type":"string"}},"required":["title"]},"title":"Create incident","annotations":{"title":"Create incident","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_incident","description":"Update status (Open, In Progress, Investigating, Identified, Monitoring, Resolved) or severity of an ongoing incident.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Incident ID (e.g. INC-101)","type":"string"},"status":{"description":"New status (Open, In Progress, Investigating, Identified, Monitoring, Resolved)","type":"string"},"severity":{"description":"Updated severity (P1, P2, P3, P4)","type":"string"}},"required":["incident_id"]},"title":"Update incident","annotations":{"title":"Update incident","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_get_ai_investigation","description":"Fetch or trigger an SRE AI investigation for an incident, retrieving logs, metrics, GitHub deploys, and root-cause hypotheses.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Target Incident ID","type":"string"},"service_id":{"description":"Associated Pagerly Service ID","type":"string"},"run_new":{"description":"Whether to trigger a fresh SRE investigation or fetch latest summary","type":"boolean"}},"required":["incident_id"]},"title":"Get AI investigation","annotations":{"title":"Get AI investigation","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_incident_stats","description":"Aggregate incident metrics: MTTR, severity and status distributions, and recurring root-cause themes. For the individual incidents themselves use pagerly_list_incidents.","inputSchema":{"type":"object","properties":{"days":{"description":"Number of past days to analyze (default: 30)","type":"integer"}},"required":[]},"title":"Incident stats","annotations":{"title":"Incident stats","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_alert_noise_analysis","description":"Analyze alert noise, volume, incident conversion ratio, top noisy alert integrations, and off-hours page percentages.","inputSchema":{"type":"object","properties":{"days":{"description":"Number of past days to analyze (default: 30)","type":"integer"}},"required":[]},"title":"Alert noise analysis","annotations":{"title":"Alert noise analysis","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_account_info","description":"Get the Pagerly account overview: workspace name, number of teams connected, subscription status and which integrations are set up.","inputSchema":{"type":"object","properties":{},"required":[]},"title":"Get account info","annotations":{"title":"Get account info","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_teams","description":"List all teams (rotations/schedules) in the workspace with their current on-call, timezone, Slack channel, reminder setting and linked external schedule.","inputSchema":{"type":"object","properties":{"include_deleted":{"description":"Include soft-deleted teams (default: false)","type":"boolean"},"name_filter":{"description":"Optional case-insensitive substring to filter team names by","type":"string"}},"required":[]},"title":"Get teams","annotations":{"title":"Get teams","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_team","description":"Get full detail for a single team by name or ID, including overrides and reminder config.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"}},"required":[]},"title":"Get team","annotations":{"title":"Get team","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_team","description":"Update a team's settings: name, timezone, channel, manager and integration links. Only the fields you pass are changed; omit the rest. This does not touch the rotation itself — use pagerly_update_schedule for handover timing, pagerly_update_rotation_users for the roster and pagerly_set_reminder for reminders.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"new_name":{"description":"Rename the team","type":"string"},"timezone":{"description":"Team timezone, e.g. UTC, America/New_York, Asia/Kolkata","type":"string"},"slack_channel":{"description":"Slack channel ID this team posts to","type":"string"},"manager_id":{"description":"Slack user ID of the team manager","type":"string"},"automated_reply":{"description":"Automated reply text used when the team is mentioned","type":"string"},"custom_slack_message":{"description":"Custom Slack message template for on-call changes","type":"string"},"daily_msg_time":{"description":"Time of day for the daily on-call message, e.g. 09:00","type":"string"},"jira_board":{"description":"Linked Jira board key","type":"string"},"pagerduty_id":{"description":"Linked PagerDuty schedule ID","type":"string"},"update_slack_topic":{"description":"Whether to update the Slack channel topic on rotation change","type":"boolean"},"show_change_notification":{"description":"Whether to post a message when on-call changes","type":"boolean"}},"required":[]},"title":"Update team","annotations":{"title":"Update team","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_get_schedule","description":"Get a team's current and upcoming on-call rotation, with any overrides already applied.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"}},"required":[]},"title":"Get schedule","annotations":{"title":"Get schedule","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_overrides","description":"List the schedule overrides currently configured on a team.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"}},"required":[]},"title":"Get overrides","annotations":{"title":"Get overrides","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_override","description":"Create a schedule override so a specific person covers a time window, replacing whoever the rotation would normally put on call. Use for cover requests, sick days and holidays.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_id":{"description":"Slack user ID of the person who will cover the shift","type":"string"},"start":{"description":"Override start as ISO local datetime, e.g. 2026-08-02T09:00","type":"string"},"end":{"description":"Override end as ISO local datetime, e.g. 2026-08-04T09:00","type":"string"}},"required":["user_id","start","end"]},"title":"Create override","annotations":{"title":"Create override","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_delete_override","description":"Remove a previously created schedule override from a team.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_id":{"description":"Slack user ID on the override to remove","type":"string"},"start":{"description":"Exact start of the override to remove, as returned by pagerly_get_overrides","type":"string"}},"required":["start"]},"title":"Delete override","annotations":{"title":"Delete override","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_swap_shifts","description":"Swap two on-call shifts between two people on the same team. Each person takes over the other's window. Implemented as two overrides.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_one":{"description":"Slack user ID of the first person","type":"string"},"user_one_start":{"description":"First person's shift start, ISO local datetime","type":"string"},"user_one_end":{"description":"First person's shift end, ISO local datetime","type":"string"},"user_two":{"description":"Slack user ID of the second person","type":"string"},"user_two_start":{"description":"Second person's shift start, ISO local datetime","type":"string"},"user_two_end":{"description":"Second person's shift end, ISO local datetime","type":"string"}},"required":["user_one","user_one_start","user_one_end","user_two","user_two_start","user_two_end"]},"title":"Swap shifts","annotations":{"title":"Swap shifts","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_set_reminder","description":"Set or update the on-call shift reminder for a team. Supported types: Daily, Weekly, Custom, Every Rotation. For Custom, also pass day and time.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"type":{"description":"Reminder type: Daily, Weekly, Custom, Every Rotation","type":"string"},"day":{"description":"For Custom only: day of week, e.g. Monday","type":"string"},"time":{"description":"For Custom only: time of day, e.g. 09:00","type":"string"},"timezone":{"description":"Reminder timezone, e.g. Asia/Kolkata","type":"string"},"message_template":{"description":"Optional custom reminder message template","type":"string"},"target":{"description":"Optional target for the reminder, e.g. channel or dm","type":"string"},"channel_list":{"description":"Optional comma-separated channel IDs to remind","type":"string"}},"required":["type"]},"title":"Set reminder","annotations":{"title":"Set reminder","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_remove_reminder","description":"Remove the on-call shift reminder from a team.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"}},"required":[]},"title":"Remove reminder","annotations":{"title":"Remove reminder","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_get_rotation","description":"Get a team's rotation definition: who is in the roster and in what order, the handover frequency, day, time and timezone. Use this before editing a rotation. For who is on call right now use pagerly_get_schedule.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"}},"required":[]},"title":"Get rotation","annotations":{"title":"Get rotation","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_team","description":"Create a new team with a round-robin on-call rotation. The roster rotates in the order given, handing over on the frequency you set. Requires the mcp:admin scope and an organisation admin.","inputSchema":{"type":"object","properties":{"name":{"description":"Name for the new team, e.g. 'Platform SRE'","type":"string"},"users":{"description":"Ordered, comma-separated roster. Slack user IDs, emails or display names, e.g. 'U012AB,U034CD' — rotation follows this order.","type":"string"},"frequency":{"description":"How often on-call hands over: Hourly, Daily, Weekly, BiWeekly, Monthly","type":"string"},"day":{"description":"For Daily/Hourly: Monday-Friday, Monday-Saturday or All 7 Days. For Weekly/BiWeekly: the handover weekday, e.g. Monday. For Monthly: day of month, e.g. 1. Defaults per frequency if omitted.","type":"string"},"time":{"description":"Handover time of day, 24-hour HH:mm (default: 09:00)","type":"string"},"timezone":{"description":"IANA zone (e.g. Asia/Kolkata) or UTC offset (e.g. +05:30)","type":"string"},"start_date":{"description":"Optional rotation start date, YYYY-MM-DD (default: today)","type":"string"},"slack_channel":{"description":"Optional Slack channel ID to post on-call changes to","type":"string"}},"required":["name","users","frequency","timezone"]},"title":"Create team","annotations":{"title":"Create team","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_schedule","description":"Change a rotation's timing: how often it hands over, on which day, at what time and in which timezone. Only the fields you pass are changed. Use pagerly_update_rotation_users to change who is in the rotation.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"frequency":{"description":"New handover frequency: Hourly, Daily, Weekly, BiWeekly, Monthly","type":"string"},"day":{"description":"For Daily/Hourly: Monday-Friday, Monday-Saturday or All 7 Days. For Weekly/BiWeekly: the handover weekday. For Monthly: day of month.","type":"string"},"time":{"description":"New handover time, 24-hour HH:mm","type":"string"},"timezone":{"description":"IANA zone (e.g. Europe/London) or UTC offset (e.g. +01:00)","type":"string"},"start_date":{"description":"Move the rotation start date, YYYY-MM-DD","type":"string"}},"required":[]},"title":"Update schedule","annotations":{"title":"Update schedule","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_update_rotation_users","description":"Replace a rotation's roster. The order given is the order people go on call in.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"users":{"description":"Ordered, comma-separated roster of Slack user IDs, emails or names","type":"string"}},"required":["users"]},"title":"Update rotation users","annotations":{"title":"Update rotation users","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_add_rotation_user","description":"Add one person to a team's rotation roster without disturbing the rest of the order.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_id":{"description":"Slack user ID, email or display name of the person to add","type":"string"},"position":{"description":"Optional 0-based slot to insert at (default: end of the roster)","type":"integer"}},"required":["user_id"]},"title":"Add rotation user","annotations":{"title":"Add rotation user","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_remove_rotation_user","description":"Remove one person from a team's rotation roster. The last remaining person cannot be removed.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_id":{"description":"Slack user ID, email or display name of the person to remove","type":"string"}},"required":["user_id"]},"title":"Remove rotation user","annotations":{"title":"Remove rotation user","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_set_permanent_user","description":"Move someone to the front of the rotation so they hold the current on-call slot. For temporary cover use pagerly_create_override instead.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_id":{"description":"Slack user ID, email or display name","type":"string"}},"required":["user_id"]},"title":"Set permanent user","annotations":{"title":"Set permanent user","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_set_user_group","description":"Back a team's on-call with a Slack user group, so the group membership drives who is paged.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"user_group":{"description":"Slack user group handle without the @, e.g. 'platform-oncall', or a raw user group ID","type":"string"},"enabled":{"description":"Set false to detach the user group from this team (default: true)","type":"boolean"}},"required":[]},"title":"Set user group","annotations":{"title":"Set user group","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_delete_team","description":"Soft-delete a team and its rotation. The team stops paging and disappears from listings but is recoverable. Requires confirm=true. Requires the mcp:admin scope and an organisation admin.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Team name (case-insensitive). Either this or team_id is required.","type":"string"},"team_id":{"description":"Team ID. Takes precedence over team_name.","type":"string"},"confirm":{"description":"Must be true. Guards against deleting a team by accident.","type":"boolean"}},"required":["confirm"]},"title":"Delete team","annotations":{"title":"Delete team","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_list_incidents","description":"List individual incidents with their titles, severities, statuses and timestamps. Filter by team, status, severity or time window. Use this whenever the user asks 'what were the incidents', 'incidents for my team', or wants to see specific incidents rather than aggregate numbers.","inputSchema":{"type":"object","properties":{"team_name":{"description":"Only incidents for this team (case-insensitive name match)","type":"string"},"team_id":{"description":"Only incidents for this team ID. Takes precedence over team_name.","type":"string"},"status":{"description":"Filter by status, e.g. Open, In Progress, Investigating, Identified, Monitoring, Resolved","type":"string"},"severity":{"description":"Filter by severity, e.g. P1, P2, P3, P4","type":"string"},"unresolved_only":{"description":"Only incidents that are not yet resolved (default: false)","type":"boolean"},"days":{"description":"Only incidents created in the last N days (default: all time)","type":"integer"},"search":{"description":"Case-insensitive substring match on incident title or description","type":"string"},"kind":{"description":"Only \"alert\" (paged people without opening an incident) or only \"incident\". Default: both","type":"string"},"limit":{"description":"Maximum incidents to return, newest first (default: 25, max: 200)","type":"integer"}},"required":[]},"title":"List incidents","annotations":{"title":"List incidents","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_incident","description":"Get full detail for one incident: description, responders, timeline of updates, linked services, Slack thread and AI investigation summaries.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Incident ID, e.g. INC-101","type":"string"}},"required":["incident_id"]},"title":"Get incident","annotations":{"title":"Get incident","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_statuspage","description":"Get the status page overview: page name, public URL, and every component with its current status. Use this to answer 'is anything down' or 'what does our status page show'.","inputSchema":{"type":"object","properties":{},"required":[]},"title":"Get status page","annotations":{"title":"Get status page","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_statuspage_components","description":"List the components on the status page with their current status and grouping.","inputSchema":{"type":"object","properties":{"status_filter":{"description":"Only components whose current status matches this, e.g. Operational, Major Outage","type":"string"}},"required":[]},"title":"List status page components","annotations":{"title":"List status page components","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_statuspage_incidents","description":"List incidents published on the public status page, newest first, with their update timeline.","inputSchema":{"type":"object","properties":{"unresolved_only":{"description":"Only incidents not yet resolved (default: false)","type":"boolean"},"impact":{"description":"Filter by impact level","type":"string"},"search":{"description":"Case-insensitive substring match on the incident title","type":"string"},"limit":{"description":"Maximum incidents to return (default: 25, max: 200)","type":"integer"}},"required":[]},"title":"List status page incidents","annotations":{"title":"List status page incidents","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_statuspage_incident","description":"Get one status page incident with its full public update timeline.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Status page incident ID","type":"string"}},"required":["incident_id"]},"title":"Get status page incident","annotations":{"title":"Get status page incident","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_statuspage_component","description":"Change a component's status on the public status page, e.g. mark 'API Gateway' as 'Major Outage'. This is publicly visible to your customers.","inputSchema":{"type":"object","properties":{"component_name":{"description":"Component name, e.g. API Gateway","type":"string"},"status":{"description":"New status. Must match one of the page's configured status settings, e.g. Operational, Degraded Performance, Partial Outage, Major Outage","type":"string"}},"required":["component_name","status"]},"title":"Update status page component","annotations":{"title":"Update status page component","readOnlyHint":false,"destructiveHint":true,"openWorldHint":true}},{"name":"pagerly_create_statuspage_incident","description":"Publish a new incident on the public status page. This is visible to your customers.","inputSchema":{"type":"object","properties":{"title":{"description":"Incident title shown publicly","type":"string"},"message":{"description":"First public update message","type":"string"},"impact":{"description":"Impact level, e.g. Minor, Major, Critical","type":"string"},"status":{"description":"Initial status, e.g. Investigating, Identified, Monitoring","type":"string"}},"required":["title"]},"title":"Create status page incident","annotations":{"title":"Create status page incident","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true}},{"name":"pagerly_create_action_item","description":"Create a follow-up action item, optionally linked to an incident and assigned to a person. Action items can be created at any point — during an active incident or after resolution as postmortem follow-ups.","inputSchema":{"type":"object","properties":{"title":{"description":"Short description of what needs to be done","type":"string"},"incident_id":{"description":"Optional incident ID to link this action item to","type":"string"},"description":{"description":"Optional longer details","type":"string"},"assignee_email":{"description":"Optional assignee email","type":"string"},"due_date":{"description":"Optional due date as YYYY-MM-DD","type":"string"},"status":{"description":"Optional initial status: Open, In Progress or Done (default: Open)","type":"string"}},"required":["title"]},"title":"Create action item","annotations":{"title":"Create action item","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_action_items","description":"List action items for the organisation. Filter by incident, assignee or status, e.g. 'open action items from last week's database incident'.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Only action items linked to this incident","type":"string"},"assignee_email":{"description":"Only action items assigned to this email","type":"string"},"status":{"description":"Filter by status: Open, In Progress or Done","type":"string"},"open_only":{"description":"Only items that are not Done (default: false)","type":"boolean"}},"required":[]},"title":"List action items","annotations":{"title":"List action items","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_action_item","description":"Update an action item: change status (Open / In Progress / Done), reassign it, or edit its title, description or due date.","inputSchema":{"type":"object","properties":{"action_item_id":{"description":"The action item ID","type":"string"},"title":{"description":"New title","type":"string"},"description":{"description":"New description","type":"string"},"assignee_email":{"description":"New assignee email","type":"string"},"due_date":{"description":"New due date as YYYY-MM-DD","type":"string"},"status":{"description":"New status: Open, In Progress or Done","type":"string"}},"required":["action_item_id"]},"title":"Update action item","annotations":{"title":"Update action item","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_list_users","description":"List everyone in the Pagerly user directory with their email, phone number, country code and role. This is the roster Pagerly pages from — a user with no phone number cannot be called.","inputSchema":{"type":"object","properties":{"search":{"description":"Optional case-insensitive substring matched against name and email","type":"string"},"role":{"description":"Optional exact role filter, e.g. admin or member","type":"string"},"missing_phone_only":{"description":"Only return users with no phone number configured (default: false)","type":"boolean"}},"required":[]},"title":"List users","annotations":{"title":"List users","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_user","description":"Get one user from the directory by email, including the number Pagerly would actually dial for them.","inputSchema":{"type":"object","properties":{"email":{"description":"The user's email address","type":"string"}},"required":["email"]},"title":"Get user","annotations":{"title":"Get user","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_upsert_user","description":"Create a user in the directory, or update an existing one. Only the fields you pass are changed; omit the rest. Use this to set or correct a paging phone number. Requires the mcp:admin scope and an organisation admin.","inputSchema":{"type":"object","properties":{"email":{"description":"The user's email address. Identifies the record.","type":"string"},"name":{"description":"Display name","type":"string"},"phone_number":{"description":"Phone number. Either full E.164 with a leading + (e.g. +919876543210), or the national number on its own (e.g. 9876543210) alongside country_code.","type":"string"},"country_code":{"description":"Dialling code, e.g. +91 or +1. Prepended to a national number at paging time.","type":"string"},"role":{"description":"Role for the user, e.g. admin or member. Defaults to member on create.","type":"string"}},"required":["email"]},"title":"Upsert user","annotations":{"title":"Upsert user","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_delete_user","description":"Remove a user from the Pagerly directory. They stop being pageable immediately. This does not remove them from any rotation roster — use pagerly_remove_rotation_user for that. Requires the mcp:admin scope and an organisation admin.","inputSchema":{"type":"object","properties":{"email":{"description":"The user's email address","type":"string"}},"required":["email"]},"title":"Delete user","annotations":{"title":"Delete user","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_list_destinations","description":"Everywhere this organisation can send a report or finding: its teams (with their Slack channels), Pagerly incidents, and the Jira projects, Linear teams and Asana projects it has connected. Call this first and only offer destinations that are listed.","inputSchema":{"type":"object","properties":{},"required":[]},"title":"List destinations","annotations":{"title":"List destinations","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_jira_issue_types","description":"Issue types available in one Jira project, for pagerly_create_jira_issue.","inputSchema":{"type":"object","properties":{"project_id":{"description":"Jira project id from pagerly_list_destinations","type":"string"}},"required":["project_id"]},"title":"List Jira issue types","annotations":{"title":"List Jira issue types","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_post_to_team_channel","description":"Post a message to a Pagerly team's Slack channel. Only teams from pagerly_list_destinations can be addressed, never an arbitrary channel.","inputSchema":{"type":"object","properties":{"team_id":{"description":"Pagerly team id","type":"string"},"text":{"description":"Message in Slack mrkdwn","type":"string"},"attachment":{"required":["content_type","data_base64"],"description":"Optional file to include, e.g. the screenshot or recording from a bug report. Up to 5 MB; png, jpeg, webp, gif, webm or mp4.","properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"data_base64":{"type":"string"}},"type":"object"},"image_url":{"description":"Optional public https URL of an image to show in the message when the attachment cannot be uploaded (or instead of one)","type":"string"}},"required":["team_id","text"]},"title":"Post to team channel","annotations":{"title":"Post to team channel","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_declare_incident","description":"Declare a Pagerly incident the way the dashboard does: the team's settings decide whether an incident channel is created, and its on-call person is assigned and paged. Prefer this over pagerly_create_incident, which only records the incident.","inputSchema":{"type":"object","properties":{"title":{"description":"Incident title","type":"string"},"description":{"description":"What is happening, with any evidence links","type":"string"},"severity":{"description":"P1, P2, P3 or P4 (default: P3)","type":"string"},"team_id":{"description":"Optional Pagerly team id; its on-call is assigned","type":"string"},"escalation_id":{"description":"Optional escalation policy id (pagerly_list_escalations) to page instead of a team: layer 1 is paged first and the policy escalates from there","type":"string"},"link":{"description":"Optional URL with the evidence, e.g. a bug report","type":"string"},"source":{"description":"Optional name of the tool filing this, shown on the incident (default: MCP)","type":"string"}},"required":["title"]},"title":"Declare incident","annotations":{"title":"Declare incident","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_jira_issue","description":"Create an issue in a Jira project connected to this organisation.","inputSchema":{"type":"object","properties":{"project_key":{"description":"Jira project key from pagerly_list_destinations","type":"string"},"issue_type":{"description":"Issue type name (default: Bug)","type":"string"},"title":{"description":"Issue summary","type":"string"},"description":{"description":"Issue body; Jira wiki markup, newlines kept","type":"string"},"attachment":{"required":["content_type","data_base64"],"description":"Optional file to include, e.g. the screenshot or recording from a bug report. Up to 5 MB; png, jpeg, webp, gif, webm or mp4.","properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"data_base64":{"type":"string"}},"type":"object"}},"required":["project_key","title"]},"title":"Create Jira issue","annotations":{"title":"Create Jira issue","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_linear_issue","description":"Create an issue in a Linear team connected to this organisation.","inputSchema":{"type":"object","properties":{"team_id":{"description":"Linear team id from pagerly_list_destinations","type":"string"},"title":{"description":"Issue title","type":"string"},"description":{"description":"Issue body in markdown","type":"string"},"attachment":{"required":["content_type","data_base64"],"description":"Optional file to include, e.g. the screenshot or recording from a bug report. Up to 5 MB; png, jpeg, webp, gif, webm or mp4.","properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"data_base64":{"type":"string"}},"type":"object"}},"required":["team_id","title"]},"title":"Create Linear issue","annotations":{"title":"Create Linear issue","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_create_asana_task","description":"Create a task in an Asana project connected to this organisation.","inputSchema":{"type":"object","properties":{"project_id":{"description":"Asana project id from pagerly_list_destinations","type":"string"},"title":{"description":"Task name","type":"string"},"description":{"description":"Task notes","type":"string"},"attachment":{"required":["content_type","data_base64"],"description":"Optional file to include, e.g. the screenshot or recording from a bug report. Up to 5 MB; png, jpeg, webp, gif, webm or mp4.","properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"data_base64":{"type":"string"}},"type":"object"}},"required":["project_id","title"]},"title":"Create Asana task","annotations":{"title":"Create Asana task","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_investigate_report","description":"Ask Pagerly's AI SRE to investigate a bug report and post its findings in Slack. A message goes to the team's channel (or the incident's channel when incident_id is given and one exists) and the agent replies in that thread with a root-cause analysis, using the tools the team has connected. Returns straight away with a reportId. Then call pagerly_get_investigation_report with it about every 20 seconds until its status is done or failed, and show the user the report, so they get the findings here as well as in Slack.","inputSchema":{"type":"object","properties":{"team_id":{"description":"Pagerly team id; its channel and services scope the investigation","type":"string"},"title":{"description":"What went wrong, in one line","type":"string"},"evidence":{"description":"The report: console errors with stacks, failing requests, user actions, environment. Markdown.","type":"string"},"incident_id":{"description":"Optional Pagerly incident this belongs to","type":"string"},"link":{"description":"Optional URL of the full report","type":"string"},"source":{"description":"Optional name of the tool filing this (default: MCP)","type":"string"},"attachment":{"required":["content_type","data_base64"],"description":"Optional file to include, e.g. the screenshot or recording from a bug report. Up to 5 MB; png, jpeg, webp, gif, webm or mp4.","properties":{"content_type":{"type":"string"},"filename":{"type":"string"},"data_base64":{"type":"string"}},"type":"object"}},"required":["team_id","title","evidence"]},"title":"Investigate report","annotations":{"title":"Investigate report","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_escalations","description":"List the organisation's escalation policies: who each layer pages (a team's on-call and/or named people), how long each layer waits, and how often the policy repeats.","inputSchema":{"type":"object","properties":{},"required":[]},"title":"List escalations","annotations":{"title":"List escalations","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_escalation","description":"One escalation policy in full, including the alert integrations that send alerts to it.","inputSchema":{"type":"object","properties":{"escalation_id":{"description":"Escalation policy id from pagerly_list_escalations","type":"string"}},"required":["escalation_id"]},"title":"Get escalation","annotations":{"title":"Get escalation","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_list_alert_integrations","description":"List the organisation's alert integrations (Datadog, Grafana, CloudWatch, webhooks...): the team or escalation each one sends alerts to, its rules, and whether its alerts page without opening an incident.","inputSchema":{"type":"object","properties":{},"required":[]},"title":"List alert integrations","annotations":{"title":"List alert integrations","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_set_alert_target","description":"Choose where an alert integration sends its alerts: a team's on-call, or an escalation policy. Exactly one of team_id or escalation_id. Organisation admins only.","inputSchema":{"type":"object","properties":{"integration_id":{"description":"Alert integration id from pagerly_list_alert_integrations","type":"string"},"team_id":{"description":"Send alerts to this team","type":"string"},"escalation_id":{"description":"Send alerts to this escalation policy","type":"string"}},"required":["integration_id"]},"title":"Set alert target","annotations":{"title":"Set alert target","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_set_alert_rules","description":"Set an alert integration's rules and/or whether its alerts only page people without opening an incident. Whatever you leave out stays as it is. Organisation admins only.","inputSchema":{"type":"object","properties":{"integration_id":{"description":"Alert integration id from pagerly_list_alert_integrations","type":"string"},"rules":{"items":{"type":"object"},"description":"The complete list of rules, checked in order against each new alert; the first rule whose conditions all hold decides. Each rule: {\"name\": optional, \"conditions\": [{\"field\": \"severity\" | \"title\" | \"description\" | a payload path such as \"alert.priority\", \"op\": \"is\" | \"is_not\" | \"contains\" | \"not_contains\", \"value\": text}] (1 to 5), \"action\": \"ignore\" or \"route\"; for route also \"teamid\" or \"escalationid\" (one of them) and optionally \"opens\": \"incident\" | \"alert\"}. At most 20 rules. An empty list removes all rules.","type":"array"},"alert_only":{"description":"True: alerts page people but do not open an incident. False: alerts open incidents, as before.","type":"boolean"}},"required":["integration_id"]},"title":"Set alert rules","annotations":{"title":"Set alert rules","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_acknowledge_incident","description":"Acknowledge an open incident or alert, exactly like the Acknowledge button in Slack: it moves to In Progress and its escalation stops paging the next layer.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Incident id, e.g. INC-101","type":"string"}},"required":["incident_id"]},"title":"Acknowledge incident","annotations":{"title":"Acknowledge incident","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_resolve_incident","description":"Resolve an incident or alert, exactly like the Resolve button in Slack.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Incident id, e.g. INC-101","type":"string"}},"required":["incident_id"]},"title":"Resolve incident","annotations":{"title":"Resolve incident","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_create_escalation","description":"Create an escalation policy: who is paged first, how long they have to acknowledge, who is paged next, and whether it starts over. Organisation admins only.","inputSchema":{"type":"object","properties":{"name":{"description":"Policy name, e.g. \"Payments P1\"","type":"string"},"layers":{"items":{"type":"object"},"description":"The layers, in the order they are paged (1 to 3). Each layer: {\"team\": team id or name — whoever is on call for it, \"people\": [emails from pagerly_list_users], \"wait_minutes\": minutes to wait for an acknowledgement before moving on}. A layer needs a team, people, or both. Layer 1's wait defaults to 5 minutes.","type":"array"},"repeat":{"description":"Times to start again from layer 1 when nobody acknowledges (0 to 9, default 0)","type":"integer"},"slack_channel":{"description":"Optional Slack channel id where incidents from alert integrations paging this policy are posted","type":"string"}},"required":["name","layers"]},"title":"Create escalation","annotations":{"title":"Create escalation","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_update_escalation","description":"Change an escalation policy. Only what you send changes; sending layers replaces all of them. Organisation admins only.","inputSchema":{"type":"object","properties":{"escalation_id":{"description":"Escalation policy id from pagerly_list_escalations","type":"string"},"name":{"description":"New name","type":"string"},"layers":{"items":{"type":"object"},"description":"The layers, in the order they are paged (1 to 3). Each layer: {\"team\": team id or name — whoever is on call for it, \"people\": [emails from pagerly_list_users], \"wait_minutes\": minutes to wait for an acknowledgement before moving on}. A layer needs a team, people, or both. Layer 1's wait defaults to 5 minutes.","type":"array"},"repeat":{"description":"Times to start again from layer 1 (0 to 9)","type":"integer"},"slack_channel":{"description":"Slack channel id, or an empty string to clear it","type":"string"}},"required":["escalation_id"]},"title":"Update escalation","annotations":{"title":"Update escalation","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_delete_escalation","description":"Delete an escalation policy. Refused while an alert integration still sends alerts to it. Organisation admins only.","inputSchema":{"type":"object","properties":{"escalation_id":{"description":"Escalation policy id from pagerly_list_escalations","type":"string"}},"required":["escalation_id"]},"title":"Delete escalation","annotations":{"title":"Delete escalation","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false}},{"name":"pagerly_test_page_user","description":"Place a test phone call to a user, the same call an incident page makes, so they can check Pagerly reaches them. The user needs a phone number (pagerly_upsert_user).","inputSchema":{"type":"object","properties":{"email":{"description":"The user's email address in the Pagerly directory","type":"string"}},"required":["email"]},"title":"Test page user","annotations":{"title":"Test page user","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_get_investigation_report","description":"Read what the AI SRE found for an investigation started with pagerly_investigate_report. status is starting, running, done or failed. While it is starting or running, call again in about 20 seconds (an investigation usually takes 30-90 seconds); when it is done, show the report to the user.","inputSchema":{"type":"object","properties":{"report_id":{"description":"The reportId pagerly_investigate_report returned (or the incident id the investigation was run for)","type":"string"}},"required":["report_id"]},"title":"Get investigation report","annotations":{"title":"Get investigation report","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false}},{"name":"pagerly_add_incident_update","description":"Post a written update to an incident's timeline, as the dashboard's update box does, optionally changing its status or severity in the same update. The update is also posted to the incident's Slack channel when it has one.","inputSchema":{"type":"object","properties":{"incident_id":{"description":"Incident id","type":"string"},"update":{"description":"What changed, what is known, what happens next","type":"string"},"status":{"description":"Optional new status: Open, In Progress, Investigating, Identified, Monitoring or Resolved","type":"string"},"severity":{"description":"Optional new severity: P1, P2, P3 or P4","type":"string"}},"required":["incident_id","update"]},"title":"Add incident update","annotations":{"title":"Add incident update","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false}}]}