Your Data · Posture

`list_my_action_plans`

List the AI-generated remediation action plans (to-do lists) for your organisation. Costs 1 credit.

POST

tools/call

Cost: 1 credit per successful call · Scope: mcp:org · Response shape: jsonb

Returns data scoped to your own organisation only — the organisation is resolved from your API key and injected server-side, never read from the request.

Parameters

limitintegeroptionaldefault: 25

Maximum number of action plans to return. Accepted range: 1–100.

Example invocation

Ask your agent: "Show our current remediation action plans."

curl -s https://api.precursorintelligence.com/functions/v1/mcp \
  -H "Authorization: Bearer $PRECURSOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_my_action_plans","arguments":{"limit":25}}}'

Response

result.content[0].text (parsed)

{
  "count": 2,
  "items": [
    {
      "id": "f4a8d2c1-9e30-4b76-8a52-7c1f3b9e6d04",
      "priority_level": "critical",
      "status": "in_progress",
      "vulnerability_count": 4,
      "estimated_completion_time": "8h",
      "todo_items": [
        { "task": "Patch xz-utils to 5.6.2 across build agents", "done": false },
        { "task": "Rotate credentials exposed by left-pad release", "done": true }
      ],
      "created_at": "2026-06-12T11:00:00.000Z"
    },
    {
      "id": "9b1e7d40-3c82-4f15-a6d9-5e2b8c0f1a37",
      "priority_level": "high",
      "status": "open",
      "vulnerability_count": 2,
      "estimated_completion_time": "3h",
      "todo_items": [
        { "task": "Upgrade FortiOS to patched release", "done": false }
      ],
      "created_at": "2026-06-10T15:40:00.000Z"
    }
  ],
  "generated_at": "2026-06-18T08:15:00.000Z"
}

The full MCP envelope, including _meta.precursor with request_id, credits, and response_truncated, is documented in Response Format.

Response fields

countintegeroptional

Number of action plans returned (equals items.length).

itemsarrayoptional

Remediation action plans generated for your organisation. Each object contains the fields below.

items[].idstringoptional

Unique identifier (UUID) for the action plan.

items[].priority_levelstringoptional

Overall priority of the plan (e.g. critical, high, medium, low).

items[].statusstringoptional

Current status of the plan (e.g. open, in_progress, done).

items[].vulnerability_countintegeroptional

Number of vulnerabilities covered by the plan.

items[].estimated_completion_timestring | nulloptional

Estimated effort to complete the plan (e.g. 8h), or null when not estimated.

items[].todo_itemsarrayoptional

The plan's to-do list. Each entry is an object describing a task (e.g. task, done).

items[].created_atstringoptional

ISO 8601 timestamp when the plan was generated.

generated_atstringoptional

ISO 8601 timestamp indicating when this response was generated.

Errors

Code	Message	When
`-32602`	`invalid_params: limit: min:1`	`limit` is less than 1
`-32602`	`invalid_params: limit: max:100`	`limit` exceeds 100
`-32001`	`unauthorized`	The API key is invalid/revoked, the IP is not allowed, or the key lacks the `mcp:org` scope.
`-32002`	`insufficient_credits`	Your credit balance is zero; top up from the dashboard
`-32603`	`internal`	Unexpected server error; the credit is automatically refunded