Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21161224637.5 KB

8978a4e735fa

Directory readiness

Start a Claude directory-readiness run

Grades the saved server against Anthropic's connector-directory requirements and returns 202 with a run id. The target comes from the saved server the path names: a body cannot supply a URL, an actor, an organization, a model or a cost. Poll the run detail for the verdict. Deterministic grading is free.

post/projects/{projectId}/servers/{serverId}/readiness-runs/claude

Path parameters

projectIdstring required

ID of the hosted project that contains the server.

serverIdstring required

ID of the server inside the project.

Request body

idempotencyKeystring

Deduplicates a retried POST. More load-bearing here than usual: a readiness run dials a third party's server, and a retried start that created a second run would do that twice.

includeLlmObservationsboolean

Add model-backed experience observations. Consumes MCPJam credits. Off by default, and deliberately: a billed opt-in that defaulted on would start charging every existing caller on the day it shipped. Observations are non-dispositive and can never make a server not-ready; a refused reservation makes no provider call and completes the run with llmObservations.reason set to billing_limit_reached.

Response

The run was accepted and is executing.

runIdstring required
projectIdstring required
serverIdstring required
readinessKind'claude' | 'openai' required
status'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required

The run's status when the start returned. pending for a fresh start; for a deduped start, whatever the existing run is already at — which may be completed, because a replayed idempotency key can name a run that finished long ago.

dedupedboolean required

This request replayed an existing run rather than starting one.

includeLlmObservationsboolean required