List Phoenix Artifacts

Coming soon

The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.

Browse this organization's Phoenix artifacts — the canonical deliverable (one brief per succeeded agent run or upload) already produced in this org. Returns one row per run with its synthetic id, artifact type, source (agent vs uploaded), created/expiry dates, and an absolute webapp URL to open it. Narrow with artifact_type, source, or a specific run_id, and page with limit/offset. Filters are structured only — there is NO free-text or content search, so you cannot search by company name or brief text. Use this to enumerate or find recent deliverables across the org. Do NOT use it to fetch one artifact's HTML body — use phoenix_get_artifact; to check a run that may still be in progress use phoenix_get_run_status; to start a new deliverable use phoenix_invoke_agent.

Parameters

Name	Type	Required	Default	Description
artifact_type	string	❌ No	-	Return only artifacts of this type. Omit to return all types.
source	string	❌ No	all	Filter by origin: "agent" (agent-generated), "uploaded" (via phoenix_upload_artifact), or "all" (default).
run_id	string	❌ No	-	Scope results to a single run id (UUID) — e.g. a runId from phoenix_invoke_agent. Omit to list across all runs.
limit	integer	❌ No	50	Max rows to return (1-200, default 50). Pair with offset to page.
offset	integer	❌ No	0	Rows to skip for pagination (0-10000, default 0). E.g. offset 50 with limit 50 returns the second page.

Use Cases

• Enumerate the deliverables an organization has produced
• Find the most recent agent-generated briefs (source: "agent")
• List only uploaded documents (source: "uploaded")
• Get the openable URL for every artifact tied to a specific run
• Page through a large set of artifacts with limit/offset

Example Usage

List the 20 most recent artifacts

{
  "tool": "phoenix_list_artifacts",
  "arguments": {
    "limit": 20
  }
}

Only agent-generated PDFs

{
  "tool": "phoenix_list_artifacts",
  "arguments": {
    "source": "agent",
    "artifact_type": "pdf"
  }
}

Artifacts for one run

{
  "tool": "phoenix_list_artifacts",
  "arguments": {
    "run_id": "00000000-0000-0000-0000-000000000000"
  }
}

Related Tools

phoenix_get_artifact, phoenix_get_run_status, phoenix_invoke_agent, phoenix_upload_artifact