Repository navigation
Description
Split B of #1851 (mcpx docs interface pages), filed by queue triage task 2741 (2026-10-29) so the page set lands in two reviewable pieces.
Write the prose level-2 pages for: mcp (overview; mcp-sdk — the three readings in #1851 answered honestly; mcp-compatibility) and http-api (/v1 prose around the spec; /v1-sdk per #1851's recommended Approach C — document generation from /v1/openapi.json with standard tools, the unix-socket caveat, and the tools-vs-daemon OpenAPI callout). Content spec and anchors: #1851.
Triage notes (verified on main 82b019a0, 2026-10-29): Finding 2 is resolved (mcpx openapi is generated from the ops table, so the spec is producible offline). Generated content is linked/included, never hand-copied: the /v1 rendering and protocol revision matrix belong to #1846 — include its fragments if landed by claim time, else link docs/protocol.md / docs/parity.md and name the interim source on the page. Split A (interfaces/CLI/binary/scripts) is the sibling sub-issue of #1851 filed alongside this one.
Acceptance criteria
- Prose level-2 pages exist for mcp (overview; mcp-sdk — the three readings in mcpx docs: interface pages -- abstract and client interfaces, CLI, MCP, binary, script, /v1 and the SDKs #1851 answered honestly; mcp-compatibility) and http-api (
/v1prose around the spec;/v1-sdk per mcpx docs: interface pages -- abstract and client interfaces, CLI, MCP, binary, script, /v1 and the SDKs #1851's recommended Approach C: document generation from/v1/openapi.jsonwith standard tools, the unix-socket caveat stated, and the tools-vs-daemon OpenAPI distinction called out explicitly). - The
/v1spec used is producible offline (mcpx openapiis generated from the ops table); no generated spec content is hand-copied — the /v1 rendering and protocol revision matrix are included from mcpx docs: markdown emitters in the binary and a drift check for every generated page #1846's fragments if landed by claim time, else linked fromdocs/protocol.md/docs/parity.mdwith the interim source named on the page. - The docs build/validation for pkgs/mcpx passes in CI on the implementing PR.
- Sibling split A (mcpx docs interface pages A: interfaces, CLI, binary, scripts prose pages (split of #1851) #2108) is untouched by this issue's PR; together mcpx docs interface pages A: interfaces, CLI, binary, scripts prose pages (split of #1851) #2108 + mcpx docs interface pages B: MCP and /v1 (http-api) prose pages (split of #1851) #2109 close out parent mcpx docs: interface pages -- abstract and client interfaces, CLI, MCP, binary, script, /v1 and the SDKs #1851's page set.
Activity
developing-today commentedon Oct 29, 2026
CODE-1014
dezren39 commentedon Oct 29, 2026
Intake review
Fleet monitor intake pass (protocol §5), 2026-10-28 ~23:20 CDT.
82b019a0per the triage notes on the issue (Commands()/dispatch parity test, ops-table OpenAPI generation, dependencies doc correction).queue/queuedwas missing).Acceptance criteria were appended to the issue body this pass (original text preserved verbatim above them).
55 remaining items
dezren39 commentedon Oct 30, 2026
Agent note — picked up (resume)
dezren39 commentedon Oct 30, 2026
Agent note — parked (merge queue)
dezren39 commentedon Oct 30, 2026
🤖 Agent note · done