Notifications

Read notifications, mark them seen or dismiss them.

Read notifications, mark them seen or dismiss them.

These are action names. In default compact mode, call the indicated group tool with {"action":"<action-name>","params":{...}}; the arguments below go inside params. In ?mode=all, call the action name directly with those arguments. browse_github and read_docs are direct tools in both modes. Expand each schema for nested fields, enum values and validation constraints. Successful results are JSON in both text content and structuredContent; failures use isError and structuredContent.error.

list_notifications

The caller's active notifications, newest first, with the unseen count. Dismissed ones are left out

Group: account · Behavior: Read

Compact tool: account · Action: list_notifications

MCP annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false

Permissions and REST equivalents

Operation	REST	Required scopes
notifications.list	GET /notifications	account:read

Arguments

Argument	Type	Required	Description
unseenOnly	boolean	No	Only notifications not marked seen
limit	integer	No	Items per page, 1 to 200 (default 50)
cursor	string	No	nextCursor from the previous page; omit for the first page

Complete input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "unseenOnly": {
      "type": "boolean",
      "description": "Only notifications not marked seen"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Items per page, 1 to 200 (default 50)"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "nextCursor from the previous page; omit for the first page"
    }
  },
  "additionalProperties": false
}

Result

• notifications (array<object>): See the complete response schema below.

• unseenCount (integer): Active notifications not marked seen, across every page

• nextCursor (string or null): Pass as cursor to fetch the next page; null on the last page

Response schema: notifications.list

{
  "type": "object",
  "properties": {
    "notifications": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Notification id"
          },
          "type": {
            "type": "string",
            "description": "What happened, e.g. share_invitation_received, grid_machines_online"
          },
          "title": {
            "type": "string"
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "resourceType": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "project",
                  "app",
                  "grid"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "resourceId": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "description": "Dashboard page the notification points at",
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp (UTC)"
          },
          "seenAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "description": "ISO 8601 timestamp (UTC)"
              },
              {
                "type": "null"
              }
            ]
          },
          "resolved": {
            "type": "boolean",
            "description": "Its inline action (accept, decline) has been taken already"
          }
        },
        "required": [
          "id",
          "type",
          "title",
          "message",
          "resourceType",
          "resourceId",
          "url",
          "createdAt",
          "seenAt",
          "resolved"
        ],
        "additionalProperties": false
      }
    },
    "unseenCount": {
      "type": "integer",
      "description": "Active notifications not marked seen, across every page"
    },
    "nextCursor": {
      "description": "Pass as cursor to fetch the next page; null on the last page",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "notifications",
    "unseenCount",
    "nextCursor"
  ],
  "additionalProperties": false
}

mark_notifications_seen

Mark one notification, or every active one, as seen

Group: account · Behavior: Write

Compact tool: account_write · Action: mark_notifications_seen

MCP annotations: readOnlyHint: false · destructiveHint: true · idempotentHint: true · openWorldHint: false

Permissions and REST equivalents

Operation	REST	Required scopes
notifications.markSeen	POST /notifications/seen	account:write

Arguments

Argument	Type	Required	Description
id	string	No	One notification; omit for every active one

Complete input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "One notification; omit for every active one"
    }
  },
  "additionalProperties": false
}

Result

• updated (integer): Notifications that changed

Response schema: notifications.markSeen

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "description": "Notifications that changed"
    }
  },
  "required": [
    "updated"
  ],
  "additionalProperties": false
}

dismiss_notifications

Dismiss one notification, or every active one. A dismissed notification no longer lists

Group: account · Behavior: Write

Compact tool: account_write · Action: dismiss_notifications

MCP annotations: readOnlyHint: false · destructiveHint: true · idempotentHint: true · openWorldHint: false

Permissions and REST equivalents

Operation	REST	Required scopes
notifications.dismiss	DELETE /notifications	account:write

Arguments

Argument	Type	Required	Description
id	string	No	One notification; omit for every active one

Complete input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{24}$",
      "description": "One notification; omit for every active one"
    }
  },
  "additionalProperties": false
}

Result

• dismissed (integer): Notifications dismissed

Response schema: notifications.dismiss

{
  "type": "object",
  "properties": {
    "dismissed": {
      "type": "integer",
      "description": "Notifications dismissed"
    }
  },
  "required": [
    "dismissed"
  ],
  "additionalProperties": false
}