gradeNot graded
ui_navigateAction
Navigate the MCPJam inspector to a page. The user sees the page change. Valid targets: chat, client-config, clients, compatibility, computer, conformance, environments, evals, evaluate, home, host-compare, learning, oauth-flow, organizations, playground, profile, project-settings, prompts, registry, resources, scenarios, servers, sessions, settings, skills, support, swarms, tasks, tools, webmcp, xaa-flow. Deep paths like 'evals/suite/<suiteId>' are allowed.
View tool JSON
{
"name": "ui_navigate",
"kind": "act",
"impl": "imperative",
"description": "Navigate the MCPJam inspector to a page. The user sees the page change. Valid targets: chat, client-config, clients, compatibility, computer, conformance, environments, evals, evaluate, home, host-compare, learning, oauth-flow, organizations, playground, profile, project-settings, prompts, registry, resources, scenarios, servers, sessions, settings, skills, support, swarms, tasks, tools, webmcp, xaa-flow. Deep paths like 'evals/suite/<suiteId>' are allowed.",
"inputSchema": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Page to open: a tab name (e.g. 'playground') or deep path (e.g. 'evals/suite/<id>')."
}
},
"required": [
"target"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_select_serverAction
Select a connected MCP server in the MCPJam inspector by name, making it the focused server for the tools/resources views. Fails if the server is unknown or disconnected.
View tool JSON
{
"name": "ui_select_server",
"kind": "act",
"impl": "imperative",
"description": "Select a connected MCP server in the MCPJam inspector by name, making it the focused server for the tools/resources views. Fails if the server is unknown or disconnected.",
"inputSchema": {
"type": "object",
"properties": {
"serverName": {
"type": "string",
"description": "Server name to focus."
}
},
"required": [
"serverName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_set_app_contextAction
Change the MCPJam playground's emulated app context: theme (light/dark), device type, widget display mode, locale, or time zone. The user sees the change immediately.
View tool JSON
{
"name": "ui_set_app_context",
"kind": "act",
"impl": "imperative",
"description": "Change the MCPJam playground's emulated app context: theme (light/dark), device type, widget display mode, locale, or time zone. The user sees the change immediately.",
"inputSchema": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"light",
"dark"
]
},
"deviceType": {
"type": "string",
"enum": [
"fill",
"mobile",
"tablet",
"desktop",
"custom"
],
"description": "'fill' = the default, fits the panel; the rest are fixed-size presets."
},
"displayMode": {
"type": "string",
"enum": [
"inline",
"pip",
"fullscreen"
]
},
"locale": {
"type": "string",
"description": "BCP 47 locale, e.g. 'en-US'."
},
"timeZone": {
"type": "string",
"description": "IANA time zone, e.g. 'Europe/Paris'."
}
},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_snapshot_appAnswer
Read what the user currently sees — the open screen, the servers they have selected and their connection status, plus the detailed state of any screen that reports it (e.g. the Playground's selected tool, form values, and last result). Changes nothing. Use it to observe before acting. Pass 'surface' to read one screen; omit it for the whole app.
View tool JSON
{
"name": "ui_snapshot_app",
"kind": "answer",
"impl": "imperative",
"description": "Read what the user currently sees — the open screen, the servers they have selected and their connection status, plus the detailed state of any screen that reports it (e.g. the Playground's selected tool, form values, and last result). Changes nothing. Use it to observe before acting. Pass 'surface' to read one screen; omit it for the whole app.",
"inputSchema": {
"type": "object",
"properties": {
"surface": {
"type": "string",
"description": "Optional screen id to read on its own, e.g. 'playground'. Omit for the whole app."
}
},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_open_server_formAction
Open the Add-server form on the Connect screen, optionally prefilled, and leave it for the user to review and submit. Use this when the user should make the final call, when you don't have everything a server needs, or when a server needs a secret API key or header (the user types those into the form). To add a fully-specified server outright, use ui_add_server.
View tool JSON
{
"name": "ui_open_server_form",
"kind": "act",
"impl": "imperative",
"description": "Open the Add-server form on the Connect screen, optionally prefilled, and leave it for the user to review and submit. Use this when the user should make the final call, when you don't have everything a server needs, or when a server needs a secret API key or header (the user types those into the form). To add a fully-specified server outright, use ui_add_server.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name for the server, e.g. 'Excalidraw'."
},
"transport": {
"type": "string",
"enum": [
"http",
"stdio"
],
"description": "Defaults to 'http'."
},
"url": {
"type": "string",
"description": "HTTP servers only. Hosted deployments require https."
},
"command": {
"type": "string",
"description": "STDIO servers only: the executable, with no arguments."
},
"args": {
"type": "array",
"items": {
"type": "string"
},
"description": "STDIO servers only: arguments, one per entry."
}
},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_add_serverAction
Add an MCP server to the current project and save it, without connecting. The user is taken to the Connect screen and sees it appear. Connect it afterwards with ui_connect_server. Fails if a server with that name already exists, or if it would need a secret env var or header — use ui_open_server_form for those so the user can enter the secret.
View tool JSON
{
"name": "ui_add_server",
"kind": "act",
"impl": "imperative",
"description": "Add an MCP server to the current project and save it, without connecting. The user is taken to the Connect screen and sees it appear. Connect it afterwards with ui_connect_server. Fails if a server with that name already exists, or if it would need a secret env var or header — use ui_open_server_form for those so the user can enter the secret.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name for the server, e.g. 'Excalidraw'."
},
"transport": {
"type": "string",
"enum": [
"http",
"stdio"
],
"description": "Defaults to 'http'."
},
"url": {
"type": "string",
"description": "HTTP servers only. Hosted deployments require https."
},
"command": {
"type": "string",
"description": "STDIO servers only: the executable, with no arguments."
},
"args": {
"type": "array",
"items": {
"type": "string"
},
"description": "STDIO servers only: arguments, one per entry."
}
},
"required": [
"name"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_connect_serverAction
Connect a saved MCP server, and report what happened. Use it for a server that is disconnected or failed. If the server needs the user to authorize it, this reports 'authorization_required' rather than authorizing on their behalf — relay that and let them click Authorize.
View tool JSON
{
"name": "ui_connect_server",
"kind": "act",
"impl": "imperative",
"description": "Connect a saved MCP server, and report what happened. Use it for a server that is disconnected or failed. If the server needs the user to authorize it, this reports 'authorization_required' rather than authorizing on their behalf — relay that and let them click Authorize.",
"inputSchema": {
"type": "object",
"properties": {
"serverName": {
"type": "string",
"description": "Server to connect."
}
},
"required": [
"serverName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_disconnect_serverAction
Disconnect a connected MCP server, leaving its configuration in place. Reconnect it later with ui_connect_server.
View tool JSON
{
"name": "ui_disconnect_server",
"kind": "act",
"impl": "imperative",
"description": "Disconnect a connected MCP server, leaving its configuration in place. Reconnect it later with ui_connect_server.",
"inputSchema": {
"type": "object",
"properties": {
"serverName": {
"type": "string",
"description": "Server to disconnect."
}
},
"required": [
"serverName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_remove_serverSensitive Action
Delete an MCP server from the current project, including its saved configuration. This cannot be undone from chat — the user would have to add the server again.
View tool JSON
{
"name": "ui_remove_server",
"kind": "transact",
"impl": "imperative",
"description": "Delete an MCP server from the current project, including its saved configuration. This cannot be undone from chat — the user would have to add the server again.",
"inputSchema": {
"type": "object",
"properties": {
"serverName": {
"type": "string",
"description": "Server to remove."
}
},
"required": [
"serverName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_open_playgroundAction
Open the MCPJam UI Playground (visible to the user), optionally focusing one server. Prefer calling this before ui_select_tool / ui_execute_tool / ui_snapshot_app.
View tool JSON
{
"name": "ui_open_playground",
"kind": "act",
"impl": "imperative",
"description": "Open the MCPJam UI Playground (visible to the user), optionally focusing one server. Prefer calling this before ui_select_tool / ui_execute_tool / ui_snapshot_app.",
"inputSchema": {
"type": "object",
"properties": {
"serverName": {
"type": "string",
"description": "Optional server to focus the playground on."
}
},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_select_toolAction
Prefill (do not run) an MCP tool's parameter form in the UI Playground — the safe, reversible counterpart of ui_execute_tool. The user sees the form fill in and can review or run it themselves. Opens the playground first if needed.
View tool JSON
{
"name": "ui_select_tool",
"kind": "act",
"impl": "imperative",
"description": "Prefill (do not run) an MCP tool's parameter form in the UI Playground — the safe, reversible counterpart of ui_execute_tool. The user sees the form fill in and can review or run it themselves. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {
"toolName": {
"type": "string",
"description": "MCP tool to select."
},
"serverName": {
"type": "string",
"description": "Server the tool belongs to (defaults to focused)."
},
"parameters": {
"type": "object",
"description": "Parameter values to prefill."
}
},
"required": [
"toolName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_execute_toolAction
Execute an MCP tool against the user's connected server from the UI Playground and render the result there. This REALLY runs the tool — real side effects on the user's MCP server. Prefer ui_select_tool when the user has not clearly asked to run it. Opens the playground first if needed.
View tool JSON
{
"name": "ui_execute_tool",
"kind": "act",
"impl": "imperative",
"description": "Execute an MCP tool against the user's connected server from the UI Playground and render the result there. This REALLY runs the tool — real side effects on the user's MCP server. Prefer ui_select_tool when the user has not clearly asked to run it. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {
"toolName": {
"type": "string",
"description": "MCP tool to execute."
},
"serverName": {
"type": "string",
"description": "Server the tool belongs to (defaults to focused)."
},
"parameters": {
"type": "object",
"description": "Arguments to call the tool with."
}
},
"required": [
"toolName"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_select_modelAction
Select the model the MCPJam UI Playground chat uses. Pass a model identifier as the picker shows it (its id, e.g. 'claude-sonnet-5', or its display name). Resolves against the available models; an unknown one is rejected. The user sees the model chip update. Opens the playground first if needed.
View tool JSON
{
"name": "ui_select_model",
"kind": "act",
"impl": "imperative",
"description": "Select the model the MCPJam UI Playground chat uses. Pass a model identifier as the picker shows it (its id, e.g. 'claude-sonnet-5', or its display name). Resolves against the available models; an unknown one is rejected. The user sees the model chip update. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model id or display name to select."
}
},
"required": [
"model"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_set_system_promptAction
Set the MCPJam UI Playground chat's system prompt to the given text (the user is directing it). Pass an empty string to clear it. The prompt applies to the next turn; the user sees the system-prompt control reflect it. Opens the playground first if needed.
View tool JSON
{
"name": "ui_set_system_prompt",
"kind": "act",
"impl": "imperative",
"description": "Set the MCPJam UI Playground chat's system prompt to the given text (the user is directing it). Pass an empty string to clear it. The prompt applies to the next turn; the user sees the system-prompt control reflect it. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "The system prompt text to apply. Empty string clears it."
}
},
"required": [
"prompt"
],
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_reset_chatAction
Start a new / reset the MCPJam UI Playground chat, clearing the current conversation. This LOSES the conversation — it cannot be undone. Runs the same reset the Clear-chat button does. Opens the playground first if needed.
View tool JSON
{
"name": "ui_reset_chat",
"kind": "act",
"impl": "imperative",
"description": "Start a new / reset the MCPJam UI Playground chat, clearing the current conversation. This LOSES the conversation — it cannot be undone. Runs the same reset the Clear-chat button does. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}ui_stop_generationAction
Stop an in-flight response in the MCPJam UI Playground chat. Succeeds as a no-op if nothing is generating. Opens the playground first if needed.
View tool JSON
{
"name": "ui_stop_generation",
"kind": "act",
"impl": "imperative",
"description": "Stop an in-flight response in the MCPJam UI Playground chat. Succeeds as a no-op if nothing is generating. Opens the playground first if needed.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/p/v972332xvd0es6aa4xgye61de58gk6s6/home"
}