Back to Tool Reference
MCP

listing.get_generation

Return listing task status and result fields.

Effectread-onlyScopelisting:readPlanStarter+

Parameters

handlestringRequired

Task UUID returned from listing.create or listing.publish.

wait_secintegerDefault: 0

0 returns an instant snapshot. Positive values long-poll up to that many seconds and return when the task is complete/failed or the timeout expires.

Returns

handlestring
resource_idstring | null

Same as listing_id once known.

status"pending" | "running" | "complete" | "failed"
doneboolean
task_typestring
progressnumber

Fractional progress 0.0-1.0.

messagestring
listing_idstring | null

Populated once the worker writes the created or published listing.

errorstring
Request
json
{
  "name": "listing.get_generation",
  "arguments": {
    "handle": "c1fe737e-8776-5f39-8c3a-acd25ad5b75e",
    "wait_sec": 50
  }
}