diff --git a/.github/workflows/vscode-marketplace.yml b/.github/workflows/vscode-marketplace.yml
new file mode 100644
index 0000000..c53e4f6
--- /dev/null
+++ b/.github/workflows/vscode-marketplace.yml
@@ -0,0 +1,140 @@
+name: Publish VS Code Marketplace extension
+
+on:
+  workflow_dispatch:
+    inputs:
+      release_ref:
+        description: "Immutable repository tag to package (for example v0.28.0)"
+        required: true
+        type: string
+      publish:
+        description: "Publish the verified VSIX to the VS Code Marketplace after protected-environment review"
+        required: true
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: vscode-marketplace-${{ inputs.release_ref }}
+  cancel-in-progress: false
+
+jobs:
+  authorize:
+    name: authorize protected VS Code publication
+    if: inputs.publish == true
+    runs-on: ubuntu-latest
+    environment: vscode-marketplace
+    steps:
+      - name: Require the scoped VS Code publisher token before candidate work
+        shell: bash
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+        run: |
+          set -euo pipefail
+          test -n "$VSCE_PAT" || {
+            echo "VSCE_PAT is required in the vscode-marketplace environment." >&2
+            exit 1
+          }
+
+  validate:
+    name: validate immutable VS Code candidate
+    needs: authorize
+    if: ${{ always() && (inputs.publish == false || needs.authorize.result == 'success') }}
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: editors/vscode
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ inputs.release_ref }}
+          fetch-depth: 0
+      - name: Require an immutable release tag
+        shell: bash
+        env:
+          RELEASE_REF: ${{ inputs.release_ref }}
+        run: |
+          set -euo pipefail
+          [[ "$RELEASE_REF" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([-+][0-9A-Za-z.-]+)?$ ]] || {
+            echo "release_ref must be an immutable tag such as v0.28.0." >&2
+            exit 1
+          }
+          test "$(git rev-list -n 1 "$RELEASE_REF")" = "$(git rev-parse HEAD)" || {
+            echo "Checked-out commit does not match $RELEASE_REF." >&2
+            exit 1
+          }
+          git tag --points-at HEAD --format='%(refname:short)' | grep -Fx "$RELEASE_REF" >/dev/null || {
+            echo "$RELEASE_REF is not an immutable tag pointing at HEAD." >&2
+            exit 1
+          }
+      - uses: actions/setup-node@v7.0.0
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: editors/vscode/package-lock.json
+      - name: Install, audit, test, and package
+        run: |
+          set -euo pipefail
+          npm ci
+          npm run audit
+          npm test
+          npx vsce package --no-dependencies --out factoryline-vscode.vsix
+      - name: Seal the verified VS Code candidate
+        shell: bash
+        env:
+          RELEASE_REF: ${{ inputs.release_ref }}
+        run: |
+          set -euo pipefail
+          test -f factoryline-vscode.vsix
+          mkdir -p "$GITHUB_WORKSPACE/vscode-marketplace-candidate"
+          cp factoryline-vscode.vsix "$GITHUB_WORKSPACE/vscode-marketplace-candidate/"
+          sha256sum factoryline-vscode.vsix > "$GITHUB_WORKSPACE/vscode-marketplace-candidate/SHA256SUMS.txt"
+          printf 'release_ref=%s\ncommit=%s\npublisher=zrk222\n' \
+            "$RELEASE_REF" "$(git rev-parse HEAD)" > "$GITHUB_WORKSPACE/vscode-marketplace-candidate/manifest.txt"
+      - uses: actions/upload-artifact@v7.0.1
+        with:
+          name: vscode-marketplace-candidate-${{ inputs.release_ref }}
+          path: vscode-marketplace-candidate/
+          if-no-files-found: error
+          retention-days: 14
+
+  publish:
+    name: publish verified VS Code candidate
+    if: ${{ always() && inputs.publish == true && needs.authorize.result == 'success' && needs.validate.result == 'success' }}
+    needs: [authorize, validate]
+    runs-on: ubuntu-latest
+    environment: vscode-marketplace
+    steps:
+      - uses: actions/download-artifact@v8.0.1
+        with:
+          name: vscode-marketplace-candidate-${{ inputs.release_ref }}
+          path: vscode-marketplace-candidate
+      - name: Require the scoped VS Code publisher token
+        shell: bash
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+        run: |
+          set -euo pipefail
+          test -n "$VSCE_PAT" || {
+            echo "VSCE_PAT is required in the vscode-marketplace environment." >&2
+            exit 1
+          }
+      - name: Verify sealed candidate
+        shell: bash
+        run: |
+          set -euo pipefail
+          cd vscode-marketplace-candidate
+          sha256sum --check SHA256SUMS.txt
+          test -f manifest.txt
+          test -f factoryline-vscode.vsix
+      - name: Publish verified VSIX to VS Code Marketplace
+        shell: bash
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+        run: |
+          set -euo pipefail
+          npx --yes @vscode/vsce@3.2.1 publish \
+            --packagePath vscode-marketplace-candidate/factoryline-vscode.vsix \
+            --pat "$VSCE_PAT"
diff --git a/.mcp/server.json b/.mcp/server.json
new file mode 100644
index 0000000..20f9009
--- /dev/null
+++ b/.mcp/server.json
@@ -0,0 +1,40 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.zrk222/code-factory",
+  "title": "Code Factory proof context",
+  "description": "Read-only Graph Ops and proof context for AI coding clients.",
+  "version": "0.28.0",
+  "websiteUrl": "https://zrk222-code-factory.static.hf.space",
+  "repository": {
+    "url": "https://github.com/zrk222/code-factory",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "factoryline-code-factory",
+      "version": "0.28.0",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "runtimeArguments": [
+        {
+          "type": "positional",
+          "value": "factory"
+        }
+      ],
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        },
+        {
+          "type": "positional",
+          "value": "serve"
+        }
+      ]
+    }
+  ]
+}
diff --git a/README.md b/README.md
index a0df9ef..6aa5192 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,16 @@
-# code-factory
+# Code Factory
+
+<!-- mcp-name: io.github.zrk222/code-factory -->
 
 [![CI](https://github.com/zrk222/code-factory/actions/workflows/ci.yml/badge.svg)](https://github.com/zrk222/code-factory/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/factoryline-code-factory.svg)](https://pypi.org/project/factoryline-code-factory/)
 [![Python](https://img.shields.io/pypi/pyversions/factoryline-code-factory.svg)](https://pypi.org/project/factoryline-code-factory/)
 [![Hugging Face Space](https://img.shields.io/badge/Hugging%20Face-Space-ffd21e.svg)](https://huggingface.co/spaces/zrk222/code-factory)
+[![GitHub stars](https://img.shields.io/github/stars/zrk222/code-factory?style=social)](https://github.com/zrk222/code-factory/stargazers)
+[![Latest release](https://img.shields.io/github/v/release/zrk222/code-factory)](https://github.com/zrk222/code-factory/releases/latest)
 
-> One intent, seven software targets, and proof that the gates reject
-> deliberately sabotaged builds.
+> Turn a plain-language outcome into a reviewable MVP with deterministic proof—
+> without pretending generated code is production-ready.
 
 > **Why pay for opaque app generators?** Create a reviewable MVP starting state
 > in minutes—with source-bound receipts, a clear proof path, and an output you
@@ -21,7 +25,32 @@ factory studio --root .\my-mvp
 
 [Watch the exact shipped UI in 60 seconds](https://github.com/zrk222/code-factory/releases/download/v0.28.0/code-factory-quickstart-v0171.mp4)
 to see the outcome-to-MVP path, then open **Graph Ops** in the local Studio to
-inspect the evidence path and next action.
+inspect the evidence path and next action. Prefer a browser preview? Open the
+[live Hugging Face Space](https://zrk222-code-factory.static.hf.space).
+
+**Choose the shortest path:**
+
+| Goal | Start here | What you get |
+| --- | --- | --- |
+| Create | `factory mvp "..."` | A contained, app-shaped starting state |
+| Inspect | `factory studio --root .` | Graph Ops, receipts, and one next action |
+| Connect | [Cursor or OpenCode MCP](docs/AI_CLIENTS.md) | Portable, local proof context |
+| Prove | `factory verify <feature> --root .` | A fail-closed decision with evidence |
+
+## Verify in GitHub Actions
+
+Use the root composite action when a pull request or release should carry the
+same proof decision as a local run:
+
+```yaml
+- uses: zrk222/code-factory@v0.28.1
+  with:
+    feature: my-feature
+```
+
+It uploads the JSON decision and manifest as a workflow artifact, and fails the
+job when the evidence is incomplete. See [GitHub Marketplace action](docs/GITHUB_MARKETPLACE_ACTION.md)
+for the input contract and publication boundary.
 
 ## What Code Factory is
 
@@ -33,6 +62,10 @@ gates; then show what is proven, missing, blocked, or safe to do next. Factory
 Studio and the editor integrations make the same workflow visible without
 granting them release, credential, approval, or publishing authority.
 
+It works with the local workflows developers already use—including Codex,
+Claude Code, Cursor, OpenCode, VS Code, and JetBrains—through the same
+receipt-bound contract rather than a provider-specific lock-in.
+
 It is designed for two speeds: use `factory mvp "..."` to get a novice from
 idea to an inspectable MVP path, or compose capability packs, signed receipts,
 proof reuse, Graph Ops impact analysis, and supervised enterprise controls for
diff --git a/action.yml b/action.yml
new file mode 100644
index 0000000..18d5273
--- /dev/null
+++ b/action.yml
@@ -0,0 +1,70 @@
+name: Code Factory proof verification
+description: Run a fail-closed Code Factory shippability decision and retain its JSON proof artifact.
+author: zrk222
+branding:
+  icon: shield
+  color: green
+
+inputs:
+  feature:
+    description: Existing feature id whose local receipts and verifier evidence should be summarized.
+    required: true
+  root:
+    description: Workspace root passed to Code Factory.
+    required: false
+    default: .
+  package-version:
+    description: Published factoryline-code-factory version to run.
+    required: false
+    default: 0.28.0
+  artifact-name:
+    description: Artifact name used for the JSON proof output.
+    required: false
+    default: code-factory-proof
+
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.12"
+    - name: Install Code Factory
+      shell: bash
+      env:
+        FACTORY_PACKAGE_VERSION: ${{ inputs.package-version }}
+      run: |
+        set -euo pipefail
+        python -m pip install --disable-pip-version-check \
+          "factoryline-code-factory==${FACTORY_PACKAGE_VERSION}"
+    - name: Run fail-closed proof decision
+      shell: bash
+      env:
+        FACTORY_FEATURE: ${{ inputs.feature }}
+        FACTORY_ROOT: ${{ inputs.root }}
+      run: |
+        set -euo pipefail
+        proof_dir="$GITHUB_WORKSPACE/factory-proof"
+        mkdir -p "$proof_dir"
+        set +e
+        factory verify "$FACTORY_FEATURE" --root "$FACTORY_ROOT" --json \
+          | tee "$proof_dir/verify.json"
+        status=${PIPESTATUS[0]}
+        set -e
+        printf 'exit_code=%s\nfeature=%s\n' "$status" "$FACTORY_FEATURE" \
+          > "$proof_dir/manifest.txt"
+        echo "FACTORY_VERIFY_EXIT=$status" >> "$GITHUB_ENV"
+        exit "$status"
+    - name: Upload proof artifact
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ inputs.artifact-name }}
+        path: factory-proof/
+        if-no-files-found: error
+    - name: Preserve the proof decision as the action result
+      if: always()
+      shell: bash
+      run: |
+        set -euo pipefail
+        test "${FACTORY_VERIFY_EXIT:-1}" -eq 0
diff --git a/deploy/huggingface/README.md b/deploy/huggingface/README.md
index 01b9654..4c31acf 100644
--- a/deploy/huggingface/README.md
+++ b/deploy/huggingface/README.md
@@ -12,10 +12,13 @@ tags:
   - devops
   - software-quality
   - mcp
+  - model-context-protocol
+  - cursor
+  - opencode
   - local-first
 pinned: false
 license: apache-2.0
-short_description: Reviewable MVPs with verifier, repair, and workspace proof
+short_description: Proof-backed AI coding workflows with local MCP context
 ---
 
 # Code Factory
@@ -34,6 +37,18 @@ The canonical Python package is
 Release `v0.28.0` is archived under the repository's stable Zenodo concept DOI at
 [Zenodo](https://doi.org/10.5281/zenodo.21381405).
 
+Use the same local proof context from Cursor or OpenCode through the documented
+[MCP connection](https://github.com/zrk222/code-factory/blob/main/docs/AI_CLIENTS.md).
+The client connection is local and read-only; it does not upload source or
+grant provider, credential, deployment, or publishing authority.
+
+Try the public **Proof Playground** before installing: enter an outcome and
+watch a deterministic browser-only preview assemble intent, checks, and a
+local proof reference. It is deliberately not a production mission, does not
+call a model, and never sends the text away. The same page includes copyable
+recipes for repository readiness, contained MVPs, Graph Ops, independent
+verification, Cursor, and OpenCode.
+
 Before a PRD becomes a scaffold, run `factory prd grill PRD.md --root .` for a
 capped, source-bound clarification sheet with recommendations and answer stubs.
 It never rewrites the PRD, invents answers, calls a model, or authorizes a
diff --git a/deploy/huggingface/index.html b/deploy/huggingface/index.html
index 62a53fb..59b0aab 100644
--- a/deploy/huggingface/index.html
+++ b/deploy/huggingface/index.html
@@ -67,15 +67,63 @@
     pre { overflow-x: auto; margin: 0; padding: 24px; border: 1px solid rgba(255,255,255,.14); border-radius: 18px; background: #0d0d0b; color: #ffd47c; font: 600 .95rem/1.7 ui-monospace, SFMono-Regular, Consolas, monospace; }
     .gallery { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; }
     .gallery img { display: block; width: 100%; border-radius: 18px; border: 1px solid var(--line); background: var(--cream); }
+    .playground-section { padding-top: 3vw; }
+    .playground { display: grid; grid-template-columns: .82fr 1.18fr; gap: 20px; padding: clamp(20px, 4vw, 34px); border: 1px solid var(--line); border-radius: var(--radius); background: linear-gradient(135deg, rgba(255,255,255,.88), rgba(255,241,207,.9)); box-shadow: var(--shadow); }
+    .playground-input { padding: 18px 10px 18px 6px; }
+    .playground-input h3 { margin: 10px 0 8px; font-size: clamp(1.6rem, 3vw, 2.4rem); letter-spacing: -.045em; line-height: 1.5; }
+    .bake-action { background: var(--amber); color: var(--ink); border-color: var(--amber); }
+    .bake-action:hover { background: #ffc65d; }
+    .playground-input p { color: var(--muted); }
+    .field-label { display: block; margin: 24px 0 8px; font-size: .9rem; font-weight: 850; letter-spacing: .08em; text-transform: uppercase; }
+    textarea { display: block; width: 100%; min-height: 116px; resize: vertical; padding: 15px 16px; border: 1px solid var(--line); border-radius: 16px; color: var(--ink); background: rgba(255,255,255,.82); font: inherit; line-height: 1.5; }
+    textarea:focus { outline: 3px solid rgba(7,95,216,.22); border-color: var(--focus); }
+    .preset-row { display: flex; flex-wrap: wrap; gap: 8px; margin: 12px 0 20px; }
+    .preset { min-height: 40px; padding: .55rem .78rem; border: 1px solid var(--line); border-radius: 999px; background: rgba(255,255,255,.68); color: var(--muted); font: 750 .85rem/1.2 inherit; cursor: pointer; }
+    .preset:hover, .preset:focus-visible { border-color: var(--amber-dark); color: var(--ink); background: white; }
+    .fine-print { margin: 12px 0 0; color: var(--muted); font-size: .86rem; line-height: 1.5; }
+    .receipt-panel { min-height: 390px; padding: 24px; border: 1px solid rgba(255,255,255,.18); border-radius: 22px; background: var(--ink); color: white; position: relative; overflow: hidden; }
+    .receipt-panel::after { content: ""; position: absolute; inset: auto -20% -60% 20%; height: 70%; background: radial-gradient(circle, rgba(244,169,40,.22), transparent 64%); pointer-events: none; }
+    .receipt-empty { display: grid; min-height: 340px; place-items: center; text-align: center; color: #d9d3c7; position: relative; z-index: 1; }
+    .receipt-empty .oven { display: grid; place-items: center; width: 78px; height: 78px; margin: 0 auto 16px; border: 1px solid rgba(255,255,255,.25); border-radius: 24px; background: #2a2820; color: var(--amber); font-size: 2.2rem; }
+    .receipt-result { position: relative; z-index: 1; }
+    .receipt-top { display: flex; align-items: flex-start; justify-content: space-between; gap: 16px; padding-bottom: 18px; border-bottom: 1px solid rgba(255,255,255,.15); }
+    .receipt-top h3 { margin: 0; font-size: 1.45rem; letter-spacing: -.03em; }
+    .receipt-top p { margin: 4px 0 0; color: #cfc7b7; font-size: .9rem; }
+    .status-badge { display: inline-flex; align-items: center; gap: 6px; padding: 6px 9px; border-radius: 999px; background: rgba(99,208,132,.16); color: #a9efb8; font-size: .78rem; font-weight: 850; white-space: nowrap; }
+    .receipt-stages { display: grid; gap: 10px; margin: 20px 0; }
+    .receipt-stage { display: grid; grid-template-columns: 28px 1fr auto; gap: 10px; align-items: center; padding: 10px 12px; border: 1px solid rgba(255,255,255,.11); border-radius: 12px; color: #bdb5a7; transition: background-color .25s ease, color .25s ease, transform .25s ease; }
+    .receipt-stage.complete { background: rgba(99,208,132,.1); color: white; transform: translateX(3px); }
+    .stage-dot { display: grid; place-items: center; width: 24px; height: 24px; border-radius: 50%; background: #3b382e; color: #cfc7b7; font-size: .74rem; font-weight: 900; }
+    .complete .stage-dot { background: #398354; color: white; }
+    .stage-name { font-weight: 800; }
+    .stage-detail { color: #aaa294; font-size: .82rem; }
+    .complete .stage-detail { color: #a9efb8; }
+    .receipt-foot { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 12px; margin-top: 18px; color: #bdb5a7; font-size: .82rem; }
+    .copy-button { min-height: 42px; padding: .62rem .84rem; border: 1px solid rgba(255,255,255,.2); border-radius: 11px; background: #2a2820; color: white; font: 800 .85rem/1.2 inherit; cursor: pointer; }
+    .copy-button:hover, .copy-button:focus-visible { border-color: var(--amber); color: #ffd47c; }
+    .recipe-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 14px; }
+    .recipe-card { display: flex; flex-direction: column; gap: 12px; min-height: 250px; padding: 22px; border: 1px solid var(--line); border-radius: 20px; background: rgba(255,255,255,.68); }
+    .recipe-card h3 { margin: 0; font-size: 1.2rem; letter-spacing: -.02em; }
+    .recipe-card p { margin: 0; color: var(--muted); font-size: .94rem; line-height: 1.5; }
+    .recipe-card code { display: block; margin-top: auto; padding: 10px; border-radius: 10px; background: #f2e8d1; color: var(--amber-dark); font: 700 .78rem/1.4 ui-monospace, SFMono-Regular, Consolas, monospace; overflow-wrap: anywhere; }
+    .recipe-card .copy-button { align-self: flex-start; border-color: var(--line); background: white; color: var(--ink); }
+    .recipe-card .copy-button:hover, .recipe-card .copy-button:focus-visible { border-color: var(--amber-dark); color: var(--amber-dark); }
+    .mcp-strip { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; align-items: stretch; }
+    .mcp-strip .proof { padding: 30px; }
+    .mcp-note { display: flex; align-items: center; gap: 10px; margin-top: 14px; color: var(--green); font-size: .9rem; font-weight: 750; }
+    .toast { position: fixed; right: 20px; bottom: 20px; z-index: 30; padding: 12px 16px; border-radius: 12px; background: var(--ink); color: white; box-shadow: var(--shadow); font-weight: 750; opacity: 0; transform: translateY(10px); pointer-events: none; transition: opacity .2s ease, transform .2s ease; }
+    .toast.visible { opacity: 1; transform: translateY(0); }
+    @keyframes oven-pulse { 0%, 100% { box-shadow: 0 0 0 0 rgba(244,169,40,.12); } 50% { box-shadow: 0 0 0 12px rgba(244,169,40,0); } }
+    .is-baking .oven { animation: oven-pulse 1.3s ease-in-out infinite; }
     .boundary { margin-top: 18px; color: var(--muted); font-size: .95rem; text-align: center; }
     .final { text-align: center; padding-bottom: 120px; }
     .final h2 { max-width: 16ch; margin: 0 auto 28px; }
     footer { display: flex; justify-content: space-between; gap: 20px; padding: 28px 0 42px; border-top: 1px solid var(--line); color: var(--muted); font-size: .95rem; }
     @media (max-width: 50rem) {
       nav a:not(.button) { display: none; }
-      .hero, .section-head, .proof { grid-template-columns: 1fr; }
+      .hero, .section-head, .proof, .playground, .mcp-strip { grid-template-columns: 1fr; }
       .hero { padding-top: 48px; }
-      .grid, .gallery { grid-template-columns: 1fr; }
+      .grid, .gallery, .recipe-grid { grid-template-columns: 1fr; }
       h1 { font-size: clamp(3.2rem, 17vw, 5.4rem); }
       section { padding: 68px 0; }
       footer { flex-direction: column; }
@@ -84,6 +132,9 @@
       html { scroll-behavior: auto; }
       .button { transition: none; }
       .button:hover { transform: none; }
+      .receipt-stage { transition: none; }
+      .is-baking .oven { animation: none; }
+      .toast { transition: none; }
     }
   </style>
 </head>
@@ -93,6 +144,8 @@
     <header>
       <a class="brand" href="#main" aria-label="Code Factory home"><span class="mark">CF</span> Code Factory</a>
       <nav aria-label="Primary navigation">
+        <a href="#proof-playground">Try proof</a>
+        <a href="#recipes">Recipes</a>
         <a href="#tour">Product tour</a>
         <a href="https://github.com/zrk222/code-factory">GitHub source</a>
         <a class="button" href="#first-run">Start free</a>
@@ -105,7 +158,7 @@
       <div>
         <div class="eyebrow">Open source · Local first · Evidence backed</div>
         <h1>Create your reviewable MVP. See its proof in minutes.</h1>
-        <p class="lede"><strong>Why pay for opaque app generators?</strong> Create a reviewable MVP starting state in minutes—with local receipts, a clear proof path, and an output you can extend when you are ready.</p>
+        <p class="lede"><strong>Why pay for opaque app generators?</strong> Create a reviewable MVP starting state in minutes—with local receipts, a clear proof path, and an output you can extend when you are ready. Use the same proof context in Cursor or OpenCode through local MCP.</p>
         <div class="actions">
           <a class="button primary" href="#first-run">Start free with pip</a>
           <a class="button" href="https://github.com/zrk222/code-factory/releases/download/v0.28.0/code-factory-quickstart-v0171.mp4">Watch the exact 60-second UI</a>
@@ -123,6 +176,48 @@ <h1>Create your reviewable MVP. See its proof in minutes.</h1>
       </figure>
     </div>
 
+    <section id="proof-playground" class="playground-section">
+      <div class="shell">
+        <div class="section-head">
+          <h2>Feel the proof path before you install.</h2>
+          <p>A no-signup browser preview turns one outcome into a reviewable shape. It is a local product tour, not a production mission and never sends your text anywhere.</p>
+        </div>
+        <div class="playground">
+          <div class="playground-input">
+            <div class="eyebrow">Public proof playground</div>
+            <h3>Tell the factory what “done” should mean.</h3>
+            <p>Choose a starting point or write your own. The preview shows how Code Factory makes intent, checks, and receipts visible before you run the real command.</p>
+            <form id="playground-form">
+              <label class="field-label" for="outcome-input">Your outcome</label>
+              <textarea id="outcome-input" maxlength="240">Build an approval tracker with manager review and an audit trail.</textarea>
+              <div class="preset-row" aria-label="Outcome presets">
+                <button class="preset" type="button" data-outcome="Audit a repository before a risky migration.">Repository audit</button>
+                <button class="preset" type="button" data-outcome="Create a release checklist with signed receipts.">Release proof</button>
+                <button class="preset" type="button" data-outcome="Build an approval tracker with manager review and an audit trail.">Approval flow</button>
+              </div>
+              <button class="button bake-action" type="submit">Bake a proof preview</button>
+              <p class="fine-print">Demo boundary: deterministic browser animation only. No model call, source upload, credential access, or deployment.</p>
+            </form>
+          </div>
+          <div class="receipt-panel" id="receipt-output" aria-live="polite">
+            <div class="receipt-empty" id="receipt-empty">
+              <div><div class="oven" aria-hidden="true">CF</div><strong>Your proof receipt will appear here.</strong><br><span>Start with an outcome and watch the line assemble.</span></div>
+            </div>
+            <div class="receipt-result" id="receipt-result" hidden>
+              <div class="receipt-top"><div><h3 id="receipt-title">Proof preview</h3><p id="receipt-outcome"></p></div><span class="status-badge" id="receipt-status">● Ready</span></div>
+              <div class="receipt-stages">
+                <div class="receipt-stage" data-stage="0"><span class="stage-dot">1</span><span class="stage-name">Intent locked</span><span class="stage-detail">bounded outcome</span></div>
+                <div class="receipt-stage" data-stage="1"><span class="stage-dot">2</span><span class="stage-name">Plan shaped</span><span class="stage-detail">checks declared</span></div>
+                <div class="receipt-stage" data-stage="2"><span class="stage-dot">3</span><span class="stage-name">Gates challenged</span><span class="stage-detail">failure paths named</span></div>
+                <div class="receipt-stage" data-stage="3"><span class="stage-dot">4</span><span class="stage-name">Receipt ready</span><span class="stage-detail">reviewable next step</span></div>
+              </div>
+              <div class="receipt-foot"><span id="receipt-id">Local preview · no external claim</span><button class="copy-button" type="button" id="copy-proof">Copy proof reference</button></div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </section>
+
     <section id="proof">
       <div class="shell">
         <div class="section-head">
@@ -152,6 +247,37 @@ <h2>From first MVP to the exact proof path.</h2>
       </div>
     </section>
 
+    <section id="recipes">
+      <div class="shell">
+        <div class="section-head">
+          <h2>Start from a useful recipe.</h2>
+          <p>These are outcomes people can recognize in one glance. Copy the command, then adapt the spec and keep the proof boundary.</p>
+        </div>
+        <div class="recipe-grid">
+          <article class="recipe-card"><span>Audit</span><h3>Repository readiness</h3><p>Find missing tests, contracts, and proof inputs before an agent changes code.</p><code>factory coverage --root . --json</code><button class="copy-button" type="button" data-copy="factory coverage --root . --json">Copy command</button></article>
+          <article class="recipe-card"><span>Build</span><h3>Contained MVP</h3><p>Turn a plain-language outcome into a reviewable local starter with explicit gaps.</p><code>factory mvp &quot;Build an approval tracker&quot; --root .</code><button class="copy-button" type="button" data-copy='factory mvp "Build an approval tracker" --root .'>Copy command</button></article>
+          <article class="recipe-card"><span>Inspect</span><h3>Graph Ops map</h3><p>See products, missions, proofs, gates, traces, and artifacts without executing them.</p><code>factory graph ops --root . --json</code><button class="copy-button" type="button" data-copy="factory graph ops --root . --json">Copy command</button></article>
+          <article class="recipe-card"><span>Verify</span><h3>Independent verifier</h3><p>Bind worker output to distinct checks and reject self-grading or byte drift.</p><code>factory verifier verify ... --json</code><button class="copy-button" type="button" data-copy="factory verifier verify ./session.json ./worker-result.json ./verifier-result.json --root . --json">Copy command</button></article>
+        </div>
+      </div>
+    </section>
+
+    <section id="mcp-recipes">
+      <div class="shell mcp-strip">
+        <div class="proof">
+          <div><div class="eyebrow">MCP recipes</div><h2>Bring the same proof context to your client.</h2><p>Use the read-only local MCP server from Cursor or OpenCode. The connection exposes Graph Ops facts; it does not upload source or grant release authority.</p><div class="mcp-note">✓ Local · read-only · provider keys stay with you</div></div>
+          <pre><code>factory mcp serve --root .</code></pre>
+        </div>
+        <div class="proof">
+          <div><div class="eyebrow">Choose your lane</div><h2>Copy the smallest setup.</h2><p><a href="https://github.com/zrk222/code-factory/blob/main/docs/AI_CLIENTS.md#cursor">Cursor recipe →</a><br><a href="https://github.com/zrk222/code-factory/blob/main/docs/AI_CLIENTS.md#opencode">OpenCode recipe →</a><br><a href="https://github.com/zrk222/code-factory/blob/main/docs/MCP.md">MCP contract →</a></p><div class="mcp-note">✓ Read the contract before connecting</div></div>
+          <pre><code>"factory": {
+  "command": "factory",
+  "args": ["mcp", "serve", "--root", "."]
+}</code></pre>
+        </div>
+      </div>
+    </section>
+
     <section id="first-run">
       <div class="shell proof">
         <div>
@@ -232,9 +358,9 @@ <h2>Start locally. See the next proof gap immediately.</h2>
           <h2>Free through 2026. Clear before the paid change.</h2>
           <p>All features are free through December 31, 2026. A $4.95 USD monthly Marketplace price is planned for January 1, 2027, subject to JetBrains paid-plugin approval and a planned 30-day trial. No checkout is live; total price, taxes, fees, and billing terms must be shown before any approved purchase.</p>
         </div>
-        <pre><code>Observed Marketplace downloads: 46
-Conversion rate: unavailable without Marketplace views
-Causal uplift: unavailable without attribution
+        <pre><code>Marketplace count: check the current listing
+Unique installs: not exposed by the listing
+0.8.4 update: pending Marketplace approval
 
 Never substitute CI or repository traffic for installs.</code></pre>
       </div>
@@ -270,5 +396,89 @@ <h2>Make the next change carry its own proof.</h2>
   <div class="shell">
     <footer><span>Code Factory v0.28.0 · Dual licensed MIT or Apache-2.0</span><span><a href="https://github.com/zrk222/code-factory">GitHub</a> · <a href="https://pypi.org/project/factoryline-code-factory/">PyPI</a> · <a href="https://github.com/zrk222/code-factory/releases/tag/v0.28.0">Verified release</a> · <a href="https://doi.org/10.5281/zenodo.21381405">Zenodo</a></span></footer>
   </div>
+  <div class="toast" id="toast" role="status" aria-live="polite"></div>
+  <script>
+    (() => {
+      const form = document.getElementById('playground-form');
+      const input = document.getElementById('outcome-input');
+      const empty = document.getElementById('receipt-empty');
+      const result = document.getElementById('receipt-result');
+      const panel = document.getElementById('receipt-output');
+      const title = document.getElementById('receipt-title');
+      const outcome = document.getElementById('receipt-outcome');
+      const status = document.getElementById('receipt-status');
+      const receiptId = document.getElementById('receipt-id');
+      const toast = document.getElementById('toast');
+      let reference = '';
+      const reduced = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+
+      const showToast = (message) => {
+        toast.textContent = message;
+        toast.classList.add('visible');
+        window.clearTimeout(showToast.timer);
+        showToast.timer = window.setTimeout(() => toast.classList.remove('visible'), 2200);
+      };
+      const copyText = async (value) => {
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          try { await navigator.clipboard.writeText(value); return true; } catch (error) { /* fall through to the local fallback */ }
+        }
+        const helper = document.createElement('textarea');
+        helper.value = value;
+        helper.setAttribute('readonly', '');
+        helper.style.position = 'fixed';
+        helper.style.opacity = '0';
+        document.body.appendChild(helper);
+        helper.select();
+        let copied = false;
+        try { copied = document.execCommand('copy'); } catch (error) { copied = false; }
+        helper.remove();
+        return copied;
+      };
+      const digest = async (value) => {
+        if (window.crypto && window.crypto.subtle) {
+          const bytes = new TextEncoder().encode(value);
+          const hash = await window.crypto.subtle.digest('SHA-256', bytes);
+          return Array.from(new Uint8Array(hash)).slice(0, 6).map((byte) => byte.toString(16).padStart(2, '0')).join('');
+        }
+        let hash = 2166136261;
+        for (let index = 0; index < value.length; index += 1) hash = Math.imul(hash ^ value.charCodeAt(index), 16777619);
+        return (hash >>> 0).toString(16).padStart(8, '0').slice(0, 12);
+      };
+      const encodeOutcome = (value) => btoa(unescape(encodeURIComponent(value))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+      const decodeOutcome = (value) => decodeURIComponent(escape(atob(value.replace(/-/g, '+').replace(/_/g, '/'))));
+      const runPreview = async (value, updateUrl = true) => {
+        const clean = value.trim().replace(/\s+/g, ' ');
+        if (!clean) { input.focus(); showToast('Add an outcome first.'); return; }
+        input.value = clean;
+        empty.hidden = true;
+        result.hidden = false;
+        panel.classList.add('is-baking');
+        title.textContent = 'Baking your proof preview';
+        outcome.textContent = clean;
+        status.textContent = '● In progress';
+        status.style.color = '#ffd47c';
+        document.querySelectorAll('.receipt-stage').forEach((stage) => stage.classList.remove('complete'));
+        reference = await digest(clean + '|code-factory-public-preview-v1');
+        if (updateUrl) window.history.replaceState({}, '', `${window.location.pathname}#proof=${encodeOutcome(clean)}`);
+        const stages = Array.from(document.querySelectorAll('.receipt-stage'));
+        for (let index = 0; index < stages.length; index += 1) {
+          if (!reduced) await new Promise((resolve) => window.setTimeout(resolve, 360));
+          stages[index].classList.add('complete');
+        }
+        title.textContent = 'Proof preview ready';
+        status.textContent = '● Reviewable';
+        status.style.color = '#a9efb8';
+        receiptId.textContent = `Local preview · reference ${reference} · no external claim`;
+        panel.classList.remove('is-baking');
+      };
+      form.addEventListener('submit', (event) => { event.preventDefault(); runPreview(input.value); });
+      document.querySelectorAll('[data-outcome]').forEach((button) => button.addEventListener('click', () => { input.value = button.dataset.outcome; input.focus(); }));
+      document.querySelectorAll('[data-copy]').forEach((button) => button.addEventListener('click', async () => { showToast(await copyText(button.dataset.copy) ? 'Command copied.' : 'Select the command to copy it.'); }));
+      document.getElementById('copy-proof').addEventListener('click', async () => { showToast(await copyText(`${window.location.origin}${window.location.pathname}#proof=${encodeOutcome(input.value)}`) ? 'Local proof reference copied.' : 'Select the reference to copy it.'); });
+      if (window.location.hash.startsWith('#proof=')) {
+        try { const restored = decodeOutcome(window.location.hash.slice(7)); if (restored) runPreview(restored, false); } catch (error) { /* ignore malformed public preview links */ }
+      }
+    })();
+  </script>
 </body>
 </html>
diff --git a/docs/GITHUB_DISCOVERY.md b/docs/GITHUB_DISCOVERY.md
index 6aee606..5779615 100644
--- a/docs/GITHUB_DISCOVERY.md
+++ b/docs/GITHUB_DISCOVERY.md
@@ -25,6 +25,23 @@ The README then shows the shipped UI walkthrough and an optional GitHub-star
 link. It makes no star-count, download, conversion, productivity, or causal
 growth claim.
 
+## Client and demo discovery
+
+Make the first click useful for both novices and experienced AI-tool users:
+
+- [Live browser preview](https://zrk222-code-factory.static.hf.space) for a
+  no-install product tour.
+- [60-second shipped UI walkthrough](https://github.com/zrk222/code-factory/releases/download/v0.28.0/code-factory-quickstart-v0171.mp4)
+  for the visual path.
+- [Cursor and OpenCode MCP setup](AI_CLIENTS.md) for local, read-only proof
+  context inside the clients developers already use.
+- [PyPI install](https://pypi.org/project/factoryline-code-factory/) for the
+  shortest executable path.
+
+Use one of these links per post, with one concrete question or outcome. Do not
+paste every channel link into a community thread; the extra links dilute the
+action and can look promotional rather than useful.
+
 ## Ethical compounding loop
 
 ```mermaid
diff --git a/docs/GITHUB_MARKETPLACE_ACTION.md b/docs/GITHUB_MARKETPLACE_ACTION.md
new file mode 100644
index 0000000..8bfb167
--- /dev/null
+++ b/docs/GITHUB_MARKETPLACE_ACTION.md
@@ -0,0 +1,32 @@
+# GitHub Marketplace action
+
+The repository root now exposes a composite action in `action.yml`:
+
+```yaml
+- uses: zrk222/code-factory@v0.28.1
+  with:
+    feature: my-feature
+```
+
+`v0.28.1` is the immutable marketplace-candidate tag for this release lane.
+
+The action installs the published `factoryline-code-factory` package, runs
+`factory verify <feature> --json`, uploads the JSON decision and its manifest,
+and returns the verifier's exit code. A failed or incomplete proof therefore
+fails the workflow instead of becoming a green-but-empty badge.
+
+## Listing boundary
+
+The repository is technically Marketplace-ready because the action metadata is
+at the root and the repository is public. A Marketplace listing still requires
+an owner-controlled GitHub release/tag and the Marketplace publication review
+checkbox. Those are deliberately kept as an action-time human step; pushing a
+tag alone is not evidence that the listing is live.
+
+Official guidance: [Publishing actions in GitHub Marketplace](https://docs.github.com/en/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace).
+
+## Local contract
+
+The action is intentionally narrow: it verifies existing Code Factory evidence
+and does not mutate the caller's source tree. Use the `factory-proof` artifact
+to inspect the exact decision when a gate fails.
diff --git a/docs/MCP_REGISTRY.md b/docs/MCP_REGISTRY.md
new file mode 100644
index 0000000..d36f7e9
--- /dev/null
+++ b/docs/MCP_REGISTRY.md
@@ -0,0 +1,31 @@
+# MCP Registry release lane
+
+Code Factory ships a read-only, stdio MCP server over the same local Graph Ops
+facts used by Studio and the IDE adapters. The candidate manifest is
+[`../.mcp/server.json`](../.mcp/server.json).
+
+## Current boundary
+
+The manifest targets the published PyPI package `factoryline-code-factory` at
+`0.28.0`. The package ownership marker is present in the root README, but the
+registry entry is not claimed as published until the exact package metadata and
+publisher authentication have both been verified.
+
+The server is local and read-only. It does not grant process execution,
+approval, publishing, deployment, signing, messaging, credentials, or network
+authority.
+
+## Release checklist
+
+1. Build and publish the matching package version to PyPI.
+2. Verify the published PyPI README contains exactly one
+   `<!-- mcp-name: io.github.zrk222/code-factory -->` marker.
+3. Validate `.mcp/server.json` against the current MCP Registry schema and
+   publisher CLI.
+4. Authenticate with GitHub in the publisher tool, then publish the manifest.
+5. Verify the registry search result has the expected name, version, PyPI
+   identifier, `uvx` runtime hint, and `stdio` transport.
+
+Do not run a manual registry publish from a laptop with a copied token. The
+publisher authentication belongs in a reviewed GitHub Actions environment with
+OIDC and a matching package release.
diff --git a/docs/VSCODE_MARKETPLACE.md b/docs/VSCODE_MARKETPLACE.md
new file mode 100644
index 0000000..7012a83
--- /dev/null
+++ b/docs/VSCODE_MARKETPLACE.md
@@ -0,0 +1,36 @@
+# VS Code Marketplace release lane
+
+This repository now has a guarded, evidence-first release lane for the
+FactoryLine VS Code extension. It deliberately separates building a verified
+candidate from publishing it.
+
+## Candidate validation
+
+Run the `Publish VS Code Marketplace extension` workflow with:
+
+- `release_ref`: an immutable tag such as `v0.28.0`;
+- `publish`: `false`.
+
+The workflow checks the tag-to-commit binding, installs the locked Node
+dependencies, runs the audit and extension tests, packages a VSIX, and uploads
+a SHA-256-sealed candidate artifact.
+
+## Protected publication
+
+To publish, configure a GitHub Actions environment named `vscode-marketplace`
+with a least-privilege `VSCE_PAT` secret, then dispatch the same workflow with
+`publish: true`. The environment review and token are intentionally not
+embedded in the repository or accepted from a developer laptop.
+
+The publisher identity in `editors/vscode/package.json` is `zrk222`; the
+Marketplace publisher must exist in the Visual Studio Marketplace publisher
+portal and the token must have only the extension-publishing scope. The VSIX
+is published only after the sealed candidate is re-hashed in the publish job.
+
+Official guidance: [Publishing Extensions](https://code.visualstudio.com/api/working-with-extensions/publishing-extension).
+
+## Current boundary
+
+Adding this lane does not claim a Marketplace listing. A live listing requires
+the protected `VSCE_PAT`, publisher account setup, and an approved action-time
+dispatch. Until those are present, the honest state is **candidate prepared**.
diff --git a/pyproject.toml b/pyproject.toml
index 4a2f808..20cbdaa 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -25,6 +25,10 @@ keywords = [
   "developer-tools",
   "mvp",
   "mcp",
+  "model-context-protocol",
+  "cursor",
+  "opencode",
+  "ai-coding-assistant",
   "graph-ops",
   "prd-grill",
   "independent-verification",
diff --git a/tests/test_huggingface_surface.py b/tests/test_huggingface_surface.py
index 36be699..6200ec1 100644
--- a/tests/test_huggingface_surface.py
+++ b/tests/test_huggingface_surface.py
@@ -35,6 +35,12 @@ def test_huggingface_space_has_static_metadata_and_canonical_release_links() ->
     assert "developer-tools" in readme
     assert "ai-agents" in readme
     assert "devops" in readme
+    assert "model-context-protocol" in readme
+    assert "cursor" in readme
+    assert "opencode" in readme
+    assert "Cursor or OpenCode" in readme
+    assert "Observed Marketplace downloads: 46" not in page
+    assert "Unique installs: not exposed by the listing" in page
     assert 'id="first-run"' in page
     assert "Start free with pip" in page
     assert "Watch the exact 60-second UI" in page
@@ -51,6 +57,18 @@ def test_huggingface_space_has_static_metadata_and_canonical_release_links() ->
     assert "prefers-reduced-motion" in page
     assert "Skip to product proof" in page
     assert 'class="brand" href="#main"' in page
+    assert 'id="proof-playground"' in page
+    assert "Bake a proof preview" in page
+    assert "deterministic browser animation only" in page
+    assert 'id="receipt-result"' in page
+    assert "Local proof reference copied." in page
+    assert 'id="recipes"' in page
+    assert "Repository readiness" in page
+    assert "Independent verifier" in page
+    assert 'id="mcp-recipes"' in page
+    assert "factory mcp serve --root ." in page
+    assert "data-copy" in page
+    assert "prefers-reduced-motion" in page
 
 
 def test_huggingface_workflow_uses_secret_and_scoped_source_directory() -> None:
@@ -73,12 +91,12 @@ def test_huggingface_metadata_inspection_rejects_the_remote_api_limit_locally(tm
     valid_result = inspect(SPACE / "README.md")
     assert valid_result["ok"] is True
     assert valid_result["marker"] == "HUGGINGFACE_SPACE_METADATA_VALID"
-    assert valid_result["short_description_length"] == 58
+    assert valid_result["short_description_length"] == 55
 
     invalid_readme = tmp_path / "README.md"
     invalid_readme.write_text(
         (SPACE / "README.md").read_text(encoding="utf-8").replace(
-            "short_description: Reviewable MVPs with verifier, repair, and workspace proof",
+            "short_description: Proof-backed AI coding workflows with local MCP context",
             f"short_description: {'x' * 61}",
         ),
         encoding="utf-8",
@@ -103,7 +121,7 @@ def test_huggingface_metadata_preflight_cli_reports_the_local_result(tmp_path: P
     invalid_readme = tmp_path / "invalid-README.md"
     invalid_readme.write_text(
         (SPACE / "README.md").read_text(encoding="utf-8").replace(
-            "short_description: Reviewable MVPs with verifier, repair, and workspace proof",
+            "short_description: Proof-backed AI coding workflows with local MCP context",
             f"short_description: {'x' * 61}",
         ),
         encoding="utf-8",
diff --git a/tests/test_marketplace_workflows.py b/tests/test_marketplace_workflows.py
new file mode 100644
index 0000000..34190ff
--- /dev/null
+++ b/tests/test_marketplace_workflows.py
@@ -0,0 +1,40 @@
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_vscode_marketplace_workflow_is_guarded_and_seals_candidate():
+    workflow = (ROOT / ".github" / "workflows" / "vscode-marketplace.yml").read_text(encoding="utf-8")
+
+    assert "name: Publish VS Code Marketplace extension" in workflow
+    assert "release_ref:" in workflow
+    assert "publish:" in workflow
+    assert "environment: vscode-marketplace" in workflow
+    assert "VSCE_PAT: ${{ secrets.VSCE_PAT }}" in workflow
+    assert "npm ci" in workflow
+    assert "npm run audit" in workflow
+    assert "npm test" in workflow
+    assert "sha256sum factoryline-vscode.vsix" in workflow
+    assert "sha256sum --check SHA256SUMS.txt" in workflow
+    assert "--packagePath vscode-marketplace-candidate/factoryline-vscode.vsix" in workflow
+
+
+def test_vscode_marketplace_docs_keep_publication_boundary_explicit():
+    docs = (ROOT / "docs" / "VSCODE_MARKETPLACE.md").read_text(encoding="utf-8")
+
+    assert "candidate prepared" in docs
+    assert "VSCE_PAT" in docs
+    assert "code.visualstudio.com/api/working-with-extensions/publishing-extension" in docs
+
+
+def test_github_marketplace_action_is_rooted_and_fail_closed():
+    action = (ROOT / "action.yml").read_text(encoding="utf-8")
+    docs = (ROOT / "docs" / "GITHUB_MARKETPLACE_ACTION.md").read_text(encoding="utf-8")
+
+    assert "using: composite" in action
+    assert "factory verify \"$FACTORY_FEATURE\" --root \"$FACTORY_ROOT\" --json" in action
+    assert "actions/upload-artifact@v4" in action
+    assert "FACTORY_VERIFY_EXIT" in action
+    assert "if: always()" in action
+    assert "github.com/en/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace" in docs
diff --git a/tests/test_mcp_registry.py b/tests/test_mcp_registry.py
new file mode 100644
index 0000000..9513f81
--- /dev/null
+++ b/tests/test_mcp_registry.py
@@ -0,0 +1,27 @@
+import json
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_mcp_registry_manifest_is_pypi_stdio_and_matches_release() -> None:
+    manifest = json.loads((ROOT / ".mcp" / "server.json").read_text(encoding="utf-8"))
+    project = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    assert manifest["name"] == "io.github.zrk222/code-factory"
+    assert manifest["version"] == "0.28.0"
+    assert 'version = "0.28.0"' in project
+    package = manifest["packages"][0]
+    assert package["registryType"] == "pypi"
+    assert package["identifier"] == "factoryline-code-factory"
+    assert package["version"] == manifest["version"]
+    assert package["runtimeHint"] == "uvx"
+    assert package["transport"] == {"type": "stdio"}
+    assert [argument["value"] for argument in package["runtimeArguments"]] == ["factory"]
+    assert [argument["value"] for argument in package["packageArguments"]] == ["mcp", "serve"]
+
+
+def test_mcp_registry_ownership_marker_is_exactly_once() -> None:
+    readme = (ROOT / "README.md").read_text(encoding="utf-8")
+    marker = "<!-- mcp-name: io.github.zrk222/code-factory -->"
+    assert readme.count(marker) == 1
diff --git a/tests/test_publication_metadata.py b/tests/test_publication_metadata.py
index 2a03019..364f2ea 100644
--- a/tests/test_publication_metadata.py
+++ b/tests/test_publication_metadata.py
@@ -44,7 +44,16 @@ def test_pypi_storefront_has_identity_and_canonical_links():
     assert project["description"] == (
         "Create reviewable MVPs with independent verification, proof review, repair guardrails, and workspace guidance."
     )
-    assert {"mvp", "mcp", "graph-ops", "prd-grill", "verifier-plane"}.issubset(project["keywords"])
+    assert {
+        "mvp",
+        "mcp",
+        "model-context-protocol",
+        "cursor",
+        "opencode",
+        "graph-ops",
+        "prd-grill",
+        "verifier-plane",
+    }.issubset(project["keywords"])
 
 
 def test_python_wheel_data_is_explicit_and_does_not_depend_on_package_discovery():
@@ -66,6 +75,9 @@ def test_public_ctas_are_outcome_led_and_preserve_proof_boundaries():
     assert readme.index(value) < readme.index("## What Code Factory is")
     assert "factory mvp \"Build an approval tracker\" --root ." in readme
     assert "Watch the exact shipped UI in 60 seconds" in readme
+    assert "live Hugging Face Space" in readme
+    assert "Cursor or OpenCode MCP" in readme
+    assert "deterministic proof" in readme
     assert "star Code Factory" in readme
     assert "production-ready before the relevant proof exists" in readme
     assert "reviewable MVP starting state in minutes" in vscode_package["description"]
diff --git a/tests/test_release_integrity.py b/tests/test_release_integrity.py
index dd68008..eb4ffdf 100644
--- a/tests/test_release_integrity.py
+++ b/tests/test_release_integrity.py
@@ -128,7 +128,7 @@ def test_release_integrity_rejects_huggingface_metadata_that_would_fail_remotely
     readme = root / "deploy" / "huggingface" / "README.md"
     readme.write_text(
         readme.read_text(encoding="utf-8").replace(
-                "short_description: Reviewable MVPs with verifier, repair, and workspace proof",
+                "short_description: Proof-backed AI coding workflows with local MCP context",
             f"short_description: {'x' * 61}",
         ),
         encoding="utf-8",