Skip to main content

Get Phoenix Artifact

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.

Retrieve ONE Phoenix artifact by its id and, when the deliverable is a small HTML brief, inline its content. Pass either a synthetic artifact_id ({runId}-html, {runId}-pdf, …) OR a bare run_id (UUID) — not both needed. Returns { found: true } with the artifact type, an absolute webapp URL to open it, and the brief's HTML body when it's small enough to inline (large or non-HTML deliverables return the descriptor + URL only, no inlined content). If the run has no artifact (queued, failed, unknown, or an id that doesn't match the run's real type), returns { found: false } rather than erroring. Use this when you already have a specific artifact/run id and want its content or link. Do NOT use it to discover which artifacts exist — use phoenix_list_artifacts; to check a still-running job use phoenix_get_run_status.

Parameters​

NameTypeRequiredDefaultDescription
artifact_idstring❌ No-Synthetic artifact id from phoenix_list_artifacts, e.g. "{runId}-html" or "{runId}-pdf". Provide this OR run_id (at least one is required).
run_idstring❌ No-Bare run id (UUID), e.g. a runId from phoenix_invoke_agent — resolves that run's canonical artifact. Provide this OR artifact_id.

Use Cases​

  • Read the HTML body of a specific brief the model already knows the id of
  • Get the openable URL for one artifact by its synthetic id
  • Resolve a run's canonical deliverable from just its run id
  • Confirm whether a given run actually produced a downloadable artifact

Example Usage​

Fetch an artifact by synthetic id

{
  "tool": "phoenix_get_artifact",
  "arguments": {
    "artifact_id": "00000000-0000-0000-0000-000000000000-html"
  }
}

Fetch by bare run id

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

phoenix_list_artifacts, phoenix_get_run_status, phoenix_invoke_agent, phoenix_upload_artifact