← Proof Studio

Local MCP · Qualitative proof

The starter kit runs locally

A buyer wants to know whether the starter kit can be inspected without waiting for a hosted account.

demo ready to inspect public sanitized 3 evidence rows 8 evidence values

evidence terminal

Local MCP terminal proof

Rendered evidence
This is the buyer-visible local path: run the server, list tools, call health, search, context read, proof index, lint, and diagnostics.

HERMES case-study frame

Read the case before the evidence room.

A reviewer should be able to answer seven things before opening the JSON export: what decision is in front of them, what changed against a cold start, which row carries the claim, where the value appears, what source trail exists, what purchase decision it informs, and what the case does not prove.

  1. 01 · Buyer question

    What is being decided?

    A buyer wants to know whether the starter kit can be inspected without waiting for a hosted account.

  2. 02 · Cold start

    Hosted-only promise

    The buyer must trust a roadmap claim before they can inspect how project context becomes available to tools.

  3. 03 · KBPD-backed

    Local server in the kit

    The extracted archive can answer health, search, context read, proof index, lint, and diagnostics calls from local files.

  4. 04 · Boundary

    Qualitative proof

    Hosted identity, payment operations, service visibility, and plan changes belong to the Phase 2 hosted service.

Best public row hosted-account-not-required Publicly inspectable

Proof row

Hosted account is not required for local inspection

The local inspection path reads extracted starter-kit files and does not require hosted authentication.

Supports the first-dollar starter-kit claim that buyers can inspect locally before the hosted service ships.
Evidence value
Local tools: 6 Health, search, context read, proof index, lint, and diagnostics are exposed through the local server.
Source trail
Local MCP README starter-kit docs · Public projection
Buyer decision
See the starter kit The launch offer is not blocked on hosted infrastructure. The local MCP proves the starter kit can be inspected from the same archive a buyer receives.
Limit
Qualitative proof Hosted identity, payment operations, service visibility, and plan changes belong to the Phase 2 hosted service.

Evidence room

Inspect the evidence, values, and limits.

This is the public review surface for the case. Each row names the observation, the evidence values it stands on, the source trail, the boundary, and the matching structured entry in the evidence export.

Evidence JSON
Review order Question -> evidence -> value -> source -> limit Start with the case question, then inspect what the claim is allowed to stand on.
Evidence export /proof/local-mcp-starter-kit/evidence.json The same evidence rows are emitted as JSON for independent review.
Claim boundary Qualitative proof The page cannot claim more than this status supports.
Source availability

A source trail is not always a raw public artifact. Public projection means the source has been redrawn or summarized; retained source means it is named for audit but withheld until redaction clears.

Public projection
4
Retained source
0
Pending run
0

Public evidence excerpts

Readable snippets tied to evidence rows

These excerpts are the public bridge between retained raw sources and the evidence table below. Each one says what was preserved, what was redacted, and which evidence rows it supports.

  1. Public excerpt local-tool-contract-excerpt

    Local tool contract excerpt

    The local contract exposes six tools: health, search, context read, proof index, lint, and diagnostics.
    Source label
    Starter-kit local MCP smoke
    Redaction note
    The excerpt names only public tool behavior; no local filesystem path, credential, or package URL is included.
  2. Public excerpt offline-first-boundary-excerpt

    Offline-first boundary excerpt

    Local inspection reads the extracted starter-kit files and does not require a hosted account.
    Source label
    Starter-kit MCP README
    Redaction note
    The excerpt is limited to the local starter-kit boundary; hosted identity and payment operations remain a later service.
    Supports evidence rows

    hosted-account-not-required

Evidence rows
3
Reviewed public observations
Evidence values
8
Metric and run values exposed for review
Source trail
4
Artifacts named for review
Claim status
Qualitative proof
Claim boundary for publication

Claim under review

The starter kit includes an offline-first MCP server with health, search, context read, proof index, lint, and diagnostics tools.

The launch offer is not blocked on hosted infrastructure. The local MCP proves the starter kit can be inspected from the same archive a buyer receives.

01 Six local MCP tools are declared Validated by build evidence_facts[0]
Observed
The starter kit local MCP contract exposes health, search, context read, proof index, lint, and diagnostics tools.
Evidence
Metric row lists six local tools; source artifacts name the local MCP README, local server, smoke command, and manifest.
Supports
Supports the claim that the starter kit has a real local inspection surface.
Evidence id six-local-tools-declared Review URL #fact-six-local-tools-declared
02 Hosted account is not required for local inspection Publicly inspectable evidence_facts[1]
Observed
The local inspection path reads extracted starter-kit files and does not require hosted authentication.
Evidence
Metric row reports zero hosted dependency; limitations distinguish local server behavior from the later hosted service.
Supports
Supports the first-dollar starter-kit claim that buyers can inspect locally before the hosted service ships.
Evidence id hosted-account-not-required Review URL #fact-hosted-account-not-required
03 Two smoke paths cover the local server Validated by build evidence_facts[2]
Observed
The proof case records two smoke paths: extracted-package Node smoke and Docker image smoke.
Evidence
Metric row names two smoke paths and run metadata names one assembled package plus one Docker MCP image.
Supports
Supports the claim that the local MCP surface has startup and representative-call coverage.
Evidence id two-smoke-paths-covered Review URL #fact-two-smoke-paths-covered

