DOCUMENTATION

Give an agent one clear route to you.

Set up a linked phone, issue a device-scoped key, and choose MCP, the command line, or REST. The agent can make a handoff; you keep the destination and interruption mode under control.

Create an account

01 — START HERE

Make the destination explicit.

01
Sign in to the web app.
Create your Stoop account, then open Devices.
02
Link the phone you want an agent to reach.
Use the QR flow or sign in on the iOS or Android app.
03
Mint a key for that device.
Each new agent key is scoped to one linked phone; save it when it is shown.

Keep keys narrow.

A device-scoped key cannot enroll phones or create more keys. It can only work with the phone it was issued for.

02 — MCP

Connect your agent.

The MCP server exposes a small set of tools: get the current time, set an alarm, list alarms and devices, cancel an alarm, and acknowledge a fired alarm.

mcp.json

{
  "mcpServers": {
    "stoop": {
      "command": "npx",
      "args": ["-y", "stoop-mcp"],
      "env": {
        "API_BASE_URL": "https://stoop-api.aadarshgupta1412.workers.dev",
        "STOOP_API_KEY": "aa_...",
        "STOOP_TZ": "Asia/Kolkata"
      }
    }
  }
}

Use an IANA timezone so phrases such as “tomorrow 7am” resolve where you are.

03 — CLI

Script the handoff.

The CLI is useful for terminal workflows, scheduled jobs, and quick delivery checks. Log in once, confirm the device, then use natural-time commands.

terminal

stoop login
stoop devices
stoop set "tomorrow 7am" "Wake up" --repeat weekdays
stoop list
stoop doctor

04 — REST API

Use Stoop in a larger workflow.

Send an ISO 8601 time with an agent key. The key’s pinned device is selected for you, so an automated workflow cannot fan out to every phone on the account.

request

curl -X POST https://stoop-api.aadarshgupta1412.workers.dev/v1/alarms \
  -H "Authorization: Bearer aa_..." \
  -H "Content-Type: application/json" \
  -d '{
    "fireAt": "2026-09-01T01:30:00Z",
    "label": "Review the deploy",
    "message": "Production checks are ready."
  }'

DELIVERY MODEL

Push syncs. The phone keeps time.

Push tells the app there is a new handoff to fetch. Once an alarm has reached the phone, the operating system schedules it locally, so it can still ring after the network disappears. Use a notification for routine work and an alarm for moments that should interrupt.

FAQ