feat: expose mcp contributor docs resources

Author: squaeragent

docs/backlog.md

@@ -69,6 +69,7 @@ Evidence:
 - [Clean-download release evidence](releases/v0.1.1-evidence.md)
 - [Release verification guide](release-verification.md)
 - [CLI doctor troubleshooting guide](cli-doctor-troubleshooting.md)
+- [Read-only MCP contributor docs resources](mcp.md)
 
 Do not create new first-release tasks unless a future release target changes
 artifact requirements or public safety claims.

docs/contributor-issue-board.md

@@ -20,11 +20,12 @@ Use the GitHub labels when choosing work:
 
 ## Help Wanted
 
-- [#23 Expand read-only MCP strategy resources](https://github.com/zero-intel/zero/issues/23)
 - [#24 Design public Network empty and stale states](https://github.com/zero-intel/zero/issues/24)
 
 ## Completed Seed Issues
 
+- [#23 Expand read-only MCP strategy resources](https://github.com/zero-intel/zero/issues/23) -
+  delivered in [ZERO MCP Server](mcp.md).
 - [#25 Add release evidence reader docs](https://github.com/zero-intel/zero/issues/25) -
   delivered in [Release Verification Guide](release-verification.md).
 - [#20 Add CLI doctor troubleshooting examples](https://github.com/zero-intel/zero/issues/20) -

docs/launch-issues.md

@@ -118,6 +118,8 @@ Labels: `help wanted`, `mcp`, `docs`, `agent-eligible`
 
 GitHub: [#23](https://github.com/zero-intel/zero/issues/23)
 
+Status: delivered in [ZERO MCP Server](mcp.md).
+
 Improve the read-only MCP resources so coding agents can discover strategy
 runner docs, strategy plugin docs, and market-data adapter docs without reading
 the entire repository.

docs/launch-scorecard.md

@@ -65,6 +65,8 @@ reserved for ZERO Intelligence.
   SBOM/provenance metadata, Homebrew formula drift, and clean-download evidence
 - CLI doctor troubleshooting guide for missing tokens, stopped paper API, and
   fail-closed live preflight warnings
+- Read-only MCP markdown resources for strategy runner, strategy plugin, and
+  market-data adapter contributor docs
 - Public boundary audit from the private repo
 
 ## Paper-Only

docs/llms-full.txt

@@ -7,7 +7,9 @@ status, health, journal tail, rejection audit, local memory snapshots and stats,
 genesis proposal classifications, evolve gate status, research command-chain
 reports, the public decision stack, immune status, deterministic backtest
 summary, hash-only evidence bundle, safety catalog, and the demo proof-pack
-manifest.
+manifest. It also exposes contributor-facing strategy runner, strategy plugin,
+and market-data adapter docs as markdown resources so coding agents can find
+the right extension path without scanning the full repository.
 
 It does not expose live execution, order placement, approval, wallet, secret, or
 venue-write tools. The server is for inspection and local development until live
@@ -52,7 +54,8 @@ stats, inspect plan-only genesis proposals, inspect paper-only evolve gates,
 inspect paper-only research reports, inspect the lens/layer/modifier decision
 stack, inspect production-parity OODA reports, inspect
 journal/rejection/immune/evidence/backtest surfaces, list resources, and read
-the proof pack without gaining any live execution capability.
+the proof pack and contributor docs without gaining any live execution
+capability.
 
 ## Tools
 
@@ -105,6 +108,9 @@ All tools declare `canPlaceOrders=false`, `canChangeRuntimeState=false`, and
 | `zero://backtest/report` | Deterministic paper backtest report without PnL claims. |
 | `zero://evidence/bundle` | Hash-only public-safe evidence bundle. |
 | `zero://mcp/safety` | Safety classification for every public MCP tool. |
+| `zero://docs/strategy-runner` | Markdown docs for declarative paper strategy runners. |
+| `zero://docs/strategy-plugin` | Markdown docs for deterministic paper strategy plugins. |
+| `zero://docs/market-data-adapters` | Markdown docs for deterministic market-data adapters. |
 
 ## Smoke Contract
 

docs/mcp.md

@@ -249,11 +249,12 @@ Exit gate:
 
 Current public status:
 
-- `zero-mcp` now exposes 20 read-only tools and 19 resources for strategies,
+- `zero-mcp` now exposes 20 read-only tools and 22 resources for strategies,
   runtime status, health, paper results, positions, journal tail, rejection
   audit, proof pack, memory snapshot/stats, genesis proposals, evolve status,
   research report, decision stack, immune status, backtest report, evidence
-  bundle, and safety catalog.
+  bundle, safety catalog, and contributor docs for strategy runners, strategy
+  plugins, and market-data adapters.
 - Every public tool declares `safetyClass: read_only_public`,
   `canPlaceOrders: false`, `canChangeRuntimeState: false`, and
   `canReadSecrets: false`.

docs/mcp/transcript.jsonl

@@ -237,6 +237,44 @@ def genesis_proposals_path() -> Path:
     return repo_root() / "examples" / "genesis" / "proposals.jsonl"
 
 
+DOC_RESOURCES: tuple[JsonMap, ...] = (
+    {
+        "uri": "zero://docs/strategy-runner",
+        "name": "Strategy Runner Docs",
+        "description": "Read-only contributor docs for declarative paper strategy runners.",
+        "path": "examples/strategy-runner/README.md",
+        "fallback": (
+            "# Strategy Runner Docs\n\n"
+            "Declarative strategy runners are paper-only examples for coding agents and "
+            "contributors. Use `examples/strategy-runner/close-strength.yaml` as the "
+            "reference fixture and keep new runners deterministic.\n"
+        ),
+    },
+    {
+        "uri": "zero://docs/strategy-plugin",
+        "name": "Strategy Plugin Docs",
+        "description": "Read-only contributor docs for deterministic paper strategy plugins.",
+        "path": "examples/strategy-plugin/README.md",
+        "fallback": (
+            "# Strategy Plugin Docs\n\n"
+            "Strategy plugins are the smallest paper-only contributor path. Keep plugin "
+            "fixtures deterministic, avoid credentials, and include a focused smoke test.\n"
+        ),
+    },
+    {
+        "uri": "zero://docs/market-data-adapters",
+        "name": "Market Data Adapter Docs",
+        "description": "Read-only contributor docs for deterministic market-data adapters.",
+        "path": "examples/market-data-adapter/README.md",
+        "fallback": (
+            "# Market Data Adapter Docs\n\n"
+            "Market-data adapters should load public-safe deterministic fixtures for tests "
+            "and examples. Do not add exchange credentials or live-only dependencies.\n"
+        ),
+    },
+)
+
+
 def load_demo_scenario() -> Any:
     root = find_repo_root()
     if root is None:
@@ -746,7 +784,7 @@ def tool_definitions() -> list[JsonMap]:
 
 
 def resource_definitions() -> list[JsonMap]:
-    return [
+    resources = [
         {
             "uri": "zero://paper/scenario",
             "name": "Bundled Paper Scenario",
@@ -862,6 +900,16 @@ def resource_definitions() -> list[JsonMap]:
             "mimeType": "application/json",
         },
     ]
+    resources.extend(
+        {
+            "uri": str(resource["uri"]),
+            "name": str(resource["name"]),
+            "description": str(resource["description"]),
+            "mimeType": "text/markdown",
+        }
+        for resource in DOC_RESOURCES
+    )
+    return resources
 
 
 def read_resource(uri: str) -> str:
@@ -906,6 +954,19 @@ def read_resource(uri: str) -> str:
         return json.dumps(get_evidence_bundle(), indent=2, sort_keys=True)
     if uri == "zero://mcp/safety":
         return json.dumps(safety_catalog(), indent=2, sort_keys=True)
+    for resource in DOC_RESOURCES:
+        if uri == resource["uri"]:
+            root = find_repo_root()
+            if root is None:
+                return str(resource["fallback"])
+            return (root / str(resource["path"])).read_text(encoding="utf-8")
+    raise KeyError(uri)
+
+
+def resource_mime_type(uri: str) -> str:
+    for resource in resource_definitions():
+        if resource["uri"] == uri:
+            return str(resource["mimeType"])
     raise KeyError(uri)
 
 
@@ -969,11 +1030,12 @@ def handle_request(request: JsonMap) -> JsonMap | None:
         uri = str(params.get("uri", ""))
         try:
             text = read_resource(uri)
+            mime_type = resource_mime_type(uri)
         except KeyError:
             return error_response(request_id, -32602, f"unknown ZERO resource: {uri}")
         return result_response(
             request_id,
-            {"contents": [{"uri": uri, "mimeType": "application/json", "text": text}]},
+            {"contents": [{"uri": uri, "mimeType": mime_type, "text": text}]},
         )
     return error_response(request_id, -32601, f"method not found: {method}")
 

docs/private-engine-capability-gap-audit.md

@@ -116,6 +116,9 @@ def test_resources_list_and_read() -> None:
         "zero://backtest/report",
         "zero://evidence/bundle",
         "zero://mcp/safety",
+        "zero://docs/strategy-runner",
+        "zero://docs/strategy-plugin",
+        "zero://docs/market-data-adapters",
     }
     assert read is not None
     proof = json.loads(read["result"]["contents"][0]["text"])
@@ -138,6 +141,29 @@ def test_resources_list_and_read() -> None:
     assert network_proof["verification"]["ok"] is True
 
 
+def test_strategy_docs_resources_are_markdown_and_read_only() -> None:
+    for uri, expected in {
+        "zero://docs/strategy-runner": "Strategy Runner",
+        "zero://docs/strategy-plugin": "Strategy Plugin",
+        "zero://docs/market-data-adapters": "Market Data Adapter",
+    }.items():
+        response = mcp.handle_request(
+            {
+                "jsonrpc": "2.0",
+                "id": 52,
+                "method": "resources/read",
+                "params": {"uri": uri},
+            }
+        )
+
+        assert response is not None
+        content = response["result"]["contents"][0]
+        assert content["mimeType"] == "text/markdown"
+        assert expected in content["text"]
+        assert "sk_live_" not in content["text"].lower()
+        assert "0x1234567890" not in content["text"].lower()
+
+
 def test_memory_snapshot_is_public_safe() -> None:
     called = mcp.handle_request(
         {
@@ -436,6 +462,7 @@ def test_installed_package_fallback_stays_read_only(monkeypatch) -> None:
     evidence = mcp.get_evidence_bundle()
     catalog = mcp.safety_catalog()
     scenario_text = mcp.read_resource("zero://paper/scenario")
+    strategy_runner_docs = mcp.read_resource("zero://docs/strategy-runner")
 
     assert paper["mode"] == "paper"
     assert paper["fills"] == 2
@@ -463,3 +490,4 @@ def test_installed_package_fallback_stays_read_only(monkeypatch) -> None:
     assert evidence["paper_only"] is True
     assert catalog["risk_increasing_tools"] == []
     assert "paper-launch-smoke" in scenario_text
+    assert "Strategy Runner" in strategy_runner_docs