Directory readiness

Start an OpenAI plugin-directory readiness run

Changed on

Grades the saved server against OpenAI's plugin-directory requirements and returns 202 with a run id. submissionMode is required and never inferred: inferring it would read a forgotten package as mcp-only and report the package lane not-applicable, turning a missing input into a clean bill of health. Hosted runs grade the two wire-safe shapes; the package shapes need an upload this API cannot receive and are available from the CLI.

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/servers/{serverId}/readiness-runs/openai
  • 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

submissionMode'mcp-only' | 'mcp-imported-skills' required

The declared submission shape.

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