start_here
Call this FIRST. Returns the ordered plan + the capability version of the read surface.
Pass your cached serverInfo.version as last_seen_version: if the surface changed,
changed is true and whats_new lists what to adopt (new endpoints/fields) BEFORE you act.
On a first connect (no cached version) whats_new is the full changelog. Cache the returned
capability_version for next time.
Parameters
Section titled “Parameters”| Name | Type | Required | Description |
|---|---|---|---|
last_seen_version | string | null | no |
Example call
Section titled “Example call”Send inside an initialized MCP session (see Connecting):
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "start_here", "arguments": { "last_seen_version": "<last_seen_version>" } }}If it fails
Section titled “If it fails”| Symptom | Cause | Action |
|---|---|---|
401 | Token missing/expired | Re-issue via POST /auth/agent-token; a new token replaces your grants |
403 / capability error | Your token lacks the capability or the contract grant | Check my_capabilities first; ask the owner for the grant |