# MCPJam Inspector

## Docs

- [Run one headless agent turn](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/agent/run-one-headless-agent-turn.md): Runs ONE assistant turn over the supplied message history and responds synchronously with the final assistant text, the operations it invoked, references to any resources it created, and any actions awaiting human approval.
- [Export project traces as OTLP/JSON](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/export-project-traces-as-otlpjson.md): Returns an OTLP `ExportTraceServiceRequest`. Pagination rides in RESPONSE HEADERS rather than the body so the payload stays a valid OTLP document: read `x-mcpjam-next-cursor` and feed it back as `cursor`, and treat `x-mcpjam-export-complete: true` as the end of the stream.
- [Get the authenticated account](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/get-the-authenticated-account.md): The user behind the API key (keys act as their creator, scoped to one organization).
- [Get the host-compat catalog](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/get-the-host-compat-catalog.md): The versioned host-compatibility catalog backing `mcpjam compat` verdicts. Public and unauthenticated: static host facts and creation config with no project or user scope. Always returns a catalog — `source` is `live` when the backend publish was reachable and `bundled` when serving the SDK's built-…
- [List a project's eval suites](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/list-a-projects-eval-suites.md): Eval suites in the project with latest-run summaries and pass-rate trends — the `suiteId`s the eval-run routes take.
- [List a project's servers](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/list-a-projects-servers.md): The MCP servers saved in the project — the `serverId`s every other route takes. STDIO command/args/env and raw headers are never exposed.
- [List chat sessions](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/list-chat-sessions.md): Chat sessions visible to the caller (personal + project-shared merged). Top-level rather than project-nested because `projectId` is an optional filter, not an owning scope.
- [List projects](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/list-projects.md): Projects the caller can access. API keys only ever see projects inside the key's organization.
- [The MCPJam-provided model catalog](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/catalog/the-mcpjam-provided-model-catalog.md): PUBLIC: this route carries no user or project data and requires no bearer token, matching the upstream catalog it proxies. Mounted before authentication for that reason.
- [Get a chatbox](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/chatboxes/get-a-chatbox.md): One chatbox's full read-only settings: model, system prompt, tool-approval policy, attached servers, and share link. A chatbox that exists but belongs to a different project reads as `404 NOT_FOUND`.
- [List a project's chatboxes](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/chatboxes/list-a-projects-chatboxes.md): The chatboxes published from this project — name, access mode, attached servers, and share link. Read-only.
- [Archive an environment](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/archive-an-environment.md): Archive an environment. It stops being selectable for runs and frees its name for a new one, but the row is kept and can be restored — this is why archive is a sub-action rather than a DELETE. Requires `expectedRevision` — the revision you last read. If the environment changed since, the write is re…
- [Create an environment](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/create-an-environment.md): Create a project environment from a host plus, optionally, a standalone server group, a pinned skill selection, and pinned plugin versions. The name must be unique among the project's live environments. Requires project admin.
- [List a project's environments](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/list-a-projects-environments.md): The project environments saved in the project. Archived environments are excluded unless `includeArchived=true` — you need that to find one to restore.
- [Preview what an environment resolves to](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/preview-what-an-environment-resolves-to.md): Resolve an environment to the exact execution inputs a run would use right now: the host's current config, the closed server set (including servers contributed by pinned plugin versions), and the resolved plugin versions. Returns 409 when the environment cannot currently produce a runnable configura…
- [Restore an archived environment](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/restore-an-archived-environment.md): Restore an archived environment. Returns 409 if another live environment took its name in the meantime. Plugin pins whose version row no longer exists at all are dropped on the way back to live — compare the returned `pluginVersionIds` against what you archived to detect that. Requires `expectedRevi…
- [Show one environment](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/show-one-environment.md): Read one environment, including the `revision` you pass back as `expectedRevision` when writing to it.
- [Update an environment](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/environments/update-an-environment.md): Edit an environment. Only the fields you send change; send `null` for `serverAttachmentId`, `skillSelection`, or `pluginVersionIds` to clear them. Requires `expectedRevision` — the revision you last read. If the environment changed since, the write is rejected with 409 rather than overwriting the co…
- [Append iterations to an open run](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/append-iterations-to-an-open-run.md): Appends one batch of iteration results to a run opened by `runs/start`.
- [Cancel a run](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/cancel-a-run.md): Request cancellation of an in-flight run; marks the run and its pending/running iterations `cancelled`. A no-op success when the run is already cancelled; returns `409` when the run already reached a terminal status (`completed`/`failed`/`timed_out`).
- [Close an open ingestion run](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/close-an-open-ingestion-run.md): Marks the run complete and computes its rollups. Until this is called the run stays open in the dashboard.
- [Create an eval case](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/create-an-eval-case.md): Adds one case to the suite. Both `title` and a non-empty `steps` array are required — `steps` is optional on the shared case shape so PATCH can be partial, but a case persisted without executable steps could never run. When `models` is omitted the suite's configured model is used.
- [Create an eval run (async)](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/create-an-eval-run-async.md): Creates a suite run from an existing `suiteId` (rerun) and/or inline `tests`, then **detaches execution and responds `202` immediately** with the `runId`. Validation and quota errors surface on this request; poll `GET /eval-runs/{runId}` for progress. The run appears live in the hosted UI Runs tab,…
- [Create an eval suite (author-only, does not run)](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/create-an-eval-suite-author-only-does-not-run.md): Creates a runnable eval suite — the suite record plus its test cases — and responds `201` **synchronously**, WITHOUT executing anything. Use this to author a suite, then run it later with `POST /eval-runs` (passing the returned `suiteId`).
- [Delete an eval case](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/delete-an-eval-case.md): Removes the case from the suite. Past runs that executed it are not affected.
- [Delete an eval suite](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/delete-an-eval-suite.md): Deletes the suite and its cases. Past runs are not deleted.
- [Enable, repoint, or disable a suite's schedule](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/enable-repoint-or-disable-a-suites-schedule.md): A schedule fires exactly ONE run per interval, so an environment-based suite must pin exactly one of its attached environments. Omitting `environmentId` on a single-environment suite means that environment; omitting it on a multi-environment suite is a VALIDATION_ERROR. Disabling preserves the exist…
- [Generate eval cases from the suite's tools](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/generate-eval-cases-from-the-suites-tools.md): Discovers the suite's server tools over a live MCP connection, generates cases against them, and persists them — the only edit route that connects to a server, and the only one that SPENDS ORG CREDITS. Synchronous: connect, generate, persist, disconnect, respond.
- [Get an iteration trace](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-an-iteration-trace.md): Full trace envelope for one iteration: conversation messages, expected-vs-actual tool call analysis, and spans. The shape is rich and may evolve — treat it as an open document. Returns `404` with `details.reason: "TRACE_NOT_AVAILABLE"` when the iteration finished without a stored trace.
- [Get an iteration's step results](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-an-iterations-step-results.md): One row per authored test step, in order, with `status` (`ok`/`fail`/`skipped`/`pending`), a `reason`, and any `evidence` (screenshots, replay-video offset, widget tool calls). The fastest way to see which step failed and why. Unlike `/trace`, a missing trace is not a `404` — step verdicts still ret…
- [Get an upload URL for a run artifact](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-an-upload-url-for-a-run-artifact.md): Mints a short-lived URL for uploading a widget blob or other artifact referenced by an ingested run.
- [Get one eval case](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-one-eval-case.md): A case that belongs to this suite and project. A case in another suite is a 404, not a 403.
- [Get one eval suite's configuration](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-one-eval-suites-configuration.md): The suite's full settings — attached environments, hosts, execution config, judge, schedule. The list route returns run rollups instead; this is the shape the edit routes read and write.
- [Get run status](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/get-run-status.md): Run status, result, and summary. Poll until `status` is terminal (`completed`, `failed`, or `cancelled`).
- [Ingest a completed eval run in one call](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/ingest-a-completed-eval-run-in-one-call.md): The whole-run variant: submit a finished run and its iterations in a single request. This is what the SDK reporter uses by default.
- [List a suite's eval cases](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/list-a-suites-eval-cases.md): Every case in the suite, in the public steps-first shape.
- [List a suite's runs](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/list-a-suites-runs.md): Recent runs for a suite, newest first.
- [List run iterations](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/list-run-iterations.md): Per-iteration results: actual tool calls, structured token usage, and latency. Cursor-paginated.
- [Open a run for incremental ingestion](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/open-a-run-for-incremental-ingestion.md): Opens a run that iterations are appended to, for a long CI job that reports as it goes. Pair with `runs/iterations` and `runs/finalize`.
- [Update an eval case](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/update-an-eval-case.md): Partial update — omitted fields are left as they are. Supplying `steps` REPLACES the case's definition rather than merging into it. `matchOptions` and `checks` accept `null` to clear the case-level override and fall back to the suite's.
- [Update an eval suite's settings](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/eval-runs/update-an-eval-suites-settings.md): Partial update — omitted fields are left as they are. `environmentIds` is tri-state: a non-empty array sets/replaces, `null` clears (reverting the suite to legacy config), and `[]` is rejected rather than silently treated as a clear. Responds with the full updated suite.
- [Call a tool](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/execution/call-a-tool.md): Executes a tool on the server and returns the MCP `CallToolResult` directly. Tool-level failures (`isError: true` in the result) are **successful calls** — the server answered; only transport/auth errors use the error envelope.
- [Render a prompt](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/execution/render-a-prompt.md): Renders a prompt with arguments and returns the MCP `GetPromptResult` directly (`description?`, `messages`).
- [Export a server snapshot](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/export/export-a-server-snapshot.md): Lists tools, resources, and prompts in one call and returns a single JSON snapshot — handy for diffing a server's surface over time in CI.
- [List a harness's native built-in tools](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/harness/list-a-harnesss-native-built-in-tools.md): The native tools an agent harness (e.g. `claude-code`) runs INSIDE its sandbox — Bash, Read, Edit, Glob, Grep, WebSearch, and the like. Display-only: these execute via the harness's own agent loop and are NOT callable through MCPJam. Static published-package metadata; no project scope.
- [Create a host (from a template or a full config)](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/create-a-host-from-a-template-or-a-full-config.md): Creates a host in the project and responds `201` with the new host's detail. Seed the host config one of two ways: pass `template` (a built-in template id, optional `theme`) to seed server-side from the live backend host catalog, falling back to the bundled SDK catalog snapshot if the live catalog i…
- [Delete a host](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/delete-a-host.md): Permanently delete a host from the project. Pass `{ "force": true }` to delete a host that is still referenced (e.g. by an eval suite). Guest callers are denied (a write).
- [Duplicate a host](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/duplicate-a-host.md): Copies the host and responds `201` with the new host's detail. The copy SHARES the source's content-addressed config row rather than cloning it, so both hosts continue to describe the same configuration. Requires project admin.
- [Get a host](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/get-a-host.md): One host's full settings, including its resolved host config. A host that exists but belongs to a different project reads as `404 NOT_FOUND`.
- [List a project's hosts](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/list-a-projects-hosts.md): The hosts saved in the project — the named model + capability profiles you attach to chats and eval suites. Returns the `id`s the host detail/update/delete routes take.
- [Replace a host's server attachments](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/replace-a-hosts-server-attachments.md): Sets the host's required and optional server ids without round-tripping its whole config, and responds with the updated host detail. Preserves every other identity field (computer, harness, built-in tools) and trims per-server connection overrides to the kept set. Requires project admin.
- [Update a host](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/hosts/update-a-host.md): Edit a host's display name and/or its host config. Only the fields you pass change. Guest callers are denied (a write).
- [Import OAuth tokens](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/oauth/import-oauth-tokens.md): Stores OAuth tokens you obtained yourself (e.g. via the SDK's `runOAuthLogin` — interactive loopback, headless, or client-credentials) for this server, scoped to your user, project, and server. Subsequent API calls against the server inject the stored access token automatically, and `401`s from the…
- [List prompts](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/primitives/list-prompts.md): Returns the server's prompts as a collection page.
- [List resources](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/primitives/list-resources.md): Returns the server's resources as a collection page.
- [List tools](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/primitives/list-tools.md): Returns the server's tools as a collection page. Each item is the MCP tool definition (`name`, `description`, `inputSchema`, ...).
- [Read a resource](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/primitives/read-a-resource.md): Reads a single resource by URI and returns its contents.
- [Create a project](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/projects/create-a-project.md): Creates a project in the caller's organization and responds `201` with its detail. Requires organization membership and counts against the plan's `maxProjects` limit. Guest callers are denied.
- [Delete a project and everything scoped to it](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/projects/delete-a-project-and-everything-scoped-to-it.md): IRREVERSIBLE, and it cascades: project access grants and invites, the mapped workspace and its memberships, every saved server in the project (each soft-deleted asynchronously, which also rotates the host configs that referenced it), and hosted tasks. Requires project admin. The request body must be…
- [Update project metadata](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/projects/update-project-metadata.md): Updates name, description, icon or visibility. Requires project admin; a non-member gets `404` rather than `403`, so the response never confirms that a project exists. The project's server map is not updatable here — see the per-server routes.
- [Boot your computer from a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/boot-your-computer-from-a-sandbox-image.md): Attach the sandbox image to the caller's computer, which re-provisions it from the pinned image (installed files are wiped). The image must have a `ready` build, and the computer provider must match the build's. Bodyless. Guest callers are denied (a write).
- [Build a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/build-a-sandbox-image.md): Trigger a build of the sandbox image's image and respond `202`. The build runs asynchronously — poll the builds list for status. Bodyless. Guest callers are denied (a write).
- [Create a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/create-a-sandbox-image.md): Create a personal-draft sandbox image from a blueprint and respond `201` with its detail. Build it (`POST .../build`) before a computer can boot from it. Guest callers are denied (a write).
- [Delete a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/delete-a-sandbox-image.md): Permanently delete a sandbox image. Computers booted from it fall back to the base image. Deleting a project-shared image requires project admin. Bodyless — any field is rejected. Guest callers are denied (a write).
- [Get a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/get-a-sandbox-image.md): One sandbox image's blueprint, sharing, and latest build. An image that exists but belongs to a different project reads as `404 NOT_FOUND`.
- [List a project's sandbox images](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/list-a-projects-sandbox-images.md): The custom Computer images (digest-pinned Dockerfiles built into immutable images) saved in the project — your own personal drafts plus the project-shared ones.
- [List a sandbox image's builds](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/list-a-sandbox-images-builds.md): A sandbox image's builds, newest first, each with its status and capped log preview.
- [Reset your computer to its image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/reset-your-computer-to-its-image.md): Reset the caller's computer back to its current image, wiping mutable state. Bodyless. Guest callers are denied (a write).
- [Share a sandbox image with the project](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/share-a-sandbox-image-with-the-project.md): Promote a personal-draft sandbox image to a project-shared one. Requires project admin. Bodyless. Guest callers are denied (a write).
- [Update a sandbox image](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/update-a-sandbox-image.md): Edit a sandbox image's name and/or Dockerfile. Re-build it for the changes to take effect on a computer. Guest callers are denied (a write).
- [Validate a blueprint](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/sandbox-images/validate-a-blueprint.md): Lint blueprint YAML without saving it. Returns 200 with `ok: false` + structured errors for an invalid blueprint; the authoritative rejection still happens at create/update/build.
- [Check OAuth requirement](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/server-diagnostics/check-oauth-requirement.md): Lightweight, no MCP connection: reports whether the server is configured to require an OAuth grant.
- [Run the doctor](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/server-diagnostics/run-the-doctor.md): Runs the full doctor workflow — probe → connect → initialize → capabilities → primitives — and returns a step-by-step report. The richest signal for "is this server healthy, and why not."
- [Validate a server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/server-diagnostics/validate-a-server.md): Connects to the server, initializes the MCP session, and returns a connection snapshot (server info, negotiated capabilities). The same check the hosted inspector runs when you connect a server.
- [Delete a saved server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/servers/delete-a-saved-server.md): Soft-deletes the server and schedules its cascade: MCP Apps views, hosted OAuth credentials, encrypted secret objects, and a rotation of every host config that referenced it. The cascade is ASYNCHRONOUS, so a read immediately after this call may still observe the row. The request body must be empty.
- [Get one saved server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/servers/get-one-saved-server.md): The server's detail, projected toward the hosted shape. Secrets are never included — `hasClientSecret` reports presence only. A server id from another project reads as `404`.
- [Save a server into a project](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/servers/save-a-server-into-a-project.md): Creates a saved MCP server and responds `201` with its detail. This is the provisioning entry point: every eval, host and environment route addresses servers that were created here. Names are unique per workspace, so a clash responds `409` rather than silently returning the existing row. Secret-bear…
- [Update a saved server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/servers/update-a-saved-server.md): Sparse update: omitted fields are unchanged. Renaming re-checks per-workspace uniqueness (`409` on a clash). Editing a server shared as an OAuth connection requires project admin. `clientSecret` and `clearClientSecret` are mutually exclusive.
- [Create (or revive) a relay tunnel for a named project server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/tunnels/create-or-revive-a-relay-tunnel-for-a-named-project-server.md): Registers a server record named `name` if missing, mints a relay tunnel grant for it, and **persists the tunnel bearer URL (including the plaintext `?k=` secret) onto the server record's `url`** so evals and chatboxes can target the tunnel like any remote server. The plaintext persistence is a delib…
- [Revoke a tunnel's live grant](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/api-reference/tunnels/revoke-a-tunnels-live-grant.md): Revokes the grant at the control plane and edge: the public URL stops working immediately and any live tunnel session is disconnected. The server record — including its now-dead `url` — is intentionally left untouched, so the next create revives the tunnel with the same slug.
- [Changelog](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/changelog/overview.md): Track the latest updates, features, and improvements to MCPJam Inspector
- [MCP Apps Conformance](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/apps-conformance.md): Validate MCP Apps tool metadata and ui:// resource wiring from the CLI
- [CI / CD](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/ci.md): Run MCP health checks, conformance suites, and evals in GitHub Actions, GitLab CI, and other CI environments
- [MCPJam as an MCP Server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/mcp-server.md): Run MCPJam as a local stdio MCP server so agents can connect to, exercise, and debug other MCP servers
- [OAuth Conformance](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/oauth-conformance.md): Test your MCP server's OAuth implementation across all registration methods and protocol versions
- [OAuth Login & Debugging](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/oauth-login.md): Authenticate with MCP servers and debug OAuth flows
- [CLI Overview](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/overview.md): Stateless MCP server probing, debugging, OAuth, and conformance from your terminal
- [Command Reference](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/reference.md): Complete flag reference for every mcpjam CLI command
- [Server Inspection](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/server-inspection.md): Probe, diagnose, and export MCP server connectivity and capabilities
- [MCP Tasks](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/tasks.md): Create, inspect, answer and watch MCP Tasks from the CLI — legacy 2025-11-25 and the SEP-2663 extension
- [MCP Tasks Conformance](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/tasks-conformance.md): Validate MCP Tasks wire behavior — legacy and SEP-2663 extension — from the CLI
- [CLI Telemetry](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/telemetry.md): Anonymous command-level telemetry, opt-outs, and debug mode
- [Tools, Resources & Prompts](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/tools-resources-prompts.md): List, read, and call MCP server tools, resources, and prompts
- [XAA Debugger (CLI)](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/cli/xaa.md): Run the full Cross-App Access (ID-JAG) grant chain against your authorization server and MCP server, headlessly, from one command
- [Getting Started](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/getting-started.md): Start testing your MCP server in minutes
- [My First ChatGPT App](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/guides/first-chatgpt-app-react.md): Build a simple Coffee Shop ChatGPT App with React
- [My First MCP App](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/guides/first-mcp-app.md): Build a simple Reservation MCP App from scratch
- [Hosted App](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/hosted/overview.md): Use MCPJam Inspector in the browser — no installation required
- [Slack](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/hosted/slack.md): Run MCPJam from Slack — mention the bot to ask about your projects, and approve the actions that spend credits
- [MCPJam](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/index.md): Test, debug, and evaluate MCP servers, MCP apps, and ChatGPT apps.
- [Claude Code and Codex hosts](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/claude-code-host.md): Run the real Claude Code or Codex agent inside your project's Computer — observe native tools, MCP client, and execution behavior directly
- [Clients](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/clients.md): Reusable MCP client configurations for testing servers and apps under realistic conditions
- [Compatibility](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/compatibility.md): Check whether your MCP server works on each AI host — conformance gates, per-host findings, and live widget rendering.
- [Computer](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/computer.md): A personal cloud Linux workstation for your project — open a terminal, run tools, and give your agents a real bash environment
- [Multi-server connections](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/connecting-servers.md): Connect to multiple MCP servers with different transport methods
- [Tracing & debugging](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/debugging.md): See all messages sent to and from your MCP server
- [MCP Docs Server](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/docs-server.md): Connect AI applications to MCPJam documentation
- [Evaluate](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/evals.md): Author test cases for your MCP server, run them across models, and gate pass/fail on deterministic checks plus optional LLM-as-judge.
- [OAuth Debugger](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/guided-oauth.md): Debug your MCP server's OAuth implementation at every step of the handshake
- [Home](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/home.md): Org-scoped dashboard with activity stats, recommended servers, and quick-start clients
- [Host Compatibility](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/host-compat.md): See which hosts your MCP server will work in — Claude, ChatGPT, Cursor, Copilot, Codex — the moment you connect
- [Contribute a Host](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/host-templates.md): Add a new host preset to MCPJam so widgets can render under that host's identity, capabilities, and sandbox policy.
- [Launch from Code (Beta)](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/launch-from-code.md): Programmatically launch and configure MCPJam Inspector from your code or build tools
- [Playground](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/playground.md): Chat with your MCP servers, invoke tools by hand, render widgets, and inspect every step — all in one IDE-style workspace
- [Plugins](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/plugins.md): Import and manage OpenAI plugin bundles as versioned, read-only projections of their skills and MCP servers
- [Projects](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/projects.md): Group your MCP servers into projects, with the ability to share them with your team
- [MCP protocol versions](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/protocol-versions.md): Pin the inspector to a specific MCP protocol version — including the 2026-07-28 stateless RC — to test how your server behaves across versions.
- [Skills](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/skills.md): Load and use skills to give your agents the context they need to use MCP tools effectively
- [MCP Inspector](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/tools-prompts-resources.md): Manually test your MCP server's tools, resources, and prompts
- [XAA Debugger](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/inspector/xaa-debugger.md): Configure and debug Cross-App Access flows with MCPJam as the test identity provider and client/agent
- [Installation](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/installation.md): Here's a list of all ways to start MCPJam
- [API keys](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/reference/api-keys.md): Which 'API key' is which in MCPJam — and the one you need to call the MCPJam API.
- [MCPJam API](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/reference/public-api.md): Programmatic access to the MCP servers in your MCPJam projects — diagnostics, tool calls, prompt rendering, and asynchronous eval runs.
- [Connecting to MCP Servers](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/concepts/connecting-servers.md): Learn how to connect to local and remote MCP servers
- [Testing Across Providers](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/concepts/multi-provider.md): Compare your MCP server's performance across different LLMs
- [Running Evals](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/concepts/running-evals.md): Measure tool accuracy with statistical evaluations
- [Save Results to MCPJam](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/concepts/saving-results.md): Save eval results to the MCPJam dashboard with an MCPJam API key (sk_…) for tracking and CI visibility
- [Testing with LLMs](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/concepts/testing-with-llms.md): Use HostRunner to run prompts and inspect tool calls
- [@mcpjam/sdk](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/index.md): MCP server unit testing, end-to-end (e2e) testing, and server evals
- [Migrating to SDK 3.0](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/migrating-to-v3.md): What changed, why a passing test can start failing, and how to upgrade.
- [Quickstart](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/quickstart.md): Get started with @mcpjam/sdk in 5 minutes
- [MCP Apps Conformance SDK](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/apps-conformance.md): Programmatic MCP Apps surface validation with MCPAppsConformanceTest
- [Saving Eval Results](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/eval-reporting.md): API reference for saving eval results to MCPJam
- [EvalSuite](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/eval-suite.md): API reference for EvalSuite
- [EvalTest](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/eval-test.md): API reference for EvalTest
- [host-compat](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/host-compat.md): API reference for @mcpjam/sdk/host-compat — derive server requirements, evaluate host compatibility, and scan widget bridge usage.
- [HostRunner](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/host-runner.md): API reference for HostRunner
- [LLM Providers](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/llm-providers.md): API reference for LLM provider configuration
- [MCPClientManager](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/mcp-client-manager.md): API reference for MCPClientManager
- [OAuth Conformance SDK](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/oauth-conformance.md): Programmatic OAuth conformance testing with OAuthConformanceTest and OAuthConformanceSuite
- [OAuth Client Emulation](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/oauth-emulation.md): Run a headless OAuth preflight that emulates a real client's authentication ladder against an MCP server
- [PromptResult](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/prompt-result.md): API reference for PromptResult
- [Protocol Conformance SDK](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/protocol-conformance.md): Programmatic MCP protocol conformance testing with MCPConformanceTest and MCPConformanceSuite
- [MCP Tasks Conformance SDK](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/tasks-conformance.md): Programmatic MCP Tasks wire validation with MCPTasksConformanceTest
- [Validators](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/sdk/reference/validators.md): API reference for validator functions
- [Common MCP Errors](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/troubleshooting/common-errors.md): Solutions to common MCP server connection and configuration issues
- [Error code reference](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/troubleshooting/error-codes.md): What every MCPJam Inspector error code means, the likely causes, and the next step to fix it.

## OpenAPI Specs

- [openapi](https://mcpjam-mintlify-docs-update-pr-3805-1786322307955.mintlify.site/reference/openapi.json)

## Optional

- [Discord](https://discord.gg/JEnDtz8X6z)
- [GitHub](https://github.com/MCPJam/inspector)
- [Website](https://mcpjam.com)