Skip to content

Gold MCP

Terminal window
ziggurat mcp --root <vault>

Shipped MCP startup is Gold-only and read-only. There is no selectable profile, so review and evidence cannot be reached through it.

The server exposes exactly two tools:

ToolPurpose
search_contextSearch authorized Gold and return citation-scoped results
read_contextRead a previously returned citation by ID

Tool inputs are strict.

BoundValue
Query length1,024 UTF-16 code units
Results per search20
Retained citations per session200

Over-long queries are refused rather than truncated. When the citation ceiling is reached, the oldest citation IDs are evicted and become invalid: a read against an evicted ID fails closed with the same error as a forged ID.

Every retrieved chunk carries content_role: reference and instruction_authority: none.

Stored chunks, labels, lineage, proposal provenance, authorization provenance, BM25 data, trust policy, and the live corpus are verified at startup and again before both search and citation reads. A mismatch prevents startup or the next operation rather than returning a degraded answer.

The VS Code binding in .vscode/mcp.json starts the Gold MCP server without a selectable profile. Configure the model endpoint only in config/adapters.yaml, and only as an HTTP loopback address.

Terminal window
ziggurat query --root <vault> --query "<text>"

query reads the same Gold index from the terminal.