get_job_status
Resume a saved analysis job anonymously, including after interrupted Checkout or reconnection. Read continuation for human payment, bounded polling, result review or support. Preserve job_id; never create a replacement purchase to resume it. Checkout refund_status_source=local_ledger reflects durable Pulse reconciliation at refund_checked_at, not a fresh provider query; unconfirmed or needs_review must not be treated as a completed refund. Analysis cost is distinct from net payment. Completed/partial status and cost fields do not prove payment or refund settlement. Terminal Checkout result pages show billing separately; during recovery use the optional receipt API on demand; receipt_api_url is a separate on-demand read, not another MCP tool. Returns available results and provenance. Usable completed/partial results can include studio_notes: ready-to-save project notes with review warnings and failed tools. Notes are analysis snapshots, not payment/refund receipts; keep private job references and preserve review context.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job_id returned by analyze_track or request_payment_link. | |
| include_waveform_data | No | Optional. Defaults to false so chat agents receive a compact waveform summary plus result_url. Set true only if raw waveform samples are needed. | |
| include_waveform_image | No | Optional. Defaults to true. When the job has waveform data, include a server-rendered SVG as MCP image content so the client can display it without fetching a URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Machine-readable error code. | |
| job_id | No | Pulse analysis job id. | |
| status | No | Current or terminal job status. | |
| billing | No | ||
| details | No | Additional structured context from Pulse. | |
| message | No | Human-readable recovery guidance. | |
| results | No | Analysis results when available. | |
| cost_usd | No | ||
| metadata | No | Analysis metadata, including asset type, source hints, library metadata, and confidence policy when available. | |
| retryable | No | Whether the caller may retry after changing state or waiting. | |
| expires_at | No | ||
| result_url | No | Public result page URL. | |
| completed_at | No | ||
| continuation | No | Advisory saved-job recovery. URLs contain a private job reference. No provider read or settlement verification is performed. | |
| studio_notes | No | Optional plain-text project notes for completed/partial usable results. Preserve review warnings, provenance and failed tools. Contains no audio/source URL or payment/refund receipt fields; job references are private. | |
| waveform_file | No | ||
| payment_source | No | ||
| tokens_charged | No | ||
| waveform_image | No | ||
| tokens_estimated | No | ||
| waveform_png_url | No | ||
| waveform_svg_url | No | ||
| result_provenance | No | Per-tool provenance and applicability summary for interpreting detected, audio_candidate (manual review required), filename-sourced, suppressed, or low-confidence results. | |
| waveform_markdown | No | ||
| result_quality_notes | No | Human-readable quality notes for suppressed, low-confidence, filename-sourced, or review-needed results. |