ratchet-mcp 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -2
- package/bin/ratchet-mcp.mjs +2 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# ratchet-mcp
|
|
2
2
|
|
|
3
|
+
[](https://www.bestpractices.dev/projects/14440)
|
|
4
|
+
[](https://scorecard.dev/viewer/?uri=github.com/thearchitect0x-glitch/ratchet)
|
|
5
|
+
[](https://github.com/thearchitect0x-glitch/ratchet/actions/workflows/ci.yml)
|
|
6
|
+
[](https://github.com/thearchitect0x-glitch/ratchet/blob/main/LICENSE)
|
|
7
|
+
|
|
3
8
|
MCP server for [Ratchet](https://ratchetgate.com) — an effect gate for AI agents.
|
|
4
9
|
|
|
5
10
|
Agents retry. LLM control flow is non-deterministic, network calls fail ambiguously, and processes
|
|
@@ -26,17 +31,22 @@ Put the key in `env`, never in `args` — arguments are visible in process listi
|
|
|
26
31
|
|
|
27
32
|
Works with Claude Desktop, Claude Code, Cursor, and any MCP client that spawns a stdio server.
|
|
28
33
|
|
|
34
|
+
**Runs on macOS, Linux, Windows and BSD** — anywhere Node 18+ runs. The bridge is a single
|
|
35
|
+
dependency-free file with no native modules, no shell-outs and no platform-specific paths, so there
|
|
36
|
+
is nothing to compile and nothing that behaves differently between operating systems. Ratchet
|
|
37
|
+
itself is a hosted service, so the gate is never something you install or operate.
|
|
38
|
+
|
|
29
39
|
## Tools
|
|
30
40
|
|
|
31
41
|
| Tool | What it does |
|
|
32
42
|
|---|---|
|
|
33
43
|
| `ratchet_begin_effect` | Ask permission before a side effect. Returns `execute`, `duplicate`, `in_flight`, `blocked`, `approval_required`, or `denied` |
|
|
34
44
|
| `ratchet_report_effect` | Report the outcome after acting |
|
|
35
|
-
| `
|
|
45
|
+
| `ratchet_get_effect` | Ask "did I already do this?" without reserving anything |
|
|
36
46
|
| `ratchet_resolve_effect` | Settle an effect whose outcome was unknown, after verifying |
|
|
37
47
|
| `ratchet_list_effects` | Review recent effects; filter by `indeterminate` to find unresolved work |
|
|
38
48
|
| `ratchet_get_policy` | Read the retry and budget policy for an effect type |
|
|
39
|
-
| `
|
|
49
|
+
| `ratchet_get_usage` | Plan, allowance, credit balance, and today's spend |
|
|
40
50
|
|
|
41
51
|
Only `execute` authorises the model to act. Every other decision returns a `next_step` beginning
|
|
42
52
|
with `STOP`.
|
package/bin/ratchet-mcp.mjs
CHANGED
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ratchet-mcp",
|
|
3
3
|
"mcpName": "com.ratchetgate/ratchet",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.3.0",
|
|
5
5
|
"description": "MCP server for Ratchet. Your agent asks before it charges, deploys, publishes or sends \u2014 the same action is attempted at most once.",
|
|
6
6
|
"license": "Apache-2.0",
|
|
7
7
|
"homepage": "https://ratchetgate.com",
|