Skip to main content
POST
Start a persisted conformance run

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

serverId
string
required

ID of the server inside the project.

Body

application/json
suites
enum<string>[]

Suites to run. Defaults to protocol, apps, and tasks. OAuth is not available on this surface.

Minimum array length: 1
Available options:
protocol,
apps,
tasks
idempotencyKey
string

Deduplicates a retried POST for the same saved server. Mapped to a namespaced externalRunId (api:<projectId>:<serverId>:<key>); a keyless start always inserts and spends quota.

Maximum string length: 200
protocolVersion
string
engineVersion
string

Response

The run was accepted and is executing.

runId
string
required
projectId
string
required
serverId
string
required
status
string
required
deduped
boolean
required
requestedSuites
string[]
required