Evidence values

The values this proof is allowed to stand on

Field Value Meaning
Local tools Value handle: data-01-local-tools 6 Health, search, context read, proof index, lint, and diagnostics are exposed through the local server.
Hosted dependency Value handle: data-02-hosted-dependency 0 The local inspection path reads extracted kit files without a hosted account.
Smoke path Value handle: data-03-smoke-path 2 Extracted-archive Node smoke and Docker image smoke cover startup plus representative tool calls.
Run date Value handle: data-04-run-date Launch build Date label attached to this public proof case.
Sample Value handle: data-05-sample One assembled archive and one Docker MCP image Sample size or unit under review.
Provenance Value handle: data-06-provenance Starter-kit MCP README, manifest, local server source, archive assembler, and smoke command Where the public projection says the evidence came from.
Reproducibility Value handle: data-07-reproducibility Build the starter-kit archive, extract it, run node mcp/smoke.mjs, or run the Docker MCP image smoke. What a reviewer can repeat or inspect publicly.
Claim status Value handle: data-08-claim-status qualitative proof The maximum strength of the public claim.

Source trail

Where the public proof can point

  • source-01-local-mcp-readme Local MCP README starter-kit docs · public projection
  • source-02-mcp-manifest MCP manifest machine-readable contract · public projection
  • source-03-local-server Local server starter-kit runtime · public projection
  • source-04-smoke-command Smoke command verification script · public projection

Evidence status mix

What kind of support is each row?

Validated by build
2
Publicly inspectable
1

Metrics

Signals carried by the case

  • 6 Local tools Health, search, context read, proof index, lint, and diagnostics are exposed through the local server.
  • 0 Hosted dependency The local inspection path reads extracted kit files without a hosted account.
  • 2 Smoke path Extracted-archive Node smoke and Docker image smoke cover startup plus representative tool calls.

Source artifacts

Where the evidence comes from

  • Local MCP README starter-kit docs · public projection
  • MCP manifest machine-readable contract · public projection
  • Local server starter-kit runtime · public projection
  • Smoke command verification script · public projection

Case quality review

This case has a cold-review quality score.

This is a cold-review rubric, not a sales claim. It checks whether the case can be understood, inspected, bounded, and acted on.

Overall 5.0 Launch-readable

Cold-audience clarity

5.0

A reviewer gets the situation, contrast, and buyer decision without reading the JSON.

Evidence visibility

5.0

The case exposes proof rows, values, source handles, and excerpts before the JSON export.

Limitation clarity

5.0

The page names what the case proves and what it does not prove.

Visual hierarchy

5.0

The route uses visuals, storyboards, or surface frames to break the proof into inspectable layers.

Purchase motivation

5.0

The proof sends the buyer to an evidence room, artifact link, pricing path, or local run.

Next depth gate

Cold-audience clarity: Tighten the opening latch or before/after language when the case still needs explanation.

Open case evidence

Evidence docket

Review the evidence rows behind the case.

Evidence JSON
Evidence rows
3
Validated by build
2
Publicly inspectable
1
  1. 01 Validated by build

    Six local MCP tools are declared

    Observed
    The starter kit local MCP contract exposes health, search, context read, proof index, lint, and diagnostics tools.
    Evidence
    Metric row lists six local tools; source artifacts name the local MCP README, local server, smoke command, and manifest.
    Supports
    Supports the claim that the starter kit has a real local inspection surface.
  2. 02 Publicly inspectable

    Hosted account is not required for local inspection

    Observed
    The local inspection path reads extracted starter-kit files and does not require hosted authentication.
    Evidence
    Metric row reports zero hosted dependency; limitations distinguish local server behavior from the later hosted service.
    Supports
    Supports the first-dollar starter-kit claim that buyers can inspect locally before the hosted service ships.
  3. 03 Validated by build

    Two smoke paths cover the local server

    Observed
    The proof case records two smoke paths: extracted-package Node smoke and Docker image smoke.
    Evidence
    Metric row names two smoke paths and run metadata names one assembled package plus one Docker MCP image.
    Supports
    Supports the claim that the local MCP surface has startup and representative-call coverage.

Evidence Flow

Read the proof as a chain, not a claim.

Each case has to survive the same path: starting condition, system-backed change, visible result, retained evidence, stated limitation, and a next action.

