Read one readiness run

GET

projects

{projectId}

readiness-runs

{runId}

Read one readiness run

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "readinessKind": "claude",
  "serverId": "<string>",
  "serverUrl": "<string>",
  "submissionMode": "mcp-only",
  "status": "pending",
  "overallStatus": "ready",
  "lanes": [
    {
      "lane": "runtime-compatibility",
      "status": "ready",
      "evaluated": 123,
      "notEvaluated": 123,
      "notApplicable": 123,
      "missingInputs": [
        "<string>"
      ]
    }
  ],
  "stages": [
    {
      "stage": "technical-preflight",
      "status": "ready",
      "lanes": [
        "runtime-compatibility"
      ]
    }
  ],
  "authMode": "headless",
  "capabilities": [
    "<string>"
  ],
  "attemptCount": 123,
  "terminalReason": "<string>",
  "errorMessage": "<string>",
  "policySnapshotDate": "<string>",
  "engineVersion": "<string>",
  "sdkVersion": "<string>",
  "includeLlmObservations": true,
  "llmObservations": {
    "status": "not-requested",
    "reason": "not_requested",
    "detail": "<string>"
  },
  "hasReport": true,
  "reportUrl": "<string>",
  "createdAt": 123,
  "updatedAt": 123
}

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.

runId

string

required

Eval run ID, as returned by POST /eval-runs.

Response

The run.

A directory-readiness run. Readiness carries no numeric score and is excluded from pooledConformanceScore: it answers whether a publisher would list this server, which is a different question from whether the server speaks MCP correctly.

string

required

readinessKind

enum<string>

required

Available options:

claude,

openai

serverId

string | null

required

The saved project server this run graded. Null only on rows written before the field existed.

serverUrl

string

required

The saved server's URL exactly as stored. Canonicalizing it would change the grade.

submissionMode

enum<string> | null

required

The declared submission shape, for an OpenAI run. Never inferred.

Available options:

mcp-only,

mcp-imported-skills

status

enum<string>

required

cancelled is distinct from failed: a person who stopped a run has learned nothing about their server.

Available options:

pending,

running,

completed,

failed,

cancelled

overallStatus

enum<string> | null

required

The headline verdict. incomplete means nothing was violated and something the run needed was never evaluated.

Available options:

ready,

not-ready,

incomplete

lanes

object[]

required

Show child attributes

stages

object[]

required

Show child attributes

authMode

enum<string> | null

required

Available options:

headless,

interactive,

provided-token

capabilities

string[]

required

What the executing surface could actually do. Two surfaces grading one target agree only on their shared capability subset.

attemptCount

integer

required

terminalReason

string | null

required

errorMessage

string | null

required

policySnapshotDate

string | null

required

The publisher-documentation snapshot this run graded against, so a stale grade says so.

engineVersion

string | null

required

sdkVersion

string | null

required

includeLlmObservations

boolean

required

Whether this run was started with the paid observation opt-in.

llmObservations

object

required

The model-observation axis, independent of the run's own status. A run whose lanes graded cleanly is completed even when the observation call was refused for credit: a payment problem belongs to the account, never to the server under grading.

Show child attributes

hasReport

boolean

required

reportUrl

string | null

required

createdAt

integer

required

updatedAt

integer

required

⌘I

Read one readiness run

curl --request GET \
  --url https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/projects/{projectId}/readiness-runs/{runId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "readinessKind": "claude",
  "serverId": "<string>",
  "serverUrl": "<string>",
  "submissionMode": "mcp-only",
  "status": "pending",
  "overallStatus": "ready",
  "lanes": [
    {
      "lane": "runtime-compatibility",
      "status": "ready",
      "evaluated": 123,
      "notEvaluated": 123,
      "notApplicable": 123,
      "missingInputs": [
        "<string>"
      ]
    }
  ],
  "stages": [
    {
      "stage": "technical-preflight",
      "status": "ready",
      "lanes": [
        "runtime-compatibility"
      ]
    }
  ],
  "authMode": "headless",
  "capabilities": [
    "<string>"
  ],
  "attemptCount": 123,
  "terminalReason": "<string>",
  "errorMessage": "<string>",
  "policySnapshotDate": "<string>",
  "engineVersion": "<string>",
  "sdkVersion": "<string>",
  "includeLlmObservations": true,
  "llmObservations": {
    "status": "not-requested",
    "reason": "not_requested",
    "detail": "<string>"
  },
  "hasReport": true,
  "reportUrl": "<string>",
  "createdAt": 123,
  "updatedAt": 123
}

API Guides

Endpoints

Authorizations

Path Parameters

Response