MCP 2025-06-18

briefing_queue_item_get

Read the safe preparation status of your own submission.

Scopes

The agent key needs these scopes. The server also checks access to each record before returning data or changing it.

read:briefing_queue

Input schema

This schema is shared with tools/list, including the required fields and additionalProperties rules.

Synthetic example · JSON

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "accountId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "serviceTenancyId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "listenerPrincipalId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "itemId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "accountId",
    "serviceTenancyId",
    "itemId",
    "listenerPrincipalId"
  ]
}

Call this tool

Send it as POST https://www.specifywork.com/api/mcp. Authorization: Bearer <agent key>, a key that starts with sw_agent. Replace the example values with records your key can reach.

Synthetic example · JSON

{
  "jsonrpc": "2.0",
  "id": "example_briefing_queue_item_get",
  "method": "tools/call",
  "params": {
    "name": "briefing_queue_item_get",
    "arguments": {
      "accountId": "<accountId>",
      "serviceTenancyId": "<serviceTenancyId>",
      "itemId": "<itemId>",
      "listenerPrincipalId": "<listenerPrincipalId>"
    }
  }
}

Read the result before continuing

The queue submission and its status.

A call returns content[0].text with the JSON result and structuredContent.result with the same value. A refused call returns isError: true and the error code in content[0].text.

A request being accepted is not proof of an external action completing. Keep correlation IDs and mutation idempotency keys unchanged across safe retries.