Document include=assets as the way to see a ticket's associated assets

The /tickets/{id}/associated-assets path 404s on this instance; assets come
back embedded via GET /tickets/{id}?include=assets. Spell out the full include
list on get_ticket and in the skill reference so consumers don't hunt for a
nonexistent endpoint.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-24 15:37:16 -06:00
parent 829dbe1a3f
commit 5ded947b73
2 changed files with 10 additions and 1 deletions

View File

@@ -303,7 +303,11 @@ def list_ticket_statuses() -> str:
@mcp.tool()
def get_ticket(ticket_id: int, include: str | None = None) -> str:
"""Get a ticket by id. `include` e.g. "conversations,requester,stats".
"""Get a ticket by id. `include` accepts a comma-separated subset of:
conversations, requester, requested_for, stats, problem, assets, tags,
related_tickets. NOTE: include=assets is the ONLY way to see the ticket's
associated CMDB assets (a /tickets/{id}/associated-assets path does not
exist — it 404s); the assets come back embedded in the ticket object.
Numeric enums come back with companion *_label fields (priority_label,
status_label, impact_label, urgency_label) — use those names, never guess
the scale (priority 4 is Urgent, not low)."""