com.ratchetgate/ratchet

up checked 2026-11-10T23:37:37.772Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

Your agent asks before it acts, so the same real-world action is attempted at most once.

Summary by lookupd

Gates agent side effects so each real-world action runs at most once, with leases, receipts, spend limits and reconciliation of outcomes.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http ratchet https://ratchetgate.com/mcp

Claude Code, npm package (stdio)

claude mcp add ratchet -- npx -y ratchet-mcp

Codex, remote (streamable-http)

codex mcp add ratchet --url https://ratchetgate.com/mcp

Codex, npm package (stdio)

codex mcp add ratchet -- npx -y ratchet-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "ratchet": {
      "url": "https://ratchetgate.com/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "ratchet": {
      "command": "npx",
      "args": [
        "-y",
        "ratchet-mcp"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (15 tools)

Publisher-provided text

• ratchet_get_circuit Call this when a begin returned "approval_required" or "denied" and the reason mentions a circuit breaker. A breaker opens when an effect type is being performe
• ratchet_begin_effect Call this IMMEDIATELY BEFORE performing any side effect that touches the outside world (sending a message, charging a card, creating a resource, writing to some
• ratchet_report_effect Call this IMMEDIATELY AFTER performing an action that ratchet_begin_effect authorised. Pass the lease_token you were given. Report "succeeded" with a result — f
• ratchet_extend_lease Call this periodically during a long action you were authorised to perform, before the lease expires. It tells Ratchet you are alive and extends your hold. Use
• ratchet_get_effect Look up the recorded state of an action WITHOUT reserving a lease and without consuming your plan allowance. Use it to answer "did I already do this?" — for exa
• ratchet_resolve_effect Use ONLY after you have checked the third-party system and now know what really happened to an effect that was left "indeterminate". Record "succeeded" if the a
• ratchet_get_run Recall the work already gated under a run id, before doing anything that might repeat it. Call this FIRST when resuming a task — after a restart, a handoff, or
• ratchet_list_effects Review recent effects for this workspace, optionally filtered by state or run. Use it to find unresolved work — filter by state "indeterminate" to see every act
• ratchet_get_policy Shows how this workspace has configured a given effect type: whether it is allowed, how long a lease lasts, the attempt ceiling, spend limits, the approval thre
• ratchet_unwind_group Call this when a multi-step workflow fails partway and the steps that already succeeded must be undone — a booking made but not paid for, a resource created but
• ratchet_get_group Shows every step in a multi-step unit of work: what succeeded, what can still be undone, what has already been undone, what is irreversible, and what has an unk
• ratchet_get_usage Returns the current plan, remaining included effects for the month, prepaid credit balance, and today's declared external spend against each budget ceiling. Use
• ratchet_list_receipts Returns a signed receipt for every decision made about one effect, refusals included. Each signature is over the exact bytes in `body` and verifies offline agai
• ratchet_reconcile_effects Given the idempotency keys for actions a vendor says actually happened, returns which ones went through Ratchet and which it has never seen. The unseen ones are
• ratchet_get_prevented_loss Counts duplicate actions refused in the last 30 days and what they would have cost. Only counts refusals where a cost was declared on the effect, so it under-re

Details

• Version: 0.3.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 696 ms
• First indexed: 2026-11-01T08:57:15.418Z
• Last seen in registry: 2026-11-01T08:57:15.558Z
• Repository: https://github.com/thearchitect0x-glitch/ratchet
• Website: https://ratchetgate.com

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/com.ratchetgate/ratchet.svg)](https://lookupd.com/servers/com.ratchetgate/ratchet)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp