list_import_batches
Lists the brief imports of a project, newest first, with where each reading stands.
List the brief imports of a project by project_id: each with its title, source, status (queued, running, ready, accepted, discarded or failed), how many suggestions it produced, which provider and model answered, who started it and when. Read one with get_import_batch for the brief's words and the suggestions themselves. A staff token with import:view-any on the project is needed.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same actions as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project.
What it returns
{ "data": [ { "id": "f2a3b4c5-d6e7-4f8a-8b9c-0d1e2f3a4b5c", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "source": "pasted_text", "status": "ready", "title": "Laundry shop brief", "excerpt": "An informational website for a laundry shop with order placement, tracking, payment and appointment scheduling…", "suggestion_count": 23, "provider": "anthropic", "model": "claude-sonnet-5-5", "usage_id": "a3b4c5d6-e7f8-4a9b-8c0d-1e2f3a4b5c6d", "failure_reason": null, "created_by": "5b6c7d8e-9f0a-4b1c-8d2e-3f4a5b6c7d8e", "creator_name": "Bea Analyst", "started_at": "2026-10-28T11:20:05+00:00", "finished_at": "2026-10-28T11:21:40+00:00", "created_at": "2026-10-28T11:20:00+00:00", "updated_at": "2026-10-28T11:21:40+00:00" } ], "meta": { "total": 1 }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
FORBIDDENthe token is a client guest's, or the holder's role on the project does not carry import:view-any.
TOKEN_MISSING_ABILITYtoken lacks import:view-any.
How is this guide?
Last updated on