Masthead MCP Tools Reference
The Masthead Model Context Protocol server exposes a set of read-only and mutation tools that allow AI agents to interact with your data observability ecosystem in near-realtime.
Below is the reference guide for each tool, including its purpose.
Discovery and context tools
Section titled “Discovery and context tools”list_projects
Section titled “list_projects”List all GCP project IDs monitored for your tenant. Use these project IDs as filters, such as projectId, in subsequent incident and table metadata queries.
list_users
Section titled “list_users”List all users in your Masthead tenant. This is useful for identifying email addresses before assigning ownership of an incident.
Incident management tools
Section titled “Incident management tools”list_open_incidents
Section titled “list_open_incidents”List all active unresolved incidents, such as Open, In Progress, or Acknowledged, over the last 14 days, optionally bounded by a limit.
list_incidents
Section titled “list_incidents”Full incident search history with options to filter by project, status, severity, or pipeline type.
get_incident_details
Section titled “get_incident_details”Fetch full details and diagnostics for a specific incident group by its UUID.
Incident action and mitigation tools
Section titled “Incident action and mitigation tools”assign_incident_owner
Section titled “assign_incident_owner”Assign an incident to a registered Masthead user by their email address.
update_incident_status
Section titled “update_incident_status”Change an incident’s life-cycle status, to one of OPEN, IN_PROGRESS, ACKNOWLEDGED, FIXED, EXPECTED or NO_ACTION_NEEDED.
update_incident_severity
Section titled “update_incident_severity”Change an incident’s priority/severity tier, to one of P1 through P5.
append_incident_notes
Section titled “append_incident_notes”Append a comment or progress updates to an incident’s audit log.
Table and lineage tools
Section titled “Table and lineage tools”get_table_metadata
Section titled “get_table_metadata”Retrieve schema, columns count, isAnomaly status, and alert tier settings for a BigQuery table.
get_table_pipelines
Section titled “get_table_pipelines”Fetch the metadata and status of pipelines writing to a specific table.
get_table_lineage
Section titled “get_table_lineage”Traces the upstream/downstream tables and pipelines associated with the target table to verify blast radius.
update_table_priority
Section titled “update_table_priority”Adjust the monitoring alert level for a BigQuery table to one of CRITICAL, PRIORITY, REGULAR, or MUTED.