Docs / MCP and approvalsMenu

MCP and approvals

Let Claude Code, Cursor, Codex or any MCP client notify you and ask for approval on your iPhone.

Hook runs a remote MCP server at https://gethook.app/mcp. Your AI agent can send you a push, show progress as a Live Activity, and ask before it does something risky. Create an API token first.

Set up

terminal
claude mcp add --transport http hook https://gethook.app/mcp --header "Authorization: Bearer hk_…"

The server is stateless and uses bearer tokens, not OAuth. A missing or revoked token gets 401.

Tools

ToolWhat it does
send_push_notificationSend a notification, with media, id, badge and buttons.
dismiss_push_notificationRemove one from the Lock Screen.
list_push_notifications · get_push_notificationRead the inbox.
update_app_icon_badge_countSet the app icon badge.
set_live_activity_stream · end_live_activity_streamStart, update and end a Live Activity.
list_live_activities · get_live_activityRead streams.
set_widget_metric_value · list_widget_metrics · delete_widget_metricWidget numbers.
request_approval · wait_for_approvalAsk and wait for a decision.
get_approval · list_approvals · cancel_approvalManage approvals.
list_team · set_channel_membersSee your team; choose who gets a topic.
get_accountYour plan, usage and workspace URL.

Each tool calls the matching API endpoint, so limits and errors are the same.

Approvals

An approval is a question your agent asks you. Hook sends a time-sensitive notification with Approve and Deny buttons. The flow:

  1. The agent calls request_approval with a title and optional message, details, approve_label and deny_label.
  2. You tap a button on the Lock Screen, or open the request in Hook to read the details.
  3. The agent gets approved, denied, expired or cancelled. Requests expire after 30 minutes.

Pass wait_seconds (up to 50) to wait in the same call, or callwait_for_approval again while the status is pending. An agent should only continue on approved.

The same thing over REST, for scripts:

terminal
curl -X POST https://gethook.app/api/approvals \
  -H "Authorization: Bearer hk_…" -H "Content-Type: application/json" \
  -d '{ "title": "Deploy api to production", "message": "v1.8.0, 12 commits" }'

curl "https://gethook.app/api/approvals/{id}?wait=25" -H "Authorization: Bearer hk_…"

Something wrong on this page? Email office@swiftapps.us.