Starte Sample- oder Full-Runs, warte mit einer begrenzten Kappe, dann Resume, Retry oder Cancel.

Der öffentliche Produktions-MCP-Endpoint ist live unter https://mcp.everyn.ai/mcp. Konfiguriere einen Host mit dieser Streamable-HTTP-URL und schließe WorkOS-OAuth ab.

Ein Run ist der dauerhafte Ausführungsdatensatz für eine gepinnte Job-Version gegen einen Dataset-Scope. Öffentliche States sind draft, queued, running, paused, succeeded, completed_with_flags, failed und canceled. Unbekannte zukünftige States schlagen fail-closed fehl.

start_run akzeptiert genau eine Form: neuer Sample, neuer Full, Resume oder Retry. Kombiniere sie nicht.

Sample versus Full

Form	Erforderliche Eingabe	Bedeutung
Neuer Sample	`dataset_id`, `job_version_id`, `mode: "sample"`, `sample`, Idempotency Key	Begrenzter Scope. `sample.limit` oder `sample.dataset_row_ids`.
Neuer Full	`dataset_id`, `job_version_id`, `mode: "full"`, Idempotency Key	Gesamtes Dataset. Niemals aus einem Sample abgeleitet.

Weite einen Sample niemals stillschweigend zu einem Full Run aus. Eine direkte Anfrage nach genau diesem Sample oder Full Run ist ausreichende Absicht. Wenn du die Aktion vorschlägst, zeige das Receipt und frage zuerst.

Optionale reference_dataset_ids dürfen einen neuen Sample- oder Full-Run begleiten.

Admission

start_run nutzt Everyns gemeinsame Billing-Admission und schlägt fail-closed fehl, ohne Provider-Dispatch. MCP kann kein Billing-Konto anlegen, keine Zahlung annehmen, keine Mittel aufladen und keinen Plan ändern.

Fehler	Retrybar	Nächster Schritt
`admission.missing_plan_authority`	Nein	Öffne Usage and Billing unter `https://app.everyn.ai/settings`.
`admission.billing_hold`	Nein	Öffne Usage and Billing. MCP kann keinen Hold aufheben.
`admission.insufficient_managed_ai`	Ja	Öffne Usage and Billing und retrye, sobald ausgebbarer Wert existiert.
`admission.row_budget_or_exposure_exhausted`	Ja	Öffne Usage and Billing und retrye, sobald Budget-Spielraum existiert.
`admission.unknown_billing_state`	Nein	Öffne Usage and Billing. Nimm nicht an, dass der Run gestartet ist.

Wallet-Erschöpfung mitten im Run pausiert den Run und bewahrt abgeschlossene Arbeit. Das ist keine start_run-Admission-Ablehnung. Resume, sobald Usage and Billing ausgebbaren Wert zeigt.

Warten

get_run liefert sofortigen Status oder führt einen begrenzten Wait aus.

`wait.for`	Bedeutung
`change`	Jede Status- oder Fortschrittsänderung.
`attention`	Der Run braucht eine Entscheidung.
`terminal`	Der Run hat einen terminalen State erreicht.

timeout_seconds ist optional und auf 25 Sekunden begrenzt, unter dem 30-Sekunden-CloudFront-Origin-Read-Default. Ein Wait deckt niemals die gesamte Run-Lebensdauer ab.

Disconnect beendet nur den Waiter. Der Run läuft weiter. Wenn die Person dich gebeten hat zu warten, rufe weiter begrenzte get_run-Waits auf, ohne erneut nach einem Prompt zu fragen.

search_runs filtert nach State, Dataset, Job und Zeit. Es erfindet keine Freitext-Run-Suche.

Resume und Retry

Form	Wann nutzen
Resume	Ein berechtigter pausierter Run über `resume_run_id`.
Retry	Erzeuge und starte einen unveränderlichen Retry über den von Everyn abgeleiteten berechtigten unresolved Scope über `retry_run_id`.

Aufrufer wählen keine beliebige Retry-Teilmenge. Retrye Qualitäts- oder Spec-Failures nicht blind.

Cancel

cancel_run bricht einen Run mit harvest-bewusster Semantik ab. Harvest-Failure blockiert Cancel niemals.

`mode`	Bedeutung
`normal` (Default)	Cancel und harveste committed Output, wenn möglich.
`urgent_stop`	Zuerst canceln.

Canceled Runs können nicht resumed werden. Wiederholtes Cancel ist sicher. already_terminal meldet einen Run, der bereits fertig war.

Vorschau während des Wartens

get_run_results liefert eine kleine committed Vorschau mit expliziter Unvollständigkeit. Default 20 Rows, hartes Maximum 50. Es paginiert niemals vollständig und erzeugt keine CSV. Aktive Runs melden immer unvollständig.

Wenn next_action export_and_analyze ist, ist das Completion-Set terminal und versionskompatibel. Weiter mit Export.