Directory readiness

Start a Claude directory-readiness run

Changed on

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/readiness-runs/claude
  • Auth
    HTTP bearer

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' | 'muse' 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

Changes

  • 97bd992b9977Revision changes
    • warning

      added the new muse enum value to the response property for the response status

  • 548954252807Revision changes
    • warning

      added the new cancelled enum value to the response property for the response status

    • warning

      added the new completed enum value to the response property for the response status

    • warning

      added the new failed enum value to the response property for the response status

    • warning

      added the new pending enum value to the response property for the response status

    • warning

      added the new running enum value to the response property for the response status

    • info

      the response property became required for the status

    • info

      the response property became required for the status