Skip to main content
GET
Get a scenario

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.

scenarioId
string
required

Scenario ID, as returned by the project's scenario list.

Response

The scenario settings.

A scenario's full read-only settings: the summary fields plus the host execution config and resolved servers.

id
string
required
name
string
required
serverCount
integer
required
serverNames
string[]
required
requireToolApproval
boolean
required
servers
object[]
required
projectId
string | null
description
string | null
mode
enum<string> | null

Who can use the scenario.

Available options:
project_members,
invited_only,
anyone_with_link,
null
hostStyle
string | null

Chat surface style the scenario renders (e.g. claude, chatgpt).

hostId
string | null

The named host the scenario publishes (hosts and scenarios are 1:1).

hostName
string | null

Share link for the scenario. The URL embeds the access token; visible to any caller who can read the scenario (the same audience that sees it in the hosted UI).

createdAt
number | null

Unix epoch milliseconds.

updatedAt
number | null

Unix epoch milliseconds.

modelId
string | null

Model the scenario chats with.

systemPrompt
string | null
temperature
number | null