{ "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": "tasks-write", "concurrency": "read", "idempotency": false, "coreCas": false }, "outputSchema": { "type": "object", "properties": { "data": { "$ref": "#/$defs/TaskRecurrencePreview" }, "meta": { "additionalProperties": false, "properties": { "requestId": { "type": "string", "description": "Unique identifier assigned to the API request for tracing and support." }, "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": [ "requestId" ], "type": "object", "description": "Public API representation of meta." } }, "required": [ "data", "meta" ], "additionalProperties": false, "$defs": { "TaskRecurrencePreview": { "additionalProperties": false, "properties": { "attributes": { "additionalProperties": false, "properties": { "costClass": { "enum": [ "low", "medium", "high", "async", null ], "type": [ "string", "null" ], "description": "Canonical cost class value for this task recurrence preview attributes." }, "definitionHash": { "pattern": "^[a-f0-9]{64}$", "type": "string", "description": "The definition hash associated with this task recurrence preview attributes." }, "occurrences": { "items": { "additionalProperties": false, "properties": { "cardDates": { "additionalProperties": false, "properties": { "dueDate": { "format": "date-time", "type": "string", "description": "ISO 8601 timestamp for due date." }, "plannedEnd": { "format": "date-time", "type": "string", "description": "Planned end timestamp." }, "plannedStart": { "format": "date-time", "type": "string", "description": "Planned start timestamp." } }, "type": "object", "description": "The card dates associated with this task recurrence preview attributes occurrences." }, "occurrenceKey": { "maxLength": 256, "minLength": 1, "type": "string", "description": "The occurrence key associated with this task recurrence preview attributes occurrences." }, "placeholderToken": { "anyOf": [ { "maxLength": 32768, "pattern": "^trp1\\.[A-Za-z0-9_-]+$", "type": "string" }, { "type": "null" } ], "description": "The placeholder token associated with this task recurrence preview attributes occurrences." }, "provenance": { "items": { "maxLength": 256, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array", "description": "The provenance associated with this task recurrence preview attributes occurrences." }, "scheduledFor": { "format": "date-time", "type": "string", "description": "ISO 8601 timestamp for scheduled for." }, "scheduledForLocal": { "maxLength": 32, "minLength": 16, "type": "string", "description": "The scheduled for local associated with this task recurrence preview attributes occurrences." }, "timeZone": { "maxLength": 128, "minLength": 1, "type": "string", "description": "The time zone associated with this task recurrence preview attributes occurrences." } }, "required": [ "cardDates", "occurrenceKey", "placeholderToken", "provenance", "scheduledFor", "scheduledForLocal", "timeZone" ], "type": "object" }, "maxItems": 100, "type": "array", "description": "The occurrences associated with this task recurrence preview attributes." }, "summary": { "additionalProperties": true, "maxProperties": 256, "type": "object", "description": "Short human-readable summary." } }, "required": [ "costClass", "definitionHash", "occurrences", "summary" ], "type": "object", "description": "The attributes associated with this task recurrence preview." }, "id": { "type": "string", "description": "Stable TeamGrid identifier for this resource." }, "type": { "const": "taskRecurrencePreview", "description": "Canonical type discriminator for this resource." } }, "required": [ "type", "id", "attributes" ], "type": "object", "description": "Public API representation of task recurrence preview." } } }, "profileOutputSchemas": {}, "exposure": "read", "apiOperations": [ { "href": "/api/v1/reference/operations/previewstoredtaskrecurrence/", "method": "GET", "operationId": "previewStoredTaskRecurrence", "path": "/task-recurrences/{id}/preview" } ], "availableIn": [ "all", "collaboration", "context", "core", "governance", "work", "full", "tasks-write" ], "baseProfile": "core", "description": "Preview a stored task recurrence", "inputSchema": { "type": "object", "properties": { "id": { "maxLength": 128, "minLength": 1, "type": "string" }, "from": { "format": "date-time", "type": "string" }, "until": { "format": "date-time", "type": "string" }, "count": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, "required": [ "id" ], "additionalProperties": false }, "profileInputSchemas": { "all": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "from": { "type": "string", "minLength": 1, "maxLength": 64 }, "id": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,256}$" }, "until": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, "collaboration": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "from": { "type": "string", "minLength": 1, "maxLength": 64 }, "id": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,256}$" }, "until": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, "core": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "from": { "type": "string", "minLength": 1, "maxLength": 64 }, "id": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,256}$" }, "until": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, "governance": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 100 }, "from": { "type": "string", "minLength": 1, "maxLength": 64 }, "id": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,256}$" }, "until": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "id" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false } }, "name": "teamgrid_task_recurrence_preview", "scopes": { "optional": [], "conditional": [], "required": [ "task-recurrences:read", "tasks:read" ] }, "security": { "classification": "operational-data", "summary": "The response contains operational workspace data visible to the credential." }, "output": { "format": "The bounded API result is returned as MCP structured content and equivalent JSON text.", "kind": "single-resource", "maxSerializedBytes": 262144, "pagination": null, "redactions": [], "searchLimit": null }, "examplePrompt": "Read the TeamGrid task recurrence preview with ID `` and summarize only the fields returned by TeamGrid.", "typicalErrors": [ { "condition": "`id` is missing or violates this tool’s exact input schema, including any pattern or length restriction.", "result": "MCP input validation rejects the call before an API request is made." }, { "condition": "The credential lacks `task-recurrences:read` and `tasks: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": "Use a bounded section, smaller supported read, private resource or authorized App/CLI transfer." }, { "condition": "An unknown input property is supplied.", "result": "The strict input schema rejects the call before an API request is made." } ] }