`fleet_post_task`

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

Post a task to the fleet work queue for a worker agent to claim. The body must be a COLD-EXECUTABLE brief — a fresh session with no prior context has to be able to do the work from it alone — and acceptance must state what “verified” means for this specific task. Returns the created task id.

Parameters

Name	Type	Required	Description
`title`	string	yes	One line naming the outcome, not the activity.
`body`	string	yes	The cold-executable brief: what to change, where, and the constraints that matter.
`acceptance`	string	yes	What “verified” means for THIS task — the check whose passing means it is done.
`created_by`	string	yes	Who is posting, as ‘session-name@host (lane)’.
`lane_hint`	string	no	Advisory routing only (e.g. backend, mcp-builder). Never enforced; workers self-select.
`priority`	number	no	1 high .. 5 low. Default 3.
`effort_hint`	string	no	Model-tier hint. Workers run on subscription seats by default; frontier-class effort must be explicit here.
`source_ref`	string	no	Back-reference to the row this came from during the shadow phase, e.g. ‘fix-queue.md:L66’.

Example call

Arguments

{
  "title": "Add retention to fleet_events",
  "body": "fleet_events is append-only and every worker poll writes a worker_wake row. Add a retention policy so the table does not grow without bound. Keep at least 90 days.",
  "acceptance": "Rows older than the retention window are removed on a schedule, and /admin/fleet still reports correctly over its default 24h window.",
  "created_by": "ruth@laptop (product)"
}

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_post_task","arguments":{"title":"Add retention to fleet_events","body":"fleet_events is append-only and every worker poll writes a worker_wake row. Add a retention policy so the table does not grow without bound. Keep at least 90 days.","acceptance":"Rows older than the retention window are removed on a schedule, and /admin/fleet still reports correctly over its default 24h window.","created_by":"ruth@laptop (product)"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('fleet_post_task', {
  "title": "Add retention to fleet_events",
  "body": "fleet_events is append-only and every worker poll writes a worker_wake row. Add a retention policy so the table does not grow without bound. Keep at least 90 days.",
  "acceptance": "Rows older than the retention window are removed on a schedule, and /admin/fleet still reports correctly over its default 24h window.",
  "created_by": "ruth@laptop (product)"
});

More examples

{
  "title": "Wire pricing.ts into the metered-call path",
  "body": "shared/src/pricing.ts has zero call sites while metered packs declare static costs that disagree with it. Wire it so billed cost comes from the vendor table.",
  "acceptance": "A metered call bills the pricing.ts figure; a unit test covers one pack whose static cost currently disagrees.",
  "created_by": "ruth@laptop (product)",
  "lane_hint": "backend",
  "priority": 2,
  "source_ref": "fix-queue.md:L66"
}

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_post_task