MCP Response Templates

Called at session boot. Returns tasks, goals, session history, and pending request count. The display field is always rendered verbatim. A pending_requests_hint appears inline when requests are waiting.

Lightweight history of recent relays with app deep-links. Called to orient the agent on recent activity. Render display field verbatim.

Logs a session summary as a relay transfer for future handoff. Called at session end. Returns a Code the agent can share.

Load a session record by context_id — full detail view with chain, description, and timeline. Also in the Sessions section below with per-state examples.

Creates a new relay transfer. Returns a Code for sharing. The title and code are rendered verbatim.

Mandatory two-step flow. Step 1 (confirm: false) always runs first — agent presents the preview and asks "Load it?". Step 2 (confirm: true) only fires after explicit user confirmation. Code is spent after Step 2.

Receives the latest transfer in a named series. Same two-step confirm pattern as relay_transfer_receive.

Lists transfers for the current user. Default status is 'pending'. Each line shows code · title · staleness. Render display field verbatim.

Read a relay the agent sent or has already received — full content and metadata. Returns a framed card. Use relay_transfer_receive for codes not yet received.

Forwards an existing relay, creating a child transfer linked to the original via parent_relay_id. Used for provenance chaining.

Updates an existing transfer's content. Creates a forward under the hood when allow_updates is enabled on the relay.

Expires all pending transfers in a series, revoking receive access. Useful for closing a handoff loop.

Load a series — metadata, full manifest, and recent timeline. Shows all parts with receive status. Renders a framed card with signal line.

Lists all Stream focus areas for the user. Shows name, item counts, weight, and staleness. Render display field verbatim.

Creates a new Stream focus area. Returns context_id for subsequent updates.

Loads a Stream focus area by context_id — returns items, timeline, and weight. Render display field verbatim.

Add, archive, or edit items in a Stream. Also rename or re-describe it. Primary hygiene tool — update after meaningful work to keep context current.

Returns the Stream bound to the current workspace — used by agents for zero-config context discovery without hardcoding a context_id.

The sessions read hub — open sessions and recent closed ones, newest first. Leads with the ▸ top pick (the one open session you'd resume — workspace-scoped when filtered) when the weighting is unambiguous; a tie or a stale newest renders the flat list unchanged. Overflow hands off to the app via the +N more footer.

Load a session record by context_id — status, handoff code, chain (continued-from / packaged-as), description, and timeline. Renders a framed card with signal line and open/closed action hint.

Returns the authenticated user's identity envelope — user ID, org, role, tier. Rendered as a markdown table.

Switches the active org/workspace context. All subsequent tool calls operate within the new scope.

Lists pending connection and receive requests awaiting approval. Approve or deny at app.relayctx.com.

Keyword search across the user's relay workspace. Returns code, title, status, date per result.

Logs a session summary as a transfer for future handoff. Called at session end. Returns a Code the agent can share.