`fleet_list_open`

Pack: fleet · Endpoint: https://gateway.pipeworx.io/fleet/mcp

List claimable tasks in the fleet queue, newest-highest-priority first. This is the cheap poll call a worker loop makes on every wake — it returns a count plus the top items only. Includes tasks whose claim has expired, since those auto-release. Call it, and if nothing is claimable, exit without further tool calls.

Parameters

Name	Type	Required	Description
`lane_hint`	string	no	Only tasks hinted for this lane, plus unhinted ones any lane may take.
`actor`	string	yes	The polling worker, as ‘session-name@host (lane)’. Logged as a worker_wake so an idle-but-alive worker is distinguishable from a dead one.
`limit`	number	no	Max tasks to return, 1-25. Default 5.
`budget_health`	string	no	Optional worker self-report: ‘ok’ or a note such as ‘rate-limited’. Rate-limited is not dead, and the log should say which.

Example call

Arguments

{
  "actor": "warren@laptop (backend)"
}

curl

curl -X POST https://gateway.pipeworx.io/fleet/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fleet_list_open","arguments":{"actor":"warren@laptop (backend)"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('fleet_list_open', {
  "actor": "warren@laptop (backend)"
});

More examples

{
  "actor": "warren@mini-1 (backend)",
  "lane_hint": "backend",
  "limit": 5,
  "budget_health": "ok"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "fleet": {
      "url": "https://gateway.pipeworx.io/fleet/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

fleet_list_open