MCP Tools Reference: servicehealth

Tool: `get_project_event`

Gets detailed information about a specific service health event.

name (string, required): Name of the event using the form projects/{project_id}/locations/global/events/{event_id}.

The following sample demonstrate how to use curl to invoke the get_project_event MCP tool.

Curl Request
curl --location 'https://servicehealth.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_project_event", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

Curl Request

                  
curl --location 'https://servicehealth.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_project_event",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

Gets information about a specific event.

GetEventRequest

JSON representation
{ "name": string }

Fields

Fields
`name`	`string` Required. Unique name of the event in this scope including project and location using the form `projects/{project_id}/locations/{location}/events/{event_id}`. `project_id` - Project ID of the project that contains the event. `location` - The location to get the service health events from. Set this field to `global`. `event_id` - Event ID to retrieve.

name

string

Required. Unique name of the event in this scope including project and location using the form projects/{project_id}/locations/{location}/events/{event_id}.

project_id - Project ID of the project that contains the event.

location - The location to get the service health events from. Set this field to global.

event_id - Event ID to retrieve.

Output Schema

Represents service health events that may affect Google Cloud products. Event resource is a read-only view and does not allow any modifications. All fields are output only.

Event

JSON representation

JSON representation
{ "name": string, "title": string, "description": string, "category": enum (`EventCategory`), "detailedCategory": enum (`DetailedCategory`), "state": enum (`State`), "detailedState": enum (`DetailedState`), "eventImpacts": [ { object (`EventImpact`) } ], "relevance": enum (`Relevance`), "updates": [ { object (`EventUpdate`) } ], "parentEvent": string, "updateTime": string, "startTime": string, "endTime": string, "nextUpdateTime": string }

{
  "name": string,
  "title": string,
  "description": string,
  "category": enum (EventCategory),
  "detailedCategory": enum (DetailedCategory),
  "state": enum (State),
  "detailedState": enum (DetailedState),
  "eventImpacts": [
    {
      object (EventImpact)
    }
  ],
  "relevance": enum (Relevance),
  "updates": [
    {
      object (EventUpdate)
    }
  ],
  "parentEvent": string,
  "updateTime": string,
  "startTime": string,
  "endTime": string,
  "nextUpdateTime": string
}

Fields
`name`	`string` Output only. Identifier. Name of the event. Unique name of the event in this scope including project and location using the form `projects/{project_id}/locations/{location}/events/{event_id}`.
`title`	`string` Output only. Brief description for the event.
`description`	`string` Output only. Free-form, human-readable description.
`category`	`enum (EventCategory)` Output only. The category of the event.
`detailedCategory`	`enum (DetailedCategory)` Output only. The detailed category of the event.
`state`	`enum (State)` Output only. The current state of the event.
`detailedState`	`enum (DetailedState)` Output only. The current detailed state of the incident.
`eventImpacts[]`	`object (EventImpact)` Google Cloud products and locations impacted by the event.
`relevance`	`enum (Relevance)` Output only. Communicates why a given event is deemed relevant in the context of a given project.
`updates[]`	`object (EventUpdate)` Output only. Event updates are correspondence from Google.
`parentEvent`	`string` Output only. When `detailed_state`=`MERGED`, `parent_event` contains the name of the parent event. All further updates will be published to the parent event.
`updateTime`	`string (Timestamp format)` Output only. The time when the event was last modified. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`.
`startTime`	`string (Timestamp format)` Output only. The start time of the event, if applicable. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`.
`endTime`	`string (Timestamp format)` Output only. The end time of the event, if applicable. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`.
`nextUpdateTime`	`string (Timestamp format)` Output only. The time when the next update can be expected. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`.

EventImpact

JSON representation
{ "product": { object (`Product`) }, "location": { object (`Location`) } }

Fields

Fields
`product`	`object (Product)` Google Cloud product impacted by the event.
`location`	`object (Location)` Location impacted by the event.

product

object (Product)

Google Cloud product impacted by the event.

location

object (Location)

Location impacted by the event.

Product

JSON representation
{ "productName": string, "id": string }

Fields

Fields
`productName`	`string` Google Cloud product impacted by the event. Example: `"Google Cloud SQL"`
`id`	`string` Unique identifier for the product.

