MCP server
Ratchetgate Ratchet Official
com.ratchetgate/ratchet
Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools
Your agent asks before it acts, so the same real-world action is attempted at most once.
Working at last checkVerified publisher: ratchetgate.comAbout 4,705 tokens per request once connected15 toolsDescription tries to instruct AI agents
https://ratchetgate.com/mcp
At a glance
- Type
- MCP server
- Publisher
- ratchetgate.com (verified by the MCP Registry)
- Status
- Working at last check
- Tools
- 15
- Token cost
- About 4,705 tokens per request
- Sets up in
- Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
- Last checked
- 26 Oct 2026, 08:29 UTC
Connect it to your agent
Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.
Claude Code
claude mcp add --transport http ratchet https://ratchetgate.com/mcp
Claude Desktop
Settings → Connectors → Add custom connector, and paste the URL.
Codex (config.toml)
[mcp_servers.ratchet] url = "https://ratchetgate.com/mcp"
Gemini CLI
{"mcpServers":{"ratchet":{"httpUrl":"https://ratchetgate.com/mcp"}}}
Cursor
{"mcpServers":{"ratchet":{"url":"https://ratchetgate.com/mcp"}}}
VS Code
{"servers":{"ratchet":{"type":"http","url":"https://ratchetgate.com/mcp"}}}
Antigravity
agy mcp add ratchet https://ratchetgate.com/mcp
ChatGPT
Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.
OpenAI API (Responses tools)
{"type":"mcp","server_label":"ratchet","server_url":"https://ratchetgate.com/mcp","require_approval":"always"}
Grok (xAI API tools)
{"type":"mcp","server_label":"ratchet","server_url":"https://ratchetgate.com/mcp"}
Tools
ratchet_begin_effect~1578 tokens
Call this IMMEDIATELY BEFORE performing any side effect that touches the outside world (sending a message, charging a card, creating a resource, writing to someone else's system). Returns a decision you MUST obey. If the response carries budget_warning, a spend ceiling exists but nothing was countedratchet_extend_lease~286 tokens
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 it when work turns out to take longer than the lease you asked for — a slow vendor, a large export, a retrying upload. Without it, the leaseratchet_get_circuit~291 tokens
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 performed far more often than its configured hourly ceiling — usually because something is looping. What to do with the answer: - If a breaker is oratchet_get_effectChanges accounts · ~212 tokens
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 example when resuming after a crash, or when a user asks whether something went through. To actually perform work, use ratchet_begin_effect insratchet_get_group~122 tokens
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 unknown outcome. Use it to answer "where did this workflow actually get to?" after a crash, without changing anything.ratchet_get_policy~192 tokens
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 threshold above which an action waits for a human, and — most importantly — what happens when an attempt ends indeterminate. Check this before dratchet_get_prevented_loss~142 tokens
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-reports rather than flatters. IMPORTANT: pass estimated_cost_micros on ratchet_begin_effect or this reads zero — the number is only as good asratchet_get_run~237 tokens
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 when your context has been compacted and you are no longer certain what you did. It returns what succeeded with the recorded results, what iratchet_get_usage~93 tokens
Returns the current plan, remaining included effects for the month, prepaid credit balance, and today's declared external spend against each budget ceiling. Use it to warn a user before a long run exhausts an allowance or a budget.ratchet_list_effects~213 tokens
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 action whose outcome is unknown and still needs verification.ratchet_list_receipts~167 tokens
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 against the Ed25519 key published at /.well-known/ratchet-receipt-key — you do not have to trust this server to check them. Use this when a humaratchet_reconcile_effects~186 tokens
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 code paths that acted WITHOUT asking, so a retry there can act twice — a bug the operator almost certainly does not know about. Send refereratchet_report_effect~393 tokens
Call this IMMEDIATELY AFTER performing an action that ratchet_begin_effect authorised. Pass the lease_token you were given. Report "succeeded" with a result — future duplicate callers replay that result instead of repeating the action. Report "failed" ONLY when you are certain the action did NOT rearatchet_resolve_effect~224 tokens
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 action did occur, "failed" if it did not, or "cancelled" to abandon it. Include how you verified it in `evidence`. Never guess: resolving incratchet_unwind_group~369 tokens
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 not configured. Returns the exact compensations to perform, in the order to perform them, which is the REVERSE of the order they succeeded
Browse
Related MCP servers
- Raven
Design intelligence for coding agents: audits, design systems, and a taste profile agents consult. - Gardenpatch
Paid per call over x402: growth coaches, small utilities and real-world actions. USDC on Base. - Hook Detector
Real TikTok and Instagram hooks that already work, in any language, with why each travelled. - 1F3D9 City Life for AI Agents
A persistent AI world where agents walk, build, own things, talk, and make agreements. - Compass by 402rates
Free agent tests (no account or payment); paid ping. - Glimind
Live reliability for AI agent tools: is it working right now, and how do I call it correctly? - AgentWorld — Live AI Agent Economy
Live AI agent economy on Base L2: agents, credit files, games, jobs, crypto news, x402 USDC tools. - Realmint
Agent-native scoring, search and routing for tokenized real-world assets across multi-chain.
Badge for your README
[](https://aptlynx.net/servers/com.ratchetgate/ratchet)
Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents