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.

Headers

x-mcpjam-launcher
string

The launching process's own DECLARED identity, as compact JSON: {"kind":"cli"|"mcp"|"github_action","client":"…","version":"…"}. Stored on the run as launcher and used only as a display label: source stays api and the audit trail reads the platform-minted attribution instead.

A malformed value, or a kind outside the three above, is DROPPED rather than rejected, so a label never fails a launch. Max 512 bytes.

Idempotency-Key
string

The body's idempotencyKey sent as a header. It wins over the body field.

Maximum string length: 256

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
enum<string>

Pin one MCP protocol version. Without it the run uses the version the server negotiates.

Available options:
2025-03-26,
2025-06-18,
2025-11-25,
2026-07-28
engineVersion
string
settings
enum<string>

saved (the default) runs the server's saved conformance settings. none runs every check with no tool inputs.

Available options:
saved,
none

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
settingsSource
enum<string>

The settings the run used. defaults means the server has no saved settings, so every check runs.

Available options:
saved,
defaults,
none