# Approval Rules

> Rules for what your AI agent may do without asking. Small, reversible actions under your limits get auto-approved; everything else becomes a plain-English approval card you tap Approve or Reject on. Free watch-only mode logs what it would decide and drafts a weekly report; Pro (All Access, $49 a month) makes the rules act.

## Connect
- MCP (streamable HTTP): https://approve.cloudforbots.com/mcp
- Claude Code: `claude mcp add --transport http approval-rules https://approve.cloudforbots.com/mcp`
- REST: `POST https://approve.cloudforbots.com/api/run/<tool>` with JSON args. OpenAPI: https://approve.cloudforbots.com/openapi.json
- Auth: optional `Authorization: Bearer <key>`. Free key: `POST https://approve.cloudforbots.com/api/key`

## Pricing
- Free: 200 calls/day (daily, not a trial). No signup.
- Pro: $49/month All Access, 20000 calls/day: https://cloudforbots.com/offer
- Bring your own model. Works with Claude, Codex, ChatGPT, Grok Bot.

## Tools
### check_action
Before a consequential action, ask whether the user's rules auto-approve it. Returns auto_approve, needs_approval (with a plain-English approval card and a link the user can tap) or deny. Free plan is watch-only: it reports what it WOULD decide and logs it for the weekly report, but nothing counts as approved, so ask your user as you normally would.
Inputs: `action` (object, required)

### get_decision
Check whether the user approved or rejected an approval card (by card_id and card_token). Only act when status is approved.
Inputs: `card_id` (string, required), `card_token` (string, required)

### set_rules
Save the user's rules (needs an API key so they stay yours). Each rule: {name, when:{type:[...], max_usd, min_usd, reversible, target_ends_with:[...]}, verdict:"auto"|"ask"|"deny"}. First matching rule wins; anything unmatched needs approval. Call once without confirm to preview, then with confirm=true.
Inputs: `rules` (array, required), `confirm` (boolean)

### get_rules
Show the rules in effect for your key (or the default starter rules).
Inputs: none

### weekly_report
Draft a plain-English report of the last 7 days: actions checked, how many your rules would auto-approve, how many needed you, top kinds of asks, and rule suggestions. Read-only; sends nothing.
Inputs: none

### usage_and_upgrade
Usage today + upgrade link (not metered).

## Example result
`check_action({"summary":"Renew domain example.com for $3.99"})` → Watch-only: your rules WOULD auto-approve this. Nothing is approved in free mode; ask your user as usual. Logged for the weekly report.

## FAQ
### What problem does this solve?
Agents either ask about everything, so people rubber-stamp, or ask about nothing, so mistakes slip through. Approval Rules lets your user say once what is fine (reads, drafts, small reversible spend) and what always needs them (deletes, messages to new people, big payments).

### How does my agent use it?
Before a consequential action, call check_action with the type, a one-line summary, the amount and target. You get auto_approve, deny, or needs_approval with a plain-English card and a link your user taps Approve or Reject on. Call get_decision before acting.

### What is watch-only mode?
The free plan never approves anything. It tells your agent what the rules would decide, logs it, and weekly_report drafts a summary: how many asks the rules would have cleared, how many still need you, and which rules to add. Your agent keeps asking you as usual.

### What are the default rules?
Auto-approve reads, searches and drafts, and reversible spend up to $5. Ask about deletes and messages to people. Block anything $500 or more. With an API key, set_rules replaces them with your own, after a preview your user confirms.

### Is there a model inside?
No. Bring your own model. Approval Rules only matches the action your agent describes against the rules; it never performs the action, sends messages or moves money.

### What does it cost?
Free: watch-only, 200 checks a day, weekly report. Pro comes with All Access at $49 a month (every Cloud for Bots tool): binding auto-approvals, hosted approval cards, 20,000 checks a day. You get your Pro key on screen right after paying.

Publisher: Supa Humans (https://supahumans.ai). Marketplace: https://botrecipe.com/tools/

## Machine files
- https://approve.cloudforbots.com/
- https://approve.cloudforbots.com/index.md
- https://approve.cloudforbots.com/llms.txt
- https://approve.cloudforbots.com/llms-full.txt
- https://approve.cloudforbots.com/SKILL.md
- https://approve.cloudforbots.com/openapi.json
- https://approve.cloudforbots.com/tool.json
- https://approve.cloudforbots.com/.well-known/mcp.json