Tool · Tickets

get_ticket

Get a single support ticket by ID, including customer-visible replies only.

Read-onlyIdempotentscope read:tickets

Invoked over the MCP transport with a tools/call request naming this tool.

Authorization #

Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:tickets scope — View your support tickets and conversation history. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

idintegerRequired

Response #

200 · application/json

ticketobject

idinteger

subjectstring

statusstring

One of: Open Answered Customer-Reply Awaiting reply Closed On Hold In Progress

prioritystring

created_atstring · null

updated_atstring · null

repliesarray<object>

idinteger

messagestring

created_atstring · null

Errors #

Result	When
{ "error": "not_found" }	The requested item does not exist, or it belongs to another account. Cross-account IDs are indistinguishable from missing ones by design.

curl https://mcp.jethost.com/mcp \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_ticket", "arguments": { "id": 4821 } } }

{ "ticket": { "id": 4821, "subject": "string", "status": "Open", "priority": "string", "created_at": "string", "updated_at": "2026-06-15", "replies": [ { "id": 4821, "message": "string", "created_at": "string" } ] } }