{
  "package": {
    "name": "@teamgrid/mcp-server",
    "sourceCommit": "b0e4b3dfa4afd74822a73b8b5e8b647236f273ce",
    "sourceRepository": "TeamGrid/developer-platform",
    "version": "1.2.2"
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "contract": {
    "domain": "admin-write",
    "concurrency": "read",
    "idempotency": false,
    "coreCas": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "data": {
        "items": {
          "$ref": "#/$defs/AuditEvent"
        },
        "type": "array"
      },
      "meta": {
        "additionalProperties": false,
        "properties": {
          "page": {
            "additionalProperties": false,
            "properties": {
              "limit": {
                "maximum": 200,
                "minimum": 1,
                "type": "integer"
              },
              "nextCursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "limit",
              "nextCursor"
            ],
            "type": "object"
          },
          "requestId": {
            "type": "string"
          },
          "retentionDays": {
            "description": "Configured cell-local audit retention in days.",
            "maximum": 3650,
            "minimum": 30,
            "type": "integer"
          },
          "privateResource": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "uri",
              "maxBytes",
              "readMethod"
            ],
            "properties": {
              "uri": {
                "type": "string",
                "pattern": "^teamgrid://(?:files|exports)/[A-Za-z0-9_.:%-]+$"
              },
              "maxBytes": {
                "const": 1048576
              },
              "readMethod": {
                "const": "resources/read"
              }
            }
          },
          "etag": {
            "type": "string",
            "pattern": "^\"[\\x21\\x23-\\x7e]{1,256}\"$"
          },
          "resume": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "tool",
              "arguments"
            ],
            "properties": {
              "tool": {
                "enum": [
                  "teamgrid_project_lifecycle_operation_get",
                  "teamgrid_planned_work_operation_get",
                  "teamgrid_task_recurrence_operation_get",
                  "teamgrid_export_get"
                ]
              },
              "arguments": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "id"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                }
              }
            }
          },
          "outcome": {
            "enum": [
              "completed",
              "accepted",
              "partial",
              "unknown",
              "failed"
            ]
          },
          "omittedFields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "contentReadTool": {
            "const": "teamgrid_document_get"
          },
          "contentPage": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "unit": {
                "const": "utf16"
              },
              "offset": {
                "type": "integer",
                "minimum": 0
              },
              "nextOffset": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0
              },
              "totalLength": {
                "type": "integer",
                "minimum": 0
              },
              "complete": {
                "type": "boolean"
              },
              "revision": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "unit",
              "offset",
              "nextOffset",
              "totalLength",
              "complete",
              "revision"
            ]
          },
          "search": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "complete": {
                "const": false
              },
              "indexed": {
                "const": true
              },
              "returned": {
                "type": "integer",
                "minimum": 0
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 50
              },
              "continuation": {
                "const": "narrow-query-or-list"
              },
              "verification": {
                "const": "read-by-id"
              }
            },
            "required": [
              "complete",
              "indexed",
              "returned",
              "limit",
              "continuation",
              "verification"
            ]
          }
        },
        "required": [
          "page",
          "requestId",
          "retentionDays"
        ],
        "type": "object"
      }
    },
    "required": [
      "data",
      "meta"
    ],
    "additionalProperties": false,
    "$defs": {
      "AuditEvent": {
        "additionalProperties": false,
        "properties": {
          "attributes": {
            "additionalProperties": false,
            "properties": {
              "actorId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The actor id associated with this audit event attributes."
              },
              "actorType": {
                "enum": [
                  "user",
                  "serviceCredential",
                  "system"
                ],
                "type": "string",
                "description": "Canonical actor type value for this audit event attributes."
              },
              "cellId": {
                "type": "string",
                "description": "Identifier of the owning TeamGrid application cell."
              },
              "createdAt": {
                "format": "date-time",
                "type": [
                  "string",
                  "null"
                ],
                "description": "Timestamp at which the resource was created."
              },
              "credentialId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The credential id associated with this audit event attributes."
              },
              "eventType": {
                "type": "string",
                "description": "The event type associated with this audit event attributes."
              },
              "metadata": {
                "additionalProperties": {
                  "type": [
                    "string",
                    "number",
                    "boolean",
                    "null"
                  ]
                },
                "type": "object",
                "description": "The metadata associated with this audit event attributes."
              },
              "outcome": {
                "enum": [
                  "success",
                  "denied",
                  "failure"
                ],
                "type": "string",
                "description": "Canonical outcome value for this audit event attributes."
              },
              "region": {
                "type": "string",
                "description": "TeamGrid data region that owns and serves the workspace."
              },
              "requestId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Unique identifier assigned to the API request for tracing and support."
              },
              "source": {
                "enum": [
                  "teamgrid-app",
                  "api-v1",
                  "system"
                ],
                "type": "string",
                "description": "Canonical source value for this audit event attributes."
              },
              "targetId": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Identifier of the target resource."
              },
              "targetType": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Canonical type of the target resource."
              }
            },
            "required": [
              "actorId",
              "actorType",
              "cellId",
              "createdAt",
              "credentialId",
              "eventType",
              "metadata",
              "outcome",
              "region",
              "requestId",
              "source",
              "targetId",
              "targetType"
            ],
            "type": "object",
            "description": "The attributes associated with this audit event."
          },
          "id": {
            "type": "string",
            "description": "Stable TeamGrid identifier for this resource."
          },
          "type": {
            "const": "auditEvent",
            "description": "Canonical type discriminator for this resource."
          }
        },
        "required": [
          "type",
          "id",
          "attributes"
        ],
        "type": "object",
        "description": "Public API representation of audit event."
      }
    }
  },
  "profileOutputSchemas": {},
  "exposure": "read",
  "apiOperations": [
    {
      "href": "/api/v1/reference/operations/listauditevents/",
      "method": "GET",
      "operationId": "listAuditEvents",
      "path": "/audit-events"
    }
  ],
  "availableIn": [
    "full",
    "admin-write"
  ],
  "baseProfile": "full",
  "description": "List developer audit events",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cursor": {
        "maxLength": 1024,
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 200,
        "minimum": 1,
        "type": "integer"
      },
      "actorId": {
        "maxLength": 128,
        "type": "string"
      },
      "actorType": {
        "enum": [
          "user",
          "serviceCredential",
          "system"
        ],
        "type": "string"
      },
      "createdAtFrom": {
        "format": "date-time",
        "type": "string"
      },
      "createdAtTo": {
        "format": "date-time",
        "type": "string"
      },
      "credentialId": {
        "maxLength": 128,
        "type": "string"
      },
      "eventType": {
        "maxLength": 128,
        "type": "string"
      },
      "outcome": {
        "enum": [
          "success",
          "denied",
          "failure"
        ],
        "type": "string"
      },
      "requestId": {
        "maxLength": 128,
        "type": "string"
      },
      "source": {
        "enum": [
          "teamgrid-app",
          "api-v1",
          "system"
        ],
        "type": "string"
      },
      "targetId": {
        "maxLength": 128,
        "type": "string"
      },
      "targetType": {
        "maxLength": 128,
        "type": "string"
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "profileInputSchemas": {},
  "name": "teamgrid_audit_events_list",
  "scopes": {
    "optional": [],
    "conditional": [],
    "required": [
      "audit:read"
    ]
  },
  "security": {
    "classification": "governance-data",
    "summary": "The response can contain access configuration, activity records or automation metadata. Current role and domain permissions still apply."
  },
  "output": {
    "format": "The bounded API result is returned as MCP structured content and equivalent JSON text.",
    "kind": "cursor-page",
    "maxSerializedBytes": 262144,
    "pagination": {
      "input": "Pass the opaque `meta.page.nextCursor` value as `cursor`.",
      "maxPageSize": 200,
      "nextCursor": "meta.page.nextCursor"
    },
    "redactions": [],
    "searchLimit": null
  },
  "examplePrompt": "List the first 20 TeamGrid audit events. Do not request another page; tell me whether another cursor is available.",
  "typicalErrors": [
    {
      "condition": "The selected tool profile or allow/deny filter excludes `teamgrid_audit_events_list`.",
      "result": "The tool is not advertised to the host. Select the narrowest profile that contains it and restart the host."
    },
    {
      "condition": "An argument violates this tool’s input schema: required field, type, enum, pattern, length, or range.",
      "result": "MCP input validation rejects the call before an API request is made."
    },
    {
      "condition": "The credential lacks `audit:read` or cannot access the requested resource.",
      "result": "The tool preserves a safe API error code such as `insufficient_scope`, with redacted detail and available status/request metadata."
    },
    {
      "condition": "A read exceeds the 256 KiB tool result limit.",
      "result": "The tool returns `result_too_large`. Request a smaller page or narrower filters."
    },
    {
      "condition": "An unknown input property is supplied.",
      "result": "The strict input schema rejects the call before an API request is made."
    }
  ]
}