fiveminutebrief.ai

{
  "name": "list_public_topics",
  "kind": "answer",
  "impl": "imperative",
  "description": "List 5m and Public Topics: name, id, topicKind, follower count, card take. When signed in: isFollowing and follow slots. No private Topics.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "get_public_topic",
  "kind": "answer",
  "impl": "imperative",
  "description": "Topic metadata: description, cover, Brief/preview availability, archive + podcast access. Private Topics: owner only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_latest_brief",
  "kind": "answer",
  "impl": "imperative",
  "description": "Full Brief digest + URL. 5m: current day for everyone; pass dateKey only if you follow (archive). Public: full only while following — otherwise use get_public_topic_preview. Private custom: owner only. No brief.debug.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "dateKey": {
        "type": "string",
        "description": "Archive day (YYYY-MM-DD). Followers / private owners only; guests get current day."
      },
      "briefId": {
        "type": "string",
        "description": "Specific Brief id. Followers / private owners only."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_public_topic_preview",
  "kind": "answer",
  "impl": "imperative",
  "description": "Preview a user-made Public Topic (not 5m): takeaway, top story titles, source count, follow CTA. Not the full Brief.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_brief_newsletter",
  "kind": "answer",
  "impl": "imperative",
  "description": "Shareable copy plus canonical URL. Full copy when entitled (5m current day, follow, or private owner). Preview copy if you are not following a Public Topic.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "dateKey": {
        "type": "string",
        "description": "Archive day (YYYY-MM-DD). Followers / private owners only; guests get current day."
      },
      "briefId": {
        "type": "string",
        "description": "Specific Brief id. Followers / private owners only."
      }
    }
  },
  "page": "/"
}

{
  "name": "copy_share_link",
  "kind": "act",
  "impl": "imperative",
  "description": "Return the canonical Topic URL to share. Read-only; does not send email.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "explain_fiveminutebrief",
  "kind": "act",
  "impl": "imperative",
  "description": "Explain FiveMinuteBrief (5m, Public, and Custom Topics) and return /public-topics, /plans, and /signup URLs.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "start_signup",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate this tab to the signup form. Does not fill or submit credentials. On /signup the form is a separate declarative signup tool.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "start_login",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate this tab to the login form. Does not fill or submit credentials. On /login the form is a separate declarative login tool.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "get_podcast_show",
  "kind": "answer",
  "impl": "imperative",
  "description": "Podcast RSS + per-app launch URLs (including Apple). 5m guests/non-followers (including admin who is not following): public ad show, no ?code=. Followers and private-Topic owners: private ad-free ?code= feed. Public Topic not followed: follow required (no code). Does not open an app (use open_podcast_app).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_podcast_episode",
  "kind": "answer",
  "impl": "imperative",
  "description": "Latest episode this viewer may hear: title, date, duration, listen URL, enclosure. 5m guests get ?variant=public (ad). Followers/owners get the private file. Not the archive.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "list_podcast_apps",
  "kind": "answer",
  "impl": "imperative",
  "description": "Podcast app buttons for a Topic (same set as Listen anywhere). Without topicId: the catalog of app ids. Private feeds: Apple, Overcast, Pocket Casts, Castro, Podcast Addict only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "open_podcast_app",
  "kind": "act",
  "impl": "imperative",
  "description": "Open a Topic’s show in a podcast app (topicId + app id). Opens a new tab/deep link; does not replace the page. Guests cannot open a private feed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "app": {
        "type": "string",
        "enum": [
          "apple",
          "spotify",
          "overcast",
          "pocketcasts",
          "amazon",
          "castro",
          "goodpods",
          "metacast",
          "castbox",
          "podcastaddict",
          "playerfm",
          "deezer"
        ],
        "description": "Podcast app id from list_podcast_apps (apple, spotify, overcast, …)."
      }
    },
    "required": [
      "app"
    ]
  },
  "page": "/"
}

{
  "name": "list_my_topics",
  "kind": "answer",
  "impl": "imperative",
  "description": "Dashboard Topics you own or follow (private custom included): generation status and latest card take. Sign-in required.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "follow_public_topic",
  "kind": "act",
  "impl": "imperative",
  "description": "Follow a 5m or Public Topic (uses a follow slot). Guests must start_login. Slot limits return PLAN_LIMIT. Confirms in-page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "unfollow_public_topic",
  "kind": "act",
  "impl": "imperative",
  "description": "Unfollow a 5m or Public Topic. A Public Topic creator who unfollows gets preview only. Confirms in-page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "create_topic",
  "kind": "act",
  "impl": "imperative",
  "description": "Create a private custom Topic via the API (paid plan + 1 credit). Queues the first Brief; poll get_topic_generation_status. Free / no-credit fail like the app. Confirms in-page. Does not fill the /topics/new form (that is start_create_topic).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "description": "Topic name (required). Same field as the Create Topic form."
      },
      "whatToCover": {
        "type": "string",
        "description": "Optional: what to cover. Description is generated from the first Brief."
      },
      "voiceId": {
        "type": "string",
        "description": "Optional podcast voice id. Defaults to the site default."
      }
    },
    "required": [
      "name"
    ]
  },
  "page": "/"
}

