@usethrottle/mcp 0.4.1 → 0.4.2

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 CHANGED
@@ -67,12 +67,19 @@ than tools that fail when called.
67
67
 
68
68
  ## Writes
69
69
 
70
- This release is read-only against real data; sandbox seeding is the sole
71
- exception and is refused outright on a production credential.
70
+ By default the server is read-only. Write tools register only when you start it
71
+ with `--allow-writes`, and only those the key is scoped for:
72
72
 
73
- Write tools (quotes, refunds, subscription changes, webhook replay) land in the
74
- next release behind `--allow-writes`, with a second `--allow-live-writes` gate for
75
- production keys and an idempotency key on every call.
73
+ `create_customer`, `update_customer`, `create_checkout_link`, `create_quote`,
74
+ `send_quote`, `refund_payment`, `manage_subscription`, `cancel_subscription`,
75
+ `replay_webhook_delivery`, `send_test_webhook`.
76
+
77
+ On a production key they additionally need `--allow-live-writes`. Every write
78
+ call carries an idempotency key, so a retried tool call never acts twice.
79
+ `seed_test_data` is the one write that needs no flag, and it is refused outright
80
+ on a production key.
81
+
82
+ The hosted server at `mcp.usethrottle.dev` registers no write tools at all.
76
83
 
77
84
  ## Options
78
85
 
@@ -80,8 +87,8 @@ production keys and an idempotency key on every call.
80
87
  | --- | --- |
81
88
  | `--api-key <key>` | `THROTTLE_API_KEY` |
82
89
  | `--api <url>` | `THROTTLE_API_URL`, else `https://api.usethrottle.dev` |
83
- | `--allow-writes` | off (reserved for the write tools above) |
84
- | `--allow-live-writes` | off |
90
+ | `--allow-writes` | off — registers the write tools above |
91
+ | `--allow-live-writes` | off — also required for writes on a production key |
85
92
 
86
93
  A key belongs to one environment. To expose both production and a sandbox
87
94
  environment, add two server entries with different keys and distinct names.