tv.fangorn.network

propose

Ask the viewer something on the screen they are already looking at. A card appears over the TV with your question and your buttons. Use it before doing anything they did not ask for: retuning what they are watching, saving a channel, changing direction. This is the consent step WebMCP has no primitive for, and it only works because the tools are running in the page the person is looking at. Three outcomes, and they are NOT interchangeable: an `answer` is a decision; `answer: null` with `settled: true` means dismissed or expired, which is a NO; and `pending: true` means the card is still on screen and they have not answered yet — that is not a no, and acting on it as one discards a decision they are still making. When you get a `ticket`, call this tool again with it (and nothing else) to keep waiting. The card outlives any single call, so a slow yes is never lost.

Input schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Short, answerable by pressing a button. Say what you would do and why."
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The buttons (default Yes / No). Keep them to two or three."
    },
    "seconds": {
      "type": "number",
      "description": "How long the card STANDS on screen before it expires (default 60, max 300)"
    },
    "wait": {
      "type": "number",
      "description": "How long THIS call blocks before handing back a ticket (default 45, max 110). Keep it under your transport's timeout."
    },
    "ticket": {
      "type": "string",
      "description": "Resume waiting on a card you already posted, from a previous `pending` reply. Send this alone."
    }
  }
}