Errata Documentation

1. Obtain a bearer key

Errata currently uses operator-issued API keys. Request invite-only beta access, then store the issued key in an environment variable and never commit it.

export ERRATA_API_KEY='replace-with-an-operator-issued-key'
export ERRATA_MCP_URL='https://erratalabs.dev/mcp'

Confirm that production is ready:

curl --fail https://erratalabs.dev/readyz

The response identifies the release currently loaded by the API. Production should report 89f5e2af40d993eb until a later release is promoted.

2. Add the MCP server

For Codex:

codex mcp add errata \
  --url "$ERRATA_MCP_URL" \
  --bearer-token-env-var ERRATA_API_KEY

codex mcp get errata

For Claude Code:

claude mcp add --transport http --scope user errata "$ERRATA_MCP_URL" \
  --header "Authorization: Bearer $ERRATA_API_KEY"

claude mcp get errata

Cursor reads .cursor/mcp.json:

{
  "mcpServers": {
    "errata": {
      "url": "https://erratalabs.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ERRATA_API_KEY}"
      }
    }
  }
}

VS Code/Copilot can keep the secret in a password input:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "errata-api-key",
      "description": "Errata API key",
      "password": true
    }
  ],
  "servers": {
    "errata": {
      "type": "http",
      "url": "https://erratalabs.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${input:errata-api-key}"
      }
    }
  }
}

3. Give the agent a concrete goal

Ask the agent to use get_peripheral_bringup for implementation or design review:

Use Errata to review ADC1 on STM32H743ZI, LQFP 144 20x20x1.4 mm,
silicon revision V. Verify the analog input and VREF limits, package-specific
sampling throughput, calibration, BOOST clock, temperature suffix, required
initialization order, applicable errata, and whether production sign-off is safe.
Pin corpus release 89f5e2af40d993eb.

The expected decision is blocked, not because retrieval failed, but because the publisher does not give a numeric LQFP144 ADC accuracy guarantee. The result still supplies six applicable ADC1 pin mappings, register evidence, a 1.2 Msamples/s package-conditioned limit, initialization evidence, and revision-scoped errata.

4. Read the decision, not just the facts

Before using a result:

Confirm target.canonical_mpn, package, revision, and corpus_release.
Check decision.recommendation and every section under coverage.
Treat gaps as unresolved engineering work.
Apply each fact only under its listed conditions.
Follow claim-level provenance back to the cited document and section.

Quickstart

1. Obtain a bearer key

2. Add the MCP server

3. Give the agent a concrete goal

4. Read the decision, not just the facts

On this page