---
title: "Start a persisted conformance run"
method: POST
path: "/projects/{projectId}/servers/{serverId}/conformance-runs"
tags: ["Conformance runs"]
---

# Start a persisted conformance run

`POST /projects/{projectId}/servers/{serverId}/conformance-runs`

Grades the saved server against the protocol, apps, and tasks suites and returns `202` with a run id. The target comes from the saved server the path names: a body cannot supply a URL. OAuth is not startable here. Poll the run detail for the verdict. Status, outcome, and score are three different answers.

## Path parameters

- `projectId` string, required
- `serverId` string, required

## Request body

- object
  - `suites` string[] — Suites to run. Defaults to protocol, apps, and tasks. OAuth is not available on this surface.
  - `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.
  - `protocolVersion` string
  - `engineVersion` string

## Response `202`

The run was accepted and is executing.

- object
  - `runId` string, required
  - `projectId` string, required
  - `serverId` string, required
  - `status` string, required
  - `deduped` boolean, required
  - `requestedSuites` string[], required

## Other responses

- `400` — The body carried an unknown key, named OAuth, or the server uses a transport conformance cannot grade.
- `401` — Missing, invalid, revoked, or orphaned key (`UNAUTHORIZED`) — or the **target MCP server** needs an OAuth grant (`OAUTH_REQUIRED`), which is a property of the server, not your key.
- `403` — Key is valid but not allowed to do this.
- `404` — Unknown project, server, or resource.
- `429` — Per-key rate limit exceeded (60 requests/minute sustained, bursts up to 10). Honor `Retry-After` and back off with jitter.
- `500` — Something failed on MCPJam's side.
- `502` — The saved server's address could not be resolved.

---

[API](https://skmtc.net/mcpjam/apis/mcpjam-api.md) · [All operations](https://skmtc.net/mcpjam/apis/mcpjam-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mcpjam/mcpjam-api/revisions/61274583b124/schema)