{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "pushary.com",
    "site": "pushary.com",
    "addresses": [
      {
        "address": "216.150.16.193",
        "endpoints": 690,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.16.0/24",
          "country": "US"
        }
      },
      {
        "address": "216.150.1.129",
        "endpoints": 447,
        "shared_infrastructure": true,
        "network": {
          "asn": 16509,
          "name": "AMAZON-02 - Amazon.com, Inc.",
          "prefix": "216.150.1.0/24",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "216.150.16.193",
          "216.150.1.129"
        ],
        "first_seen": "2026-11-21T14:23:01.391Z",
        "last_seen": "2026-11-21T14:23:01.391Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Vercel",
        "evidence": "Server header \"Vercel\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "Pushary",
      "version": "1.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "Vercel",
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 1091,
      "sample": [
        {
          "id": "26",
          "url": "https://mrk.ae/api/mcp",
          "server_name": "ae.mrk/dubai-property",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:31:08.438Z"
        },
        {
          "id": "38",
          "url": "https://www.hood.ag/api/mcp",
          "server_name": "ag.hood/name-service",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:32:01.495Z"
        },
        {
          "id": "39",
          "url": "https://www.almostimpossible.agency/mcp",
          "server_name": "agency.almostimpossible/site",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:32:01.495Z"
        },
        {
          "id": "182",
          "url": "https://www.ai-portal.ai/mcp",
          "server_name": "ai.ai-portal/ai-portal",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:34:01.210Z"
        },
        {
          "id": "248",
          "url": "https://app.aqta.ai/api/mcp",
          "server_name": "ai.aqta/seal",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:35:03.039Z"
        },
        {
          "id": "278",
          "url": "https://asrm.ai/mcp",
          "server_name": "ai.asrm/asrm",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:37:01.449Z"
        },
        {
          "id": "300",
          "url": "https://app.augenix.ai/api/mcp/public",
          "server_name": "ai.augenix/build",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:38:01.449Z"
        },
        {
          "id": "368",
          "url": "https://beexcellent.ai/api/mcp/public",
          "server_name": "ai.beexcellent/reference",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:39:02.648Z"
        },
        {
          "id": "395",
          "url": "https://property.bluebed.ai/mcp",
          "server_name": "ai.bluebed.property/new-launches",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:40:02.123Z"
        },
        {
          "id": "416",
          "url": "https://www.bordet.ai/api/mcp/mcp",
          "server_name": "ai.bordet/bordet",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:39:02.482Z"
        },
        {
          "id": "430",
          "url": "https://www.budgetseo.ai/api/mcp",
          "server_name": "ai.budgetseo/budget-seo-mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:00.965Z"
        },
        {
          "id": "461",
          "url": "https://callmcp.ai/mcp",
          "server_name": "ai.callmcp/server",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:01.824Z"
        },
        {
          "id": "465",
          "url": "https://www.canaryusers.ai/api/mcp",
          "server_name": "ai.canaryusers/canaryusers",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:41:01.864Z"
        },
        {
          "id": "523",
          "url": "https://agentmart.ciphyr.ai/mcp",
          "server_name": "ai.ciphyr.agentmart/agentmart",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:42:02.049Z"
        },
        {
          "id": "524",
          "url": "https://agentmart.ciphyr.ai/mcp/core",
          "server_name": "ai.ciphyr.agentmart/core",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:44:00.984Z"
        },
        {
          "id": "540",
          "url": "https://www.clearthesis.ai/mcp",
          "server_name": "ai.clearthesis/clearthesis",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:43:00.925Z"
        },
        {
          "id": "670",
          "url": "https://www.decisionlog.ai/api/mcp",
          "server_name": "ai.decisionlog/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:45:03.762Z"
        },
        {
          "id": "754",
          "url": "https://www.edgechat.ai/mcp",
          "server_name": "ai.edgechat/edgepedia",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:48:01.794Z"
        },
        {
          "id": "787",
          "url": "https://mcp.tenda.eshmere.ai/mcp",
          "server_name": "ai.eshmere/tenda",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:50:01.774Z"
        },
        {
          "id": "868",
          "url": "https://www.flamel.ai/mcp",
          "server_name": "ai.flamel/public-content",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T04:51:02.819Z"
        }
      ]
    },
    "same_site": {
      "total": 1,
      "sample": [
        {
          "id": "26276",
          "url": "https://pushary.com/api/mcp/sse",
          "server_name": "io.github.Pushary/pushary",
          "last_state": "unsupported_transport",
          "last_checked_at": null
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.Pushary",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/Pushary/pushary-skill",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "26275",
    "server_name": "io.github.Pushary/pushary",
    "url": "https://pushary.com/api/mcp/mcp",
    "host": "pushary.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T14:23:01.391Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "0d5968d5cdeea11e0b3c282da1a6e3730a10c7e8412ad2674c0c86558559014b",
    "first_listed_at": "2026-11-21T14:23:01.391Z",
    "created_at": "2026-11-21T08:50:05.463Z",
    "resolved_addresses": [
      "216.150.16.193",
      "216.150.1.129"
    ]
  },
  "server": {
    "name": "io.github.Pushary/pushary",
    "title": "Pushary: human-in-the-loop for AI agents",
    "description": "Human-in-the-loop for AI agents: ask a person and get approvals or answers by push notification.",
    "version": "1.5.2",
    "registry_status": "active",
    "repository_url": "https://github.com/Pushary/pushary-skill",
    "website_url": "https://pushary.com/?utm_source=mcp-registry&utm_medium=integration-directory",
    "published_at": "2026-10-25T15:36:21.496Z",
    "updated_at": "2026-10-25T15:36:21.496Z",
    "first_seen": "2026-11-21T08:50:05.056Z"
  },
  "other_endpoints": [
    {
      "id": "26276",
      "url": "https://pushary.com/api/mcp/sse",
      "transport": "sse",
      "last_state": "unsupported_transport",
      "last_checked_at": null
    }
  ],
  "intel": {
    "capabilities": [
      "sends-messages"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:39:13.176Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 802,
    "first_check_in_window": "2026-11-21T14:23:01.391Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "0d5968d5cdeea11e0b3c282da1a6e3730a10c7e8412ad2674c0c86558559014b",
    "tools": 6,
    "resources": 5,
    "prompts": 0,
    "first_seen": "2026-11-21T14:23:02.195Z",
    "tool_names": [
      "schedule_reminder",
      "send_notification",
      "ask_user",
      "propose_scope",
      "wait_for_answer",
      "cancel_question"
    ],
    "declared": {
      "tools": [
        {
          "name": "schedule_reminder",
          "title": "Schedule a Personal Reminder to Remind Them Later",
          "description": "Schedule, list, retrieve or cancel a personal Pushary reminder for the authenticated user. Scheduled reminders can arrive after the agent exits. One-time only; up to 30 days away, 25 pending per user/site. Scheduling requires body and either inMinutes or at with an explicit UTC offset. requestId identifies one schedule across retries. reminderId retrieves its outcome; no arguments lists pending reminders; cancelReminderId cancels a pending reminder. Returns the scheduled time, state and any delivery warning. Delivery respects stop/mute and active membership. Does not schedule agent work or customer campaigns. API reference: https://pushary.com/docs/agents/reference/tools#schedule_reminder",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "at": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "description": "Future ISO 8601 timestamp with explicit UTC offset or Z, at most 30 days away. Resolve the user's local time and timezone before scheduling; never guess a timezone."
              },
              "env": {
                "type": "string",
                "const": "test"
              },
              "body": {
                "type": "string",
                "maxLength": 180,
                "minLength": 1,
                "description": "What to remind the authenticated user about, at most 180 UTF-16 units after secret redaction (emoji may use two). Omit all fields to list their pending reminders."
              },
              "title": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              "agentName": {
                "type": "string",
                "maxLength": 100
              },
              "inMinutes": {
                "type": "integer",
                "maximum": 43200,
                "minimum": 1,
                "description": "Minutes from the server clock; use for timers and relative reminders."
              },
              "machineId": {
                "type": "string",
                "maxLength": 128
              },
              "requestId": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "Unique ID for this scheduling operation. Reuse it unchanged on retries to return the original reminder, including after it settles."
              },
              "sessionId": {
                "type": "string",
                "maxLength": 128
              },
              "reminderId": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "Look up your reminder, including its final outcome and delivery status, instead of scheduling or cancelling."
              },
              "cancelReminderId": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "Cancel this user's scheduled reminder instead of creating one. Already-dispatching reminders cannot be cancelled."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "pending",
              "hint"
            ],
            "properties": {
              "hint": {
                "type": "string",
                "description": "What the result means and what to do next."
              },
              "pending": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "title",
                    "body",
                    "fireAt",
                    "status",
                    "reason",
                    "settledAt"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Reminder ID. Pass it as reminderId to read its outcome, or as cancelReminderId to cancel it while it is scheduled."
                    },
                    "body": {
                      "type": "string",
                      "description": "Reminder text after secret redaction."
                    },
                    "title": {
                      "type": "string",
                      "description": "Title shown on the phone and the Mac app."
                    },
                    "fireAt": {
                      "type": "string",
                      "description": "When the reminder is due, as an ISO 8601 UTC timestamp."
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Why the reminder was suppressed or failed, or null."
                    },
                    "status": {
                      "enum": [
                        "scheduled",
                        "firing",
                        "dispatched",
                        "cancelled",
                        "suppressed",
                        "failed"
                      ],
                      "type": "string",
                      "description": "scheduled and firing are pending. dispatched means it was handed to the delivery path, not that a person saw it. cancelled, suppressed and failed are final."
                    },
                    "settledAt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the reminder reached a final state, or null while it is pending."
                    }
                  },
                  "additionalProperties": {}
                },
                "description": "The authenticated user's pending reminders on this site, soonest first."
              },
              "warning": {
                "type": "string",
                "description": "Present when no phone is connected, so the reminder will appear only in the Pushary Mac app."
              },
              "delivery": {
                "type": "object",
                "required": [
                  "pending",
                  "sent",
                  "delivered",
                  "failed"
                ],
                "properties": {
                  "sent": {
                    "type": "number",
                    "description": "Pushes Expo accepted."
                  },
                  "failed": {
                    "type": "number",
                    "description": "Pushes that failed."
                  },
                  "pending": {
                    "type": "number",
                    "description": "Pushes not yet handed to a provider."
                  },
                  "delivered": {
                    "type": "number",
                    "description": "Pushes with a provider receipt. A receipt is not proof the person read it."
                  }
                },
                "description": "Push delivery counts for a reminder looked up by reminderId.",
                "additionalProperties": {}
              },
              "reminder": {
                "type": "object",
                "required": [
                  "id",
                  "title",
                  "body",
                  "fireAt",
                  "status",
                  "reason",
                  "settledAt"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Reminder ID. Pass it as reminderId to read its outcome, or as cancelReminderId to cancel it while it is scheduled."
                  },
                  "body": {
                    "type": "string",
                    "description": "Reminder text after secret redaction."
                  },
                  "title": {
                    "type": "string",
                    "description": "Title shown on the phone and the Mac app."
                  },
                  "fireAt": {
                    "type": "string",
                    "description": "When the reminder is due, as an ISO 8601 UTC timestamp."
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Why the reminder was suppressed or failed, or null."
                  },
                  "status": {
                    "enum": [
                      "scheduled",
                      "firing",
                      "dispatched",
                      "cancelled",
                      "suppressed",
                      "failed"
                    ],
                    "type": "string",
                    "description": "scheduled and firing are pending. dispatched means it was handed to the delivery path, not that a person saw it. cancelled, suppressed and failed are final."
                  },
                  "settledAt": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "When the reminder reached a final state, or null while it is pending."
                  }
                },
                "description": "The reminder this call scheduled, matched or looked up. Absent when listing, when cancelling, and when reminderId found nothing.",
                "additionalProperties": {}
              },
              "cancelled": {
                "type": "boolean",
                "description": "Present when cancelReminderId was passed. True when a scheduled reminder was cancelled; false when it was not found or already dispatching or final."
              },
              "duplicate": {
                "type": "boolean",
                "description": "True when scheduling returned an existing reminder: a retried requestId, or the same reminder scheduled moments earlier."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Schedule a Personal Reminder to Remind Them Later",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "send_notification",
          "title": "Send Push Notification",
          "description": "Send a notification to connected devices for a requested update or a meaningful unattended result, such as a finished task. Delivery follows the account policy and optional recipient filters. context adds a detail page. context.askQuestion is kept for older clients; ask questions with ask_user. Returns web/mobile delivery counts and a warning when no delivery channel is connected. Sends real notifications. API reference: https://pushary.com/docs/agents/reference/tools#send_notification",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "title",
              "body"
            ],
            "properties": {
              "env": {
                "enum": [
                  "test"
                ],
                "type": "string",
                "description": "Set to \"test\" from a test suite. The notification is recorded in the activity feed and nothing is delivered to a phone or browser. The X-Pushary-Env: test header does the same for every call on the connection."
              },
              "url": {
                "type": "string",
                "format": "uri",
                "description": "URL opened when the user taps the notification. Ignored if context is provided, because a context detail page URL is generated automatically."
              },
              "body": {
                "type": "string",
                "maxLength": 500,
                "minLength": 1,
                "description": "Notification body text (max 500 chars). One or two sentences the user can act on without opening anything."
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to subscribers that have any of these tags."
              },
              "title": {
                "type": "string",
                "maxLength": 100,
                "minLength": 1,
                "description": "Notification title shown on the lock screen (max 100 chars). Lead with the outcome, e.g. \"Build finished\" or \"Migration failed\"."
              },
              "context": {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "enum": [
                      "task_complete",
                      "error",
                      "info"
                    ],
                    "type": "string",
                    "description": "What kind of update this is. Use \"task_complete\" when work finished, \"error\" when something failed (delivered with high urgency), \"info\" for everything else. Error severity describes this notification, not the agent session health."
                  },
                  "details": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Bullet-point details rendered as a list"
                  },
                  "summary": {
                    "type": "string",
                    "description": "Short summary of what happened, shown at the top of the detail page"
                  },
                  "errorFile": {
                    "type": "string",
                    "description": "File path where the error occurred"
                  },
                  "nextSteps": {
                    "type": "string",
                    "description": "What the user should do next, e.g. \"Review the PR\" or \"Re-run with --force\""
                  },
                  "askQuestion": {
                    "type": "object",
                    "required": [
                      "question"
                    ],
                    "properties": {
                      "type": {
                        "enum": [
                          "confirm",
                          "select",
                          "input"
                        ],
                        "type": "string",
                        "default": "confirm",
                        "description": "Question type: confirm (yes/no), select (pick from options), or input (free text)"
                      },
                      "options": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "maxItems": 6,
                        "minItems": 2,
                        "description": "The 2 to 6 choices for a select question"
                      },
                      "question": {
                        "type": "string",
                        "maxLength": 8000,
                        "minLength": 1,
                        "description": "A follow-up question shown below the context (e.g. \"Retry with a different approach?\")"
                      }
                    },
                    "description": "Kept for older clients. To ask the user something, call ask_user instead: it stays open at least as long, offers lock-screen answers on confirm questions, and, unless the agent connects through a connector, stays open until answered or cancelled. An embedded question appears on the detail page, closes 10 minutes after it is created, and returns a linkedCorrelationId for wait_for_answer. Only for a decision about unfinished work. Not for asking what to do next once the requested work is complete, unless the user asked you to."
                  },
                  "errorMessage": {
                    "type": "string",
                    "description": "The error message, when type is \"error\""
                  },
                  "filesChanged": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Paths of files that were created or modified"
                  }
                },
                "description": "Structured context rendered as a rich detail page when the user taps the notification. Strongly recommended for task_complete and error notifications so the user can act from their phone."
              },
              "iconUrl": {
                "type": "string",
                "format": "uri",
                "description": "URL of the notification icon image"
              },
              "imageUrl": {
                "type": "string",
                "format": "uri",
                "description": "URL of a large image shown in the notification"
              },
              "agentName": {
                "type": "string",
                "maxLength": 100,
                "description": "Name of the agent sending this notification, format \"{Agent} - {project}\" (e.g. \"Claude Code - myproject\"). Shown in the notification so the user knows which session is talking. Falls back to the MCP client name if omitted."
              },
              "machineId": {
                "type": "string",
                "maxLength": 128,
                "description": "Stable machine id of the sending agent, so two machines never collapse into one session."
              },
              "sessionId": {
                "type": "string",
                "maxLength": 128,
                "description": "Opaque per-session id of the sending agent, so parallel sessions are attributed separately in the activity feed."
              },
              "externalIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to subscribers matching these external IDs."
              },
              "subscriberIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to these subscriber IDs. Omit all targeting fields to reach every connected device."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "env": {
                "enum": [
                  "test"
                ],
                "type": "string",
                "description": "Echoed when the call was test traffic."
              },
              "hint": {
                "type": "string",
                "description": "What to do next, when there is a next step."
              },
              "sent": {
                "type": "number",
                "description": "Total devices reached, web plus mobile. Zero is a successful call that found nobody to deliver to, not an error."
              },
              "status": {
                "enum": [
                  "recorded",
                  "ignored"
                ],
                "type": "string",
                "description": "Outcome when a session completion is recorded for delivery once per turn."
              },
              "updates": {
                "type": "object",
                "required": [
                  "mode",
                  "source"
                ],
                "properties": {
                  "mode": {
                    "enum": [
                      "both",
                      "phone",
                      "browser",
                      "none"
                    ],
                    "type": "string"
                  },
                  "source": {
                    "enum": [
                      "kill",
                      "snooze",
                      "setting",
                      "mode",
                      "default"
                    ],
                    "type": "string"
                  }
                },
                "description": "Effective update delivery setting and the policy that selected it.",
                "additionalProperties": {}
              },
              "warning": {
                "type": "string",
                "description": "Present only when the notification reached zero devices, naming what the user has to connect."
              },
              "delivery": {
                "type": "object",
                "required": [
                  "web",
                  "mobile"
                ],
                "properties": {
                  "web": {
                    "type": "object",
                    "required": [
                      "recipients"
                    ],
                    "properties": {
                      "status": {
                        "type": "string",
                        "description": "Why web delivery reached nobody, present only when it reached nobody."
                      },
                      "recipients": {
                        "type": "number",
                        "description": "Browsers that accepted the push."
                      }
                    },
                    "additionalProperties": {}
                  },
                  "mobile": {
                    "type": "object",
                    "required": [
                      "recipients"
                    ],
                    "properties": {
                      "status": {
                        "type": "string",
                        "description": "Why mobile delivery reached nobody, present only when it reached nobody."
                      },
                      "recipients": {
                        "type": "number",
                        "description": "Phones that accepted the push."
                      }
                    },
                    "additionalProperties": {}
                  }
                },
                "description": "Per-channel outcome. The two channels are independent with no cross-fallback, so each reports its own result.",
                "additionalProperties": {}
              },
              "suppressed": {
                "type": "string",
                "description": "Reason the notification was recorded without a push."
              },
              "attribution": {
                "enum": [
                  "session",
                  "unattributed"
                ],
                "type": "string",
                "description": "Whether real session and machine identifiers were supplied. Unattributed notifications are delivered without creating a live session."
              },
              "completionId": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Recorded completion identifier, or null when no completion was recorded."
              },
              "notificationId": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "description": "Trace ID for this notification; provider acceptance does not confirm a person saw it."
              },
              "linkedCorrelationId": {
                "type": "string",
                "description": "Present only when context.askQuestion embedded a decision prompt. Pass it to wait_for_answer to collect the response."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Send Push Notification",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "ask_user",
          "title": "Ask User a Question; May Call or Ring Their Phone If Unanswered",
          "description": "Ask for an unresolved decision or missing input. Prefer this over an in-app question when the user requests Pushary or mobile contact, is away, or work is unattended. Use it when the user asks you to call, phone or ring them if you get stuck or blocked. Supports confirm, select and input. Delivery follows account policy. When the reply includes phoneCall, Pushary may phone the person who can answer if the question is still unanswered, and records their answer; without phoneCall no call is planned. Waits at most 48 seconds and may return at once. While the reply is pending and has no handoffAction, keep waiting with wait_for_answer and the same correlationId. A poll ending does not cancel the question. Returns state, answer, delivery and handoff fields; answerUrl is optional. Sends a real question; it does not authorize other actions.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "question"
            ],
            "properties": {
              "cwd": {
                "type": "string",
                "maxLength": 4096,
                "minLength": 1,
                "description": "MACHINE-POPULATED. The working directory a hook resolved the rule for toolPath against, so a relative path rule resolves the same way here. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "env": {
                "enum": [
                  "test"
                ],
                "type": "string",
                "description": "Set to \"test\" from a test suite. The question is stored and returned as pending, and nothing is delivered to a phone, browser or Slack. The X-Pushary-Env: test header does the same for every call on the connection."
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to subscribers that have any of these tags."
              },
              "type": {
                "enum": [
                  "confirm",
                  "select",
                  "input"
                ],
                "type": "string",
                "default": "confirm",
                "description": "Question type: confirm renders yes/no buttons, select renders the options list, input renders a free-text field."
              },
              "wait": {
                "type": "boolean",
                "default": true,
                "description": "true (default) blocks until the user answers or the timeout fires. Set false to return immediately with a pending correlationId and poll it yourself via wait_for_answer."
              },
              "action": {
                "type": "string",
                "minLength": 0,
                "description": "The concrete operation about to happen, one line. Shown as the Action line. Cut to 500 chars."
              },
              "intent": {
                "type": "string",
                "minLength": 0,
                "description": "The user's stated task (from their last prompt), one line. Shown as the Intent line so the user can see why the agent stopped. Cut to 500 chars."
              },
              "blocker": {
                "type": "string",
                "minLength": 0,
                "description": "The single gating reason the agent stopped, one line. Shown as the Blocker line. Cut to 500 chars."
              },
              "context": {
                "type": "string",
                "maxLength": 500,
                "description": "One or two sentences about what the agent is working on, shown above the question so the user can decide without opening the terminal."
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                },
                "maxItems": 6,
                "minItems": 2,
                "description": "The 2 to 6 choices for a select question. Required when type is \"select\", ignored otherwise. The answered value is the chosen option string, or the text the person typed instead when allowOther is true."
              },
              "repoKey": {
                "type": "string",
                "maxLength": 200,
                "description": "Stable repository identity for the working directory, e.g. \"github.com/acme/api\". Lets an approval routing rule scoped to one repository avoid governing another. Optional; omit it and only workspace-wide routing rules apply."
              },
              "question": {
                "type": "string",
                "maxLength": 8000,
                "minLength": 1,
                "description": "The complete question, up to 8000 characters. Preserve every point. Notifications show a short preview; the answer interface shows the full question."
              },
              "toolName": {
                "type": "string",
                "maxLength": 100,
                "description": "The tool this approval is for (e.g. \"Bash\"), so the user can choose to always-allow it."
              },
              "toolPath": {
                "type": "string",
                "pattern": "^(?:\\/|[A-Za-z]:[\\\\/])",
                "maxLength": 4096,
                "description": "MACHINE-POPULATED. Exact absolute path of the file a file tool call writes, as the hook matched its rule on. Any other value is ignored. Models must omit it."
              },
              "agentName": {
                "type": "string",
                "minLength": 0,
                "description": "Name of the agent asking, format \"{Agent} - {project}\" (e.g. \"Claude Code - myproject\"). Shown in the notification title so the user knows which session needs them. Falls back to the MCP client name if omitted. Cut to 100 chars."
              },
              "machineId": {
                "type": "string",
                "maxLength": 128,
                "description": "Stable machine id of the asking agent, so two machines never collapse into one session."
              },
              "questions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "question",
                    "multiSelect",
                    "options"
                  ],
                  "properties": {
                    "header": {
                      "type": "string",
                      "maxLength": 40
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "label"
                        ],
                        "properties": {
                          "label": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1
                          },
                          "description": {
                            "type": "string",
                            "maxLength": 500
                          }
                        }
                      },
                      "maxItems": 4,
                      "minItems": 2
                    },
                    "question": {
                      "type": "string",
                      "maxLength": 8000,
                      "minLength": 1
                    },
                    "allowOther": {
                      "type": "boolean"
                    },
                    "multiSelect": {
                      "type": "boolean"
                    }
                  }
                },
                "maxItems": 1,
                "minItems": 1,
                "description": "ONE question, in the richer Claude-compatible shape: a header, per-option descriptions, multiSelect, and an optional write-in. Exactly one keeps already-installed clients answerable; asking several means several calls. Runtime-populated; ordinary callers should omit it and use question/type/options."
              },
              "requestId": {
                "type": "string",
                "maxLength": 200,
                "description": "MACHINE-POPULATED. The CALLER's own identifier for one logical invocation, used only when the runtime supplies no toolUseId. Mint it once, outside your retry loop, and send the same value on every attempt, so three retries of one ask become one decision. Do NOT derive it from the question text or reuse it across two deliberate asks: both collapse a real second question into the first one's answer. If you are a model deciding to call this tool, omit this field."
              },
              "scopePath": {
                "type": "string",
                "maxLength": 200,
                "description": "Set ONLY when this approval exists because the path falls outside the scope the user ratified via propose_scope. Approving then widens the run scope to include this exact path, so the user is not asked again for the same area."
              },
              "sessionId": {
                "type": "string",
                "maxLength": 128,
                "description": "Opaque per-session id of the asking agent, so parallel sessions are attributed separately."
              },
              "timeoutMs": {
                "type": "integer",
                "maximum": 55000,
                "minimum": 1000,
                "description": "How long this call blocks, in milliseconds (up to 55000 is accepted; one call blocks at most 48 seconds). Defaults to the site policy timeout. Ordinary questions stay open until answered or cancelled; through a connector they close 10 minutes after they are sent. A timeout ends this poll only; follow up with wait_for_answer."
              },
              "toolUseId": {
                "type": "string",
                "maxLength": 200,
                "description": "MACHINE-POPULATED. The agent RUNTIME's own identifier for the tool call this approval gates, forwarded verbatim by a hook that received it. Do NOT invent, guess, derive, or reuse a value: two different questions sent under the same id collapse into one, and the second one never reaches a human. If you are a model deciding to call this tool, omit this field."
              },
              "actionBody": {
                "type": "string",
                "maxLength": 4000,
                "description": "The diff (Edit/Write) or full command (Bash/apply_patch), secret-redacted and size-capped. Rendered as a collapsible detail block; never used as the push body."
              },
              "allowOther": {
                "type": "boolean",
                "description": "Select only, without questions: true also lets the person type an answer of their own, which is then the answered value. Set it unless your options cover every answer you could act on; omit it only then."
              },
              "toolTarget": {
                "type": "string",
                "maxLength": 80,
                "description": "Compact target of the tool call (e.g. the command head \"git push\" for Bash, or a file extension like \".ts\" for Edit/Write). Used to mine policy suggestions."
              },
              "waitEndsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                "description": "MACHINE-POPULATED. When the agent hook stops waiting live and hands control back to the terminal. The question may remain answerable after this time. Ordinary callers should omit it."
              },
              "callbackUrl": {
                "type": "string",
                "format": "uri",
                "description": "Webhook URL that receives a POST with the answer when the user responds, signed with the X-Pushary-Signature header. Useful when the agent process may exit before the answer arrives."
              },
              "externalIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to subscribers matching these external IDs."
              },
              "pausedAware": {
                "type": "boolean",
                "description": "MACHINE-POPULATED. true from a hook that ends a paused approval exactly as the same approval unanswered after its full wait. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "placeholder": {
                "type": "string",
                "maxLength": 200,
                "description": "Hint text shown inside the free-text field for input questions"
              },
              "matchedRoute": {
                "type": "object",
                "required": [
                  "toolPattern"
                ],
                "properties": {
                  "repoKey": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "toolPattern": {
                    "type": "string",
                    "maxLength": 4096
                  }
                },
                "description": "MACHINE-POPULATED. The approval routing rule the hook matched on the machine, so this approval reaches the person that rule names. If you are a model deciding to call this tool, omit this field."
              },
              "questionOwner": {
                "type": "object",
                "properties": {},
                "description": "MACHINE-POPULATED. Ownership supplied by the supported personal Codex bridge. Models must omit this field.",
                "additionalProperties": {}
              },
              "subscriberIds": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Deliver only to these subscriber IDs. Omit all targeting fields to reach every connected device."
              },
              "permissionMode": {
                "type": "string",
                "maxLength": 64,
                "description": "MACHINE-POPULATED. The agent runtime's own permission or approval mode for the tool call this approval gates, recorded with the decision. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "callFingerprint": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "MACHINE-POPULATED. A hook's fingerprint of the exact tool call, so the same call made again after the hook stopped waiting rejoins this question instead of asking twice. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "routingToolName": {
                "type": "string",
                "maxLength": 100,
                "description": "MACHINE-POPULATED. The tool call this approval is about, sent by a client whose agent applies its own grant, and used only to match approval routing rules when toolName is absent. It never offers an always-allow rule. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "sessionToolAware": {
                "type": "boolean",
                "description": "MACHINE-POPULATED. Set by a Pushary hook whose engine applies a session tool grant with its risky-command ceiling, so the grant is only offered where it takes effect. If you are a model deciding to call this tool, omit this field."
              },
              "routingToolTarget": {
                "type": "string",
                "maxLength": 80,
                "description": "MACHINE-POPULATED. The compact target that goes with routingToolName, used only to match approval routing rules. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              },
              "agentPromptFollows": {
                "type": "boolean",
                "description": "MACHINE-POPULATED. false from a hook whose agent runs nothing and shows no prompt of its own when this approval is refused, so the approval is stored without a push past the question cap instead of refused. If you are a model deciding to call this tool, omit this field."
              },
              "localSurfaceAvailable": {
                "type": "boolean",
                "description": "MACHINE-POPULATED. false from a hook that cannot show its own approval prompt for this call, so the phone is asked every time and never spared for presence at the keyboard. Any other value is ignored. If you are a model deciding to call this tool, omit this field."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "correlationId",
              "question",
              "type"
            ],
            "properties": {
              "env": {
                "enum": [
                  "test"
                ],
                "type": "string",
                "description": "Echoed when the call was test traffic."
              },
              "held": {
                "enum": [
                  "test_traffic",
                  "unattributed"
                ],
                "type": "string",
                "description": "Present when the question was stored but deliberately not delivered: test traffic, or a permission ask with no toolName and no sessionId."
              },
              "hint": {
                "type": "string",
                "description": "What to do next, when there is a next step."
              },
              "mode": {
                "enum": [
                  "notify_only",
                  "terminal_only"
                ],
                "type": "string",
                "description": "The site delivery mode that stopped this call from waiting."
              },
              "note": {
                "type": "string",
                "description": "Free text the user added alongside their answer."
              },
              "type": {
                "enum": [
                  "confirm",
                  "select",
                  "input"
                ],
                "type": "string",
                "description": "The question type that was rendered."
              },
              "value": {
                "type": "string",
                "description": "The user's answer: \"yes\" or \"no\" for confirm, the chosen option for select (or the text they typed instead, when the select was asked with allowOther), the typed text for input."
              },
              "paused": {
                "type": "boolean",
                "description": "True when nothing was sent because the last approvals in this session went unanswered. Withdraw the question, then end the call as it would end unanswered."
              },
              "status": {
                "enum": [
                  "answered",
                  "pending",
                  "cancelled",
                  "expired",
                  "missing",
                  "unavailable",
                  "notified",
                  "terminal",
                  "stopped"
                ],
                "type": "string",
                "description": "The question state. Only pending is a live unanswered wait; cancelled, expired, missing, and unavailable must not be described as timeouts."
              },
              "warning": {
                "type": "string",
                "description": "Present only when no channel is connected, naming what the user has to connect."
              },
              "answered": {
                "type": "boolean",
                "description": "True once the user responded. Absent on the wait:false path, where nothing was awaited."
              },
              "delivery": {
                "type": "object",
                "required": [
                  "web",
                  "mobile"
                ],
                "properties": {
                  "web": {
                    "type": "number",
                    "description": "Browsers the question reached."
                  },
                  "mobile": {
                    "type": "number",
                    "description": "Phones the question reached."
                  },
                  "pending": {
                    "type": "boolean",
                    "description": "True when delivery was still in flight when this returned, so the counts above are not final."
                  }
                },
                "description": "Per-channel reach for the push carrying this question.",
                "additionalProperties": {}
              },
              "overflow": {
                "type": "boolean",
                "description": "True when the question was stored past the push cap: it is listed and answerable, but no push was sent for it. A wait on it is not a wait anyone was asked during, so a rule that approves on silence must not apply."
              },
              "question": {
                "type": "string",
                "description": "The question exactly as the user saw it."
              },
              "routedTo": {
                "type": "string",
                "description": "Who the enforced route sends this decision to, for display, when requesterMayAnswer is false."
              },
              "timedOut": {
                "type": "boolean",
                "description": "True when the initial wait ended while the question was still live. Poll once with wait_for_answer, then follow handoffAction when present, otherwise nextAction."
              },
              "answerUrl": {
                "type": "string",
                "description": "Optional signed-in dashboard page where the user can answer this question."
              },
              "noDevices": {
                "type": "boolean",
                "description": "True when no phone, browser, or Slack channel could receive the question. Do not wait; follow handoffAction immediately."
              },
              "phoneCall": {
                "type": "object",
                "required": [
                  "callee",
                  "status"
                ],
                "properties": {
                  "callee": {
                    "enum": [
                      "requester",
                      "approver"
                    ],
                    "type": "string",
                    "description": "requester: Pushary phones the user who asked. approver: it phones the person an approval route sends this question to, and says nothing about when."
                  },
                  "status": {
                    "enum": [
                      "planned",
                      "waiting_for_calling_hours"
                    ],
                    "type": "string",
                    "description": "planned: the call rings if the question is still unanswered. waiting_for_calling_hours: it is outside the requester's calling hours, and ringsAt and ringsAtLocal are when they start."
                  },
                  "ringsAt": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                    "description": "When the call to the requester rings if nobody has answered by then. Absent when the callee is an approver."
                  },
                  "ringsAtLocal": {
                    "type": "string",
                    "description": "ringsAt in the requester's own time zone, such as \"16:03 on Friday 14 November (Europe/Berlin)\". Tell the user this time, not ringsAt. Absent when the callee is an approver."
                  }
                },
                "description": "Present only when Pushary plans to phone someone who can answer this question if it stays unanswered. Without it, no call is planned. The spoken answer arrives through wait_for_answer: while the reply is pending and has no handoffAction, keep waiting with the same correlationId.",
                "additionalProperties": {}
              },
              "nextAction": {
                "enum": [
                  "wait_for_answer",
                  "ask_in_current_client"
                ],
                "type": "string",
                "description": "Backward-compatible next step: keep waiting while pending or ask in the current client. Follow handoffAction first when present."
              },
              "suppressed": {
                "type": "boolean",
                "description": "True when the PHONE push was deliberately held because a terminal on this machine is active, or, alongside paused, because nothing was sent at all. It says nothing about the notch, the dashboard or Slack, which are unaffected and may still be showing this question. A caller with no screen of its own should treat it as the terminal's to answer; a caller that can render the question itself should keep waiting unless paused is true."
              },
              "waitEndsAt": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                "description": "When the agent hook stops waiting live. On an idempotent replay this is the original question's deadline, which the hook must reuse."
              },
              "typedAnswer": {
                "type": "boolean",
                "const": true
              },
              "answerSource": {
                "enum": [
                  "dashboard",
                  "mobile_app",
                  "mobile_background",
                  "decide_page",
                  "live_page",
                  "answer_link",
                  "inbox",
                  "slack",
                  "mac_app",
                  "voice_call",
                  "sandbox"
                ],
                "type": "string",
                "description": "Recorded answering surface, when known. Missing provenance is not proof of a phone answer; sandbox is simulated."
              },
              "deliveryMode": {
                "enum": [
                  "push_first",
                  "push_only",
                  "notify_only",
                  "terminal_only"
                ],
                "type": "string",
                "description": "Effective delivery policy for this decision."
              },
              "correlationId": {
                "type": "string",
                "description": "Id of the question that was created. Pass it to wait_for_answer to keep waiting, or to cancel_question to retract it."
              },
              "handoffAction": {
                "enum": [
                  "cancel_then_ask_in_current_client",
                  "stop"
                ],
                "type": "string",
                "description": "Race-safe directive for updated clients. Takes precedence over nextAction: cancel before asking in the current client, or stop the handoff."
              },
              "policyTimeoutMs": {
                "type": "number",
                "minimum": 0,
                "description": "Policy wait window in milliseconds. Callers must also honor their host deadline."
              },
              "expiresInSeconds": {
                "type": "number",
                "description": "How long the question stays answerable."
              },
              "requesterMayAnswer": {
                "type": "boolean",
                "description": "False when a Team approval route that enforces who answers sends this decision to other people. Do not answer it in the current client or hand it to a local prompt: only the route's approvers can answer it."
              },
              "phoneCallNotPlanned": {
                "type": "object",
                "required": [
                  "reason"
                ],
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Why no call is planned for the user who asked. Known values: agent_stops_waiting_first, outside_calling_hours, daily_call_limit_reached, no_call_minutes_left. Other values may be added; treat one you do not know as no call planned."
                  }
                },
                "description": "Present only when the user who asked has phone calls set up and no call can be planned for this question. If they asked to be called, tell them why; never promise a call. Other reasons no call is planned are in hint only.",
                "additionalProperties": {}
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Ask User a Question; May Call or Ring Their Phone If Unanswered",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "propose_scope",
          "title": "Propose Run Scope",
          "description": "Request agreement on an unresolved or user-requested boundary for this session. Sends a real scope question and returns ratified, answered, contract and enforcement information. Only supported hooks can enforce file paths on path-bearing tool calls; promises are recorded but not enforced. Empty enforces means no automatic boundary checking. A contract never overrides host permissions or authorizes a separate action. The call waits at most 48 seconds; a pending proposal remains answerable after the call returns.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "doneWhen",
              "sessionId"
            ],
            "properties": {
              "doneWhen": {
                "type": "string",
                "maxLength": 300,
                "minLength": 1,
                "description": "What \"finished\" means for this run, one or two lines. Carried for the human to judge against; never enforced automatically."
              },
              "promises": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 10,
                "description": "Boundaries that are not file paths: recipients, channels, spend limits, systems you will not open. For an agent whose work is not code (marketing, sales, support, operations), this is where the boundary goes. Shown to the user labelled \"Promised, not checked\" and recorded in the ledger, but NEVER enforced, because the gate judges a file path and these have none. Do not put these in allowedPaths."
              },
              "agentName": {
                "type": "string",
                "maxLength": 100,
                "description": "Name of the agent asking, format \"{Agent} - {project}\"."
              },
              "machineId": {
                "type": "string",
                "maxLength": 128,
                "description": "Stable machine id, so two machines never collapse into one session."
              },
              "sessionId": {
                "type": "string",
                "maxLength": 128,
                "minLength": 1,
                "description": "Your per-session id, as your client reports it for THIS run. Required, and it is the key the gate reads the contract back by: a value that matches no live session still returns ratified:true and enforces nothing. Never invent one, and never reuse one from another run."
              },
              "timeoutMs": {
                "type": "integer",
                "maximum": 55000,
                "minimum": 1000,
                "description": "How long this call blocks, in milliseconds (up to 55000 is accepted; one call blocks at most 48 seconds)."
              },
              "allowedPaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 40,
                "description": "Globs you intend to change, e.g. [\"src/**\", \"docs/*.md\"]. File paths only: a word that is not a path (\"hubspot\", \"summer-campaign\") matches no file and makes every edit read as out of scope. A bare directory is expanded for you, so \"docs\" also covers \"docs/**\". Omit or leave empty to propose no path restriction, which the user is told plainly."
              },
              "offLimitsPaths": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "maxItems": 40,
                "description": "Globs you promise not to touch, e.g. [\".env*\", \"infra/**\"]. These win wherever they overlap allowedPaths. A leading \"**/\" needs a directory before it, so \"**/.env*\" is expanded for you to also cover a root \".env\"."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "correlationId",
              "ratified",
              "answered",
              "enforces",
              "contract"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "Present only when the scope is not in force, saying what to do instead of proceeding."
              },
              "value": {
                "type": "string",
                "description": "The raw answer behind ratified, \"yes\" or \"no\"."
              },
              "status": {
                "enum": [
                  "answered",
                  "pending",
                  "cancelled",
                  "expired",
                  "missing",
                  "unavailable",
                  "notified",
                  "terminal",
                  "stopped"
                ],
                "type": "string",
                "description": "The underlying scope-question state."
              },
              "answered": {
                "type": "boolean",
                "description": "True when the user responded at all. Answered but not ratified means they declined, so ask what scope they want rather than proceeding."
              },
              "contract": {
                "type": "object",
                "required": [
                  "allowedPaths",
                  "offLimitsPaths",
                  "doneWhen"
                ],
                "properties": {
                  "doneWhen": {
                    "type": "string",
                    "description": "What finished means for this run, as the user saw it."
                  },
                  "promises": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Non-path boundaries as the user saw them. Recorded, never enforced."
                  },
                  "allowedPaths": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Globs the run may change, after expansion. Empty means no path restriction was proposed, which the user was told plainly."
                  },
                  "offLimitsPaths": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Globs the run promised not to touch, after expansion. These win wherever they overlap allowedPaths."
                  }
                },
                "description": "The scope as it is STORED and gated, echoed back so you and the server hold the same contract. Paths are the EXPANDED ones: a bare directory and a leading \"**/\" each gain the variant they would otherwise have missed, so this can contain more entries than you sent. The user was shown the paths you sent, because the added twin says the same thing to a reader; the expansion only changes what the matcher covers, never what it means.",
                "additionalProperties": {}
              },
              "enforces": {
                "type": "array",
                "items": {
                  "enum": [
                    "paths"
                  ],
                  "type": "string"
                },
                "description": "What this contract CONTAINS that can be checked, not a promise about what the gate on this machine will do. An EMPTY array means nothing here is checked automatically: the contract is a recorded promise, and every action stays governed by the permission policy exactly as it was before. Never tell the user a boundary is enforced when this is empty."
              },
              "hookSeen": {
                "type": "boolean",
                "description": "Whether any agent hook has actually reported this sessionId. FALSE means the gate will look this contract up under a key that does not exist, so nothing will be checked no matter what ratified says: fix the session id rather than proceeding as if a scope were in force. ABSENT means the check could not run, which is not evidence either way."
              },
              "ratified": {
                "type": "boolean",
                "description": "True only on an explicit yes. The contract is in force for this session only when this is true; anything else means proceed as if no scope was agreed."
              },
              "nextAction": {
                "enum": [
                  "wait_for_answer",
                  "ask_in_current_client"
                ],
                "type": "string",
                "description": "Keep waiting with the same correlationId while the proposal is pending. Follow handoffAction first when present; a poll ending does not expire or cancel the proposal."
              },
              "correlationId": {
                "type": "string",
                "description": "Id of the scope question. Keep waiting with this id while the question is pending."
              },
              "handoffAction": {
                "enum": [
                  "cancel_then_ask_in_current_client",
                  "stop"
                ],
                "type": "string",
                "description": "Race-safe directive for updated clients. Takes precedence over nextAction."
              },
              "enforcementNote": {
                "type": "string",
                "description": "Present only when there is something true to say about the limits of this contract. Repeat it to the user rather than paraphrasing it."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Propose Run Scope",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "wait_for_answer",
          "title": "Wait for User Answer",
          "description": "Read the answer or current state of an existing Pushary question by its correlationId. Waits up to timeoutMs, capped at 48 seconds; a poll that ends with status pending is not an answer, so keep waiting. Returns answered, the answer when available, status and handoff information. Only pending is a live unanswered question; cancelled, expired, missing and unavailable are terminal states. Does not send another question.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "correlationId"
            ],
            "properties": {
              "timeoutMs": {
                "type": "integer",
                "maximum": 55000,
                "minimum": 1000,
                "description": "How long this one poll blocks, in milliseconds (default 30000; up to 55000 is accepted, and one poll blocks at most 48 seconds). Follow handoffAction when present, otherwise nextAction."
              },
              "correlationId": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "description": "The correlationId from an earlier ask_user response, or the linkedCorrelationId from a send_notification with an embedded askQuestion"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "answered",
              "status"
            ],
            "properties": {
              "hint": {
                "type": "string",
                "description": "What to do next, when there is a next step."
              },
              "note": {
                "type": "string",
                "description": "Free text the user added alongside their answer."
              },
              "value": {
                "type": "string",
                "description": "The user's answer: \"yes\" or \"no\" for confirm, the chosen option for select (or the text they typed instead, when the select was asked with allowOther), the typed text for input. Present only when answered is true."
              },
              "status": {
                "enum": [
                  "answered",
                  "pending",
                  "cancelled",
                  "expired",
                  "missing",
                  "unavailable"
                ],
                "type": "string",
                "description": "The actual question state. Only pending is a live unanswered wait."
              },
              "answered": {
                "type": "boolean",
                "description": "True once the user responded. False means follow handoffAction when present, otherwise nextAction; do not guess that every unanswered state is a timeout."
              },
              "nextAction": {
                "enum": [
                  "wait_for_answer",
                  "ask_in_current_client"
                ],
                "type": "string",
                "description": "Backward-compatible next step for older clients. Follow handoffAction first when present."
              },
              "typedAnswer": {
                "type": "boolean",
                "const": true
              },
              "answerSource": {
                "enum": [
                  "dashboard",
                  "mobile_app",
                  "mobile_background",
                  "decide_page",
                  "live_page",
                  "answer_link",
                  "inbox",
                  "slack",
                  "mac_app",
                  "voice_call",
                  "sandbox"
                ],
                "type": "string",
                "description": "Recorded answering surface, when known. Missing provenance is not proof of a phone answer; sandbox is simulated."
              },
              "handoffAction": {
                "enum": [
                  "cancel_then_ask_in_current_client",
                  "stop"
                ],
                "type": "string",
                "description": "Race-safe directive for updated clients. Takes precedence over nextAction."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Wait for User Answer",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "cancel_question",
          "title": "Cancel Pending Question",
          "description": "Retract a pending question that is no longer needed or is moving to the current client. Returns cancelled:true only when a pending question was removed. False may mean it was already answered, expired, missing or unavailable. An unavailable state includes handoffAction:stop because cancellation could not safely inspect or fence the question. Does not retract an answer already recorded.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "correlationId"
            ],
            "properties": {
              "handoff": {
                "type": "boolean",
                "description": "True when you are cancelling because you are about to ask the same question in the current client. For the next minute the Pushary hook then lets your own question tool through instead of sending it back to the phone. Set automatically whenever a live question is cancelled."
              },
              "correlationId": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "description": "The correlationId of the pending question to cancel, as returned by ask_user or send_notification"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "cancelled",
              "correlationId"
            ],
            "properties": {
              "hint": {
                "type": "string",
                "description": "What to do when cancellation could not safely inspect the question."
              },
              "status": {
                "type": "string",
                "const": "unavailable",
                "description": "Present when Pushary could not safely read or fence the question state."
              },
              "cancelled": {
                "type": "boolean",
                "description": "True when a still-pending question was removed. False when it was already terminal, missing, or unavailable; inspect status and handoffAction when present."
              },
              "askHandoff": {
                "type": "boolean",
                "description": "True when the session was marked as handing off to the current client, so the hook will not re-ask on the phone for the next minute."
              },
              "correlationId": {
                "type": "string",
                "description": "The question this result refers to, echoed back."
              },
              "handoffAction": {
                "type": "string",
                "const": "stop",
                "description": "Stop rather than opening another answer surface when the question state is unavailable."
              },
              "cancelledByThisCall": {
                "type": "boolean",
                "description": "True only when this call moved the question from pending to cancelled. False when it was already cancelled, by an earlier call or another surface, or was never pending. Use it, not cancelled, to decide whether this call won a race to settle the question."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Cancel Pending Question",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "site-index",
          "uri": "https://pushary.com/llms.txt",
          "mimeType": "text/markdown",
          "description": "What Pushary is, what it is not, the questions it answers, and a linked map of every page on pushary.com. Start here."
        },
        {
          "name": "documentation",
          "uri": "https://pushary.com/llms-full.txt",
          "mimeType": "text/markdown",
          "description": "Every Pushary documentation page concatenated into one Markdown file: quickstart, API keys, per-agent setup guides, permission policies, the audit trail, and the embed integration guide."
        },
        {
          "name": "openapi",
          "uri": "https://pushary.com/openapi.json",
          "mimeType": "application/json",
          "description": "The full REST surface: decisions, authorization, end-user enrollment, per-end-user keys, notifications, subscribers, campaigns, templates and flows. Typed schemas and a unique operationId per operation."
        },
        {
          "name": "quickstart",
          "uri": "https://pushary.com/docs/agents/quickstart.md",
          "mimeType": "text/markdown",
          "description": "The one-command setup that wires the MCP server, permission hooks and event tracking into an agent, and what to check when it does not connect."
        },
        {
          "name": "tool-reference",
          "uri": "https://pushary.com/docs/agents/reference/tools.md",
          "mimeType": "text/markdown",
          "description": "What every tool on this server does, what it takes, and what it returns: ask_user, wait_for_answer, send_notification, cancel_question, and the Partner decision tools."
        }
      ],
      "prompts": []
    },
    "instructions": "Honor authorization already granted by the user and the host permission policy. Use ask_user only for an unresolved decision or missing input; a multi-step task alone needs no extra approval. When the app you run in also has its own question tool, use ask_user instead if the user asked to be reached on another device or through Pushary, said they are stepping away, or the work is long-running or unattended. Ask once on one channel. Follow handoffAction when present, otherwise nextAction; silence is never consent. A poll ending does not expire a question. While pending, keep waiting with the same correlationId; never cancel merely because no answer arrived during a poll. Cancel a live question before moving it to the current client. If cancellation returns handoffAction \"stop\", stop. Otherwise, if cancellation returns false, poll once for 1 second and honor the answer that won the race. Use send_notification for a requested update or a meaningful unattended result, such as a finished task, not duplicate reports. Ask questions with ask_user, not with send_notification context.askQuestion. A question asked through a connector, by signing in or with a connector key, closes 10 minutes after it is sent; one asked with any other key stays open until answered or cancelled. If you would take your default without asking at all, do not ask: take it and list that decision in your final message. This never covers an irreversible step, a deploy or publish, anything sent outside the team, spending money or a decision outside your authority that the user has not already approved: those still need a question before you act; after a Pushary hook approved that exact tool use, do not ask about it again. Running the same command later is a new step. When the requested work is complete, report it and stop: do not ask what to do next or offer more work, through ask_user or context.askQuestion, unless the user asked you to. Work blocked on a choice only the user can make is not complete; ask that choice. Pass agentName as the actual host and task. Pushary skills guide use; tools do not override host approvals."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}