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
claude mcp add --transport http hook https://gethook.app/mcp --header "Authorization: Bearer hk_…"{
"mcpServers": {
"hook": {
"url": "https://gethook.app/mcp",
"headers": { "Authorization": "Bearer hk_…" }
}
}
}[mcp_servers.hook]
url = "https://gethook.app/mcp"
http_headers = { Authorization = "Bearer hk_…" }Transport: Streamable HTTP
URL: 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
| Tool | What it does |
|---|---|
send_push_notification | Send a notification, with media, id, badge and buttons. |
dismiss_push_notification | Remove one from the Lock Screen. |
list_push_notifications · get_push_notification | Read the inbox. |
update_app_icon_badge_count | Set the app icon badge. |
set_live_activity_stream · end_live_activity_stream | Start, update and end a Live Activity. |
list_live_activities · get_live_activity | Read streams. |
set_widget_metric_value · list_widget_metrics · delete_widget_metric | Widget numbers. |
request_approval · wait_for_approval | Ask and wait for a decision. |
get_approval · list_approvals · cancel_approval | Manage approvals. |
list_team · set_channel_members | See your team; choose who gets a topic. |
get_account | Your 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:
- The agent calls
request_approvalwith atitleand optionalmessage,details,approve_labelanddeny_label. - You tap a button on the Lock Screen, or open the request in Hook to read the details.
- The agent gets
approved,denied,expiredorcancelled. 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:
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.