productName

string

Google Cloud product impacted by the event. Example: "Google Cloud SQL"

id

string

Unique identifier for the product.

Location

JSON representation
{ "locationName": string }

Fields

Fields
`locationName`	`string` Location impacted by the event. Example: `"us-central1"`

locationName

string

Location impacted by the event. Example: "us-central1"

EventUpdate

JSON representation
{ "updateTime": string, "title": string, "description": string, "symptom": string, "workaround": string }

Fields
`updateTime`	`string (Timestamp format)` Output only. The time the update was posted. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`.
`title`	`string` Output only. Brief title for the event.
`description`	`string` Output only. Free-form, human-readable description.
`symptom`	`string` Output only. Symptoms of the event, if available.
`workaround`	`string` Output only. Workaround steps to remediate the event impact, if available.

Timestamp

JSON representation
{ "seconds": string, "nanos": integer }

Fields

Fields
`seconds`	`string (int64 format)` Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
`nanos`	`integer` Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

seconds

string (int64 format)

Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).

nanos

integer

Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

EventCategory

The category of the event. This enum lists all possible categories of event.

Enums
`EVENT_CATEGORY_UNSPECIFIED`	Unspecified category.
`INCIDENT`	Event category for service outage or degradation.

DetailedCategory

The detailed category of an event. Contains all possible states for all event categories.

Enums
`DETAILED_CATEGORY_UNSPECIFIED`	Unspecified detailed category.
`CONFIRMED_INCIDENT`	Indicates an event with category INCIDENT has a confirmed impact to at least one Google Cloud product.
`EMERGING_INCIDENT`	Indicates an event with category INCIDENT is under investigation to determine if it has a confirmed impact on any Google Cloud products.

State

The state of the event. This enum lists all possible states of event.

Enums
`STATE_UNSPECIFIED`	Unspecified state.
`ACTIVE`	Event is actively affecting a Google Cloud product and will continue to receive updates.
`CLOSED`	Event is no longer affecting the Google Cloud product or has been merged with another event.

DetailedState

The detailed state of the incident. This enum lists all possible detailed states of an incident.

Enums
`DETAILED_STATE_UNSPECIFIED`	Unspecified detail state.
`EMERGING`	Google engineers are actively investigating the event to determine the impact.
`CONFIRMED`	The incident is confirmed and impacting at least one Google Cloud product. Ongoing status updates will be provided until it is resolved.
`RESOLVED`	The incident is no longer affecting any Google Cloud product, and there will be no further updates.
`MERGED`	The incident was merged into a parent incident. All further updates will be published to the parent only. The `parent_event` field contains the name of the parent.
`AUTO_CLOSED`	The incident was automatically closed because of the following reasons: The impact of the incident could not be confirmed. The incident was intermittent or resolved itself. The incident does not have a resolution because no action or investigation happened. If it is intermittent, the incident may reopen.
`FALSE_POSITIVE`	Upon investigation, Google engineers concluded that the incident is not affecting a Google Cloud product. This state can change if the incident is reviewed again.

Relevance

Communicates why a given incident is deemed relevant in the context of a given project. This enum lists all possible detailed states of relevance.

Enums
`RELEVANCE_UNSPECIFIED`	Unspecified relevance.
`UNKNOWN`	The relevance of the incident to the project is unknown.
`NOT_IMPACTED`	The incident does not impact the project.
`PARTIALLY_RELATED`	The incident is associated with a Google Cloud product your project uses, but the incident may not be impacting your project. For example, the incident may be impacting a Google Cloud product that your project uses, but in a location that your project does not use.
`RELATED`	The incident has a direct connection with your project and impacts a Google Cloud product in a location your project uses.
`IMPACTED`	The incident is verified to be impacting your project.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

MCP Tools Reference: servicehealth Stay organized with collections Save and categorize content based on your preferences.

Tool: get_project_event

Input Schema

GetEventRequest

Output Schema

Event

EventImpact

Product

Location

EventUpdate

Timestamp

EventCategory

DetailedCategory

State

DetailedState

Relevance

Tool Annotations

MCP Tools Reference: servicehealth

Tool: `get_project_event`