Claim messages from my queue
queue_claimClaim up to max messages from a queue, each with a lease. Finish with queue_ack, or queue_nack to retry later. A lease that runs out hands the message to the next claim (at least once: make your work idempotent). Returns each message's id, body, attempts and lease (an empty list when none is ready). To only look, use queue_status.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"max": 10,
"queue": "jobs",
"instance_id": "que_exampleexampleexample2",
"visibility_timeout_seconds": 120
},
"name": "queue_claim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | Default 1. | |
| queue | Yes | Queue name: 1 to 64 characters from a-z 0-9 . _ -. | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. | |
| visibility_timeout_seconds | No | This claim's lease in seconds (default: the queue's; queue_settings sets it). |