Local tools 6
Hosted dependency 0
Smoke path 2

Local MCP runbook

Run it before believing it.

This is the purchase proof path for the starter kit: inspect the archive, run the local MCP smoke, read the bundled proof index, and see exactly where the hosted service begins later.

Command path

Four commands take a buyer from files to proof.

  1. 01
    Install the scaffold cd scaffold && pnpm install
  2. 02
    Run the local site pnpm dev
  3. 03
    Verify the kit root node mcp/local-server.mjs --self-test
  4. 04
    Exercise the MCP tools node mcp/smoke.mjs

Tool surface

The local server exposes 6 read-only tools.

kbpd.health local:health

Check whether the extracted starter-kit paths are readable.

kbpd.search context:search

Search local scaffold, instance, and kit text files.

kbpd.read_context context:read

Read a relative text file from the extracted starter kit.

kbpd.proof_index proof:read

Read the bundled public Proof Studio evidence index.

kbpd.lint kit:lint

Scan public outputs and kit text for private paths, ticket keys, and forbidden vocabulary.

kbpd.diagnostics kit:diagnose

Summarize local MCP configuration and available tools.

Client config

Pasteable local config, no hosted credential.

{
  "mcpServers": {
    "kbpd-local": {
      "command": "node",
      "args": ["/absolute/path/to/kbpd-starter-kit/mcp/local-server.mjs"],
      "env": {
        "KBPD_KIT_ROOT": "/absolute/path/to/kbpd-starter-kit"
      }
    }
  }
}

Privacy boundary

What the local server is allowed to touch.

Network access
none
Writes to kit
no
Reads outside kit root
no
Hosted credential required
no
Completeness

Self-test checks the extracted archive.

The local server exits non-zero if the kit root, scaffold, instance, guide, MCP directory, local server, or smoke script is missing.

Tool contract

6 read-only tools are declared.

The manifest and smoke path agree on the exposed local tools, including proof-index access for reviewable evidence.

Boundary

No hosted account or network call.

The local server reads inside the extracted kit root and does not require a subscription entitlement.

Future gate

Hosted service remains planned-not-live.

The starter kit includes the hosted-service checklist for review, but sale waits for 9 customer-control gates.

Hosted contract

Phase 2 is reviewable, not live.

The kit includes mcp/hosted-control-plane.contract.json so a technical buyer can inspect the planned hosted-service checklist before treating it as a current entitlement.

  • authentication
  • customer identity
  • entitlement checks
  • scoped access tokens
  • token revocation
  • usage metering
  • customer-visible usage history
  • telemetry
  • support and abuse trail
Review starter-kit contents Open evidence JSON See hosted boundary

Claude Desktop

Claude Desktop local install path

The local Claude Desktop Extension package is source-built around the same read-only MCP server. It points Claude at the extracted starter kit; it is not hosted Claude access.

Already proven

Source package and server smoke exist.

  • .mcpb package builds from source without manual edits.
  • Bundle manifest declares six read-only tools and a required directory picker.
  • Bundled server self-test passes against a freshly assembled starter-kit archive.

Remaining gate

One human Claude Desktop smoke before stronger offer copy.

  • Human Claude Desktop install/import smoke.
  • Claude Desktop tool list shows all six local tools.
  • kbpd.health and kbpd.proof_index succeed from Claude Desktop against a fresh kit.

Not included yet

Hosted Claude remains Phase 2.

  • Hosted Claude custom connector.
  • Claude access tokens.
  • Team scopes, usage dashboard, or remote revocation.

Claim

The starter kit includes an offline-first MCP server with health, search, context read, proof index, lint, and diagnostics tools.

The launch offer is not blocked on hosted infrastructure. The local MCP proves the starter kit can be inspected from the same archive a buyer receives.

Before / after

Same use case. Different starting conditions.

Before · account-gated access

Hosted-only promise

The buyer must trust a roadmap claim before they can inspect how project context becomes available to tools.

Wait for hosted access, then decide whether the local artifact has enough context to evaluate.

After · offline-first MCP surface

Local server in the kit

The extracted archive can answer health, search, context read, proof index, lint, and diagnostics calls from local files.

Run the local server from the extracted archive or the Docker image and inspect the tools before hosted auth exists.

Evidence

What this case actually carries.

Run metadata

Metrics

  • 6 Local tools Health, search, context read, proof index, lint, and diagnostics are exposed through the local server.
  • 0 Hosted dependency The local inspection path reads extracted kit files without a hosted account.
  • 2 Smoke path Extracted-archive Node smoke and Docker image smoke cover startup plus representative tool calls.

Source artifacts

  • Local MCP README starter-kit docs · public projection
  • MCP manifest machine-readable contract · public projection
  • Local server starter-kit runtime · public projection
  • Smoke command verification script · public projection

Limitations

What this case does not prove.

Next

Follow this proof into the product.