{
  "name": "get_topic_generation_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "queued / generating / ready / failed / sparse for a Topic’s first Brief. Poll after create_topic. Sign-in required.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "retry_first_brief",
  "kind": "act",
  "impl": "imperative",
  "description": "Re-enqueue first Brief (same credit/lock rules as topic-page Try again). Does not wait. Paid + credit. Confirms in-page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      }
    }
  },
  "page": "/"
}

{
  "name": "open_plans",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate this tab to /plans. Does not open Stripe checkout.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "highlight_brief_section",
  "kind": "act",
  "impl": "imperative",
  "description": "Paint Top Stories, Quick Hits, What’s Next, or Today’s Take on the live Brief; dim other sections. Optional note. Preview viewers cannot paint What’s Next.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "section": {
        "type": "string",
        "enum": [
          "topStories",
          "quickHits",
          "whatsNext",
          "todaysTake"
        ],
        "description": "topStories | quickHits | whatsNext | todaysTake"
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    },
    "required": [
      "section"
    ]
  },
  "page": "/"
}

{
  "name": "highlight_stories",
  "kind": "act",
  "impl": "imperative",
  "description": "Outline 1–3 story cards by stable id (topChanges:0) or title. Dims siblings. Public preview: on-screen titles only. After pointing at a story, use highlight_sources for its publishers, then clear_highlights to restore the page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "stories": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "1–3 story ids or titles from get_latest_brief / preview."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    },
    "required": [
      "stories"
    ]
  },
  "page": "/"
}

{
  "name": "highlight_sources",
  "kind": "act",
  "impl": "imperative",
  "description": "Glow publisher chips for a story (identity, not a URL dump). Preview: primary publisher of an on-screen story only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "story": {
        "type": "string",
        "description": "Story id or title. Defaults to the lead Top Story."
      },
      "sourceUrls": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Optional publisher names or source URLs. Defaults to that story’s sources."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    }
  },
  "page": "/"
}

{
  "name": "highlight_coverage_note",
  "kind": "act",
  "impl": "imperative",
  "description": "Light the sparse / special-single / expanding-coverage banner when explaining a thin day.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    }
  },
  "page": "/"
}

{
  "name": "highlight_podcast_moment",
  "kind": "act",
  "impl": "imperative",
  "description": "Jump the in-page player (script marker or estimate) and highlight the matching story when audio exists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "story": {
        "type": "string",
        "description": "Story id or title to highlight and seek toward."
      },
      "seekSec": {
        "type": "number",
        "description": "Optional exact timestamp in seconds."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    }
  },
  "page": "/"
}

{
  "name": "highlight_topic_card",
  "kind": "act",
  "impl": "imperative",
  "description": "Scroll to and outline one Topic card on the catalog or dashboard (5m, follow CTA, or queued state).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    },
    "required": [
      "topicId"
    ]
  },
  "page": "/"
}

{
  "name": "highlight_plan_gate",
  "kind": "act",
  "impl": "imperative",
  "description": "Outline credits, follow, or upgrade after create_topic / follow_public_topic was refused.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "gate": {
        "type": "string",
        "enum": [
          "credits",
          "follow",
          "upgrade"
        ],
        "description": "Which refused control to point at."
      },
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "note": {
        "type": "string",
        "description": "Optional short note shown as a sticky chip on the page."
      }
    },
    "required": [
      "gate"
    ]
  },
  "page": "/"
}

{
  "name": "clear_highlights",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove agent paint and notes. Restores the page.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "ask_this_brief",
  "kind": "act",
  "impl": "imperative",
  "description": "Ask a question about the entitled Brief (5m current day for guests; Public preview only until follow; archive if canReadArchive). Returns a grounded answer + citations, then highlights matching stories/sources. Not a Brief digest (use get_latest_brief). No web search, no new Brief.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topicId": {
        "type": "string",
        "description": "Topic id (e.g. topic:uuid). Defaults to the Topic on this page."
      },
      "question": {
        "type": "string",
        "description": "Question about this Brief’s clustered stories and cited sources."
      },
      "dateKey": {
        "type": "string",
        "description": "Archive day (YYYY-MM-DD). Followers / private owners only."
      },
      "briefId": {
        "type": "string",
        "description": "Specific Brief id. Followers / private owners only."
      }
    },
    "required": [
      "question"
    ]
  },
  "page": "/"
}

{
  "name": "signup",
  "kind": "act",
  "impl": "declarative",
  "description": "Fill the signup form on this page. Does not submit credentials; the user must click Create account. Distinct from start_signup, which only navigates here.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "firstName": {
        "type": "string",
        "description": "First name"
      },
      "lastName": {
        "type": "string",
        "description": "Last name (optional)"
      },
      "email": {
        "type": "string",
        "description": "Email"
      },
      "password": {
        "type": "string",
        "description": "Password (min 8 characters)"
      }
    },
    "required": [
      "firstName"
    ]
  },
  "page": "/signup"
}

{
  "name": "login",
  "kind": "act",
  "impl": "declarative",
  "description": "Fill the login form on this page. Does not submit credentials; the user must click Log in. Distinct from start_login, which only navigates here.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "email": {
        "type": "string",
        "description": "Email"
      },
      "password": {
        "type": "string",
        "description": "Password"
      }
    }
  },
  "page": "/login"
}