Publish a BioFlow page
Take the draft live, now or at a set time, through BioFlow's two-step publish. The first call only previews; the user's confirmation is what commits.
Connecting and calling the tools
Every tool in this skill comes from the bioflow MCP server, the BioFlow connector, and is written here as bioflow:<tool>.
- Tools listed by name: call them directly, for example
bioflow:page.list. - Only
bioflow:search_toolsandbioflow:execute_typescriptlisted (Code Mode, the default): callbioflow:search_toolsfirst, then call each tool insidebioflow:execute_typescriptasexternal_plus the tool name with dots swapped for underscores (for exampleexternal_page_listforbioflow:page.list); the program mustreturnits result. Scopes, confirmations and gates are identical on both surfaces. - "Tool not found": switch to the Code Mode route instead of retrying the direct call. If
bioflow:search_toolsdoes not return the tool either, its OAuth scope was not granted; the user reconnects BioFlow and approves that scope. - No
bioflowtools at all: BioFlow is not connected yet. Install the BioFlow power, which adds the server; it signs in with OAuth on first use.
Tools you will use
bioflow:page.list: find the page and its public URL.bioflow:page.get: the draft and published summaries, so you can describe what differs.bioflow:page.publish: publish the draft now. Two-step: a call withoutconfirmTokenreturns a preview of exactly what would go live plus a short-livedconfirmTokenand publishes nothing; a second call carrying that token commits.bioflow:page.schedule_publish: schedule the draft to publish atstartsAt, an ISO 8601 timestamp in the future. Same two-step contract: the first call schedules nothing and returns a preview andconfirmToken; the second call carries the samestartsAtplus the token.
Workflow
- Call
bioflow:page.listand confirm which page the user means. - Call
bioflow:page.getand summarize what is in the draft but not yet live. - For a scheduled publish, resolve the time to a full date and time in the user's timezone, state it, and convert it to an ISO 8601
startsAt. - Call
bioflow:page.publishorbioflow:page.schedule_publishwithout aconfirmToken. Nothing goes live on this call. - Show the user the preview the tool returned, in plain words: which blocks are added, changed, or removed, and the page title. For a schedule, repeat the time.
- Ask for an explicit yes. Do not treat silence, "ok, looks fine", or an earlier request as confirmation.
- After a clear yes, call the same tool again with the
confirmToken. Report the result and the page's public URL.
Rules
- The preview is the expected first response, not a failure. Never say "publish did nothing" after step 4.
- Never pass a
confirmTokenthe user has not approved in this conversation, and never reuse a token. - The token expires after 10 minutes. An expired, malformed, or mismatched token is refused with
CONFIRM_TOKEN_INVALID, and a draft change in between is refused withSTALE_SNAPSHOT. In either case start again at step 4 and show the new preview. - On
DANGEROUS_OPS_DISABLED, publishing is turned off for the workspace. Give the user the settings link from the response (Settings, Connected AI apps) and stop. Only the user can turn it on. - If the publish tools are missing, the user did not grant the
publishscope. Say so and tell them to reconnect with it.
