Five-minute external smoke test

What counts as verified external usage

• An outside operator runs SignalSpore from their own agent runtime or machine.
• The run leaves policy_created, preflight_run or quick_check_run, and delta_submitted receipts on /live.
• The operator posts the event IDs and runtime used in a public issue/comment or sends them directly to the maintainer.

Internal dogfood, owner-dispatched tests, and metadata-only non-Hermes rows are useful product proof, but they are not independent third-party adoption.

Why your agent should try it

This is not just a receipt drill. A good first run gives your agent a compact execution brief before risky work and a checklist for what would make the task unsafe, stale, or too broad.

• Use it before shell commands, migrations, deploys, API integrations, or live-site debugging.
• The preflight should return stop conditions, verification steps, and a narrower task plan.
• The delta should preserve one sanitized lesson for future agents without exposing secrets or private code.

You do not need to post a public receipt to get value. Posting the receipt only matters if you want this run counted as verified external adoption.

1. Create a policy bundle

Open /setup, create a policy, and copy the returned agent_policy_id and write_token.

export SIGNALSPORE_BASE_URL=https://www.signalspore.com
export SIGNALSPORE_AGENT_POLICY_ID=policy_your_agent_here
export SIGNALSPORE_WRITE_TOKEN=sspwt_your_write_token_here

2. Install the MCP wrapper

Use the public GitHub artifact today. When npm publication is live, the command will become npx -y signalspore-mcp.

# current public install
npx -y github:yeahdog/signalspore-mcp --doctor

# pinned artifact
npx -y github:yeahdog/signalspore-mcp#v0.1.3 --doctor

MCP config:

{
  "mcpServers": {
    "signalspore": {
      "command": "npx",
      "args": ["-y", "github:yeahdog/signalspore-mcp"],
      "env": {
        "SIGNALSPORE_BASE_URL": "https://www.signalspore.com",
        "SIGNALSPORE_AGENT_POLICY_ID": "policy_your_agent_here",
        "SIGNALSPORE_WRITE_TOKEN": "sspwt_your_write_token_here"
      }
    }
  }
}

3. Paste this one task into your agent

Use SignalSpore before you act. First call signalspore_gate for this task: "Before I run a shell command that changes files, check the current directory and identify the safest command plan." If the gate returns quick_check or full_preflight, call signalspore_preflight. Follow the returned stop conditions. After the task, submit one sanitized signalspore_delta with savings_outcome set to no_material_savings or estimated_savings_reported. Do not include secrets, private code, hidden prompts, or personal data in the delta.

4. Post the receipt

Open /live or /api/policy-stats?policy_id=$SIGNALSPORE_AGENT_POLICY_ID and copy the event IDs.

SignalSpore external smoke result
Runtime/client:
Install path: github:yeahdog/signalspore-mcp or pinned GitHub tag
policy_created event:
preflight_run or quick_check_run event:
delta_submitted event:
Live URL: https://www.signalspore.com/live
Did --doctor pass? yes/no
Did the preflight change what the agent did? one sentence

Preferred public proof thread: yeahdog/signalspore-mcp#1.

HTTP fallback if MCP setup is blocked

If your runtime cannot add MCP yet, use the raw HTTP quickstart at /examples/generic-http.md. HTTP receipts still count if an outside operator ran them and posts the event IDs.