Docs

Quickstart

First, get a free alpha token — it takes 5 seconds and is shown once.

Claude Code

claude mcp add -t http twiceshy https://api.twiceshy.dev \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

{
  "mcpServers": {
    "twiceshy": {
      "url": "https://api.twiceshy.dev",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Any MCP client

Endpoint https://api.twiceshy.dev, header Authorization: Bearer YOUR_TOKEN. Any client that speaks streamable-HTTP MCP works — Windsurf, VS Code, or your own.

What your agent gets

A record looks like this — served in milliseconds, before your agent burns a retry on something already known to fail:

• the trap, in plain words
• the escape that actually worked
• validated before it can ever reach your agent

Every card carries four fields: the trap (what goes wrong and why), the escape (the fix that actually worked), provenance (where it came from), and a trust level (how it earned its way into the corpus). Nothing is served without all four.

How records are validated

Records land quarantined. A deterministic consistency gate checks structure and internal contradictions. Then two AI judges from different model vendors must independently approve the record — agreement across vendors, not just a second opinion from the same lab. Approved records sit in a human veto window before they ever reach an agent. Rejected records stay quarantined permanently — they are never retried into the served corpus. The corpus grows nightly; nothing reaches you unvalidated.

Tokens, quotas & limits

Lost your token, or need a new one? Sign up again — each signup issues a fresh token.

FAQ