Queues

Ordered collections of prompts for batch processing, with dequeue and status-marking operations.

• search_queues
• create_queue
• list_queue_items
• add_prompt_to_queue
• dequeue_queue
• mark_queue_item
• remove_queue_item

search_queues read-only

Search or list queues (ordered collections of prompts for batch processing).

{
  "name": "search_queues",
  "arguments": {}
}

create_queue write · non-destructive

Create a queue for batch-processing prompts. Add prompts with add_prompt_to_queue, then process them with dequeue_queue.

{
  "name": "create_queue",
  "arguments": {
    "name": "..."
  }
}

list_queue_items read-only

List items in a queue. Each item tracks a prompt and its processing status (pending, in_progress, succeeded, failed).

{
  "name": "list_queue_items",
  "arguments": {
    "id": "..."
  }
}

add_prompt_to_queue write · non-destructive

Add a prompt to a queue for batch processing. Reversible with remove_queue_item.

{
  "name": "add_prompt_to_queue",
  "arguments": {
    "id": "...",
    "promptId": "..."
  }
}

dequeue_queue write · non-destructive

Dequeue the next pending item from a queue. Returns the item with its compiled prompt text (compiledPrompt), or null if the queue is empty. Use mark_queue_item to report the outcome once processing is complete.

{
  "name": "dequeue_queue",
  "arguments": {
    "id": "..."
  }
}

mark_queue_item write · non-destructive

Mark a queue item as succeeded or failed after processing. This is required to move items out of the in_progress state.

{
  "name": "mark_queue_item",
  "arguments": {
    "id": "...",
    "itemId": "...",
    "status": "succeeded"
  }
}

remove_queue_item write · idempotent

Remove an item from a queue. Only the queue membership is removed; the prompt itself is not deleted. Reversible with add_prompt_to_queue.

{
  "name": "remove_queue_item",
  "arguments": {
    "id": "...",
    "itemId": "..."
  }
}