{
  "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": "bisque.cloud",
    "site": "bisque.cloud",
    "addresses": [
      {
        "address": "35.219.200.4",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 15169,
          "name": "GOOGLE - Google LLC",
          "prefix": "35.216.0.0/14",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "35.219.200.4"
        ],
        "first_seen": "2026-11-22T07:26:02.262Z",
        "last_seen": "2026-11-22T07:26:02.262Z",
        "checks": 1
      }
    ],
    "hosting": [],
    "software": [
      {
        "value": "Envoy",
        "evidence": "Server header \"envoy\""
      }
    ],
    "server_info": {
      "name": "bisque-presentations",
      "version": "1.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "envoy"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "cloud.bisque",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "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": "5235",
    "server_name": "cloud.bisque/presentations",
    "url": "https://bisque.cloud/presentations/mcp",
    "host": "bisque.cloud",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T07:26:02.262Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "8b058ac3d8274a397449ad3eb08de08028be45240a0dc9de23830fad5687b933",
    "first_listed_at": "2026-11-21T06:30:03.424Z",
    "created_at": "2026-11-21T05:05:04.177Z",
    "resolved_addresses": [
      "35.219.200.4"
    ]
  },
  "server": {
    "name": "cloud.bisque/presentations",
    "title": "Bisque Presentations",
    "description": "Create narrated presentations from HTML, poll build status, list them, read one back as text.",
    "version": "1.0.1",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://bisque.today/docs/mcp",
    "published_at": "2026-08-31T18:06:14.489Z",
    "updated_at": "2026-08-31T18:06:14.489Z",
    "first_seen": "2026-11-21T05:05:03.608Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T14:57:08.441Z"
  },
  "operator": {
    "key": "bisque.cloud",
    "name": "bisque.cloud",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 743,
    "first_check_in_window": "2026-11-21T06:30:03.424Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "8b058ac3d8274a397449ad3eb08de08028be45240a0dc9de23830fad5687b933",
    "tools": 26,
    "resources": 2,
    "prompts": 1,
    "first_seen": "2026-11-21T06:30:04.205Z",
    "tool_names": [
      "get_presentation_spec",
      "create_presentation",
      "publish_narrated_presentation",
      "get_presentation_status",
      "list_presentations",
      "get_presentation_analytics",
      "get_presentation_context",
      "get_presentation_source",
      "update_channel",
      "create_artifact",
      "list_artifacts",
      "get_artifact",
      "update_artifact",
      "share_artifact",
      "delete_artifact",
      "read_board",
      "edit_board",
      "read_artifact_analytics",
      "read_artifact_results",
      "pin_artifact",
      "unpin_artifact",
      "list_artifact_threads",
      "get_artifact_thread",
      "create_artifact_thread",
      "reply_to_artifact_thread",
      "resolve_artifact_thread"
    ],
    "declared": {
      "tools": [
        {
          "name": "get_presentation_spec",
          "title": "Get the authoring spec",
          "description": "Fetch the html-presentation/v1 authoring contract: document structure, the dual landscape/vertical layout rule, and the narration markup that makes slides speak. Call this BEFORE authoring for create_presentation — documents written without it publish with missing audio.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "format",
              "spec"
            ],
            "properties": {
              "spec": {
                "type": "string",
                "description": "The full authoring recipe + format contract, markdown."
              },
              "format": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get the authoring spec",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_presentation",
          "title": "Create narrated presentation",
          "description": "Generate a narrated presentation from an html-presentation/v1 document. BEFORE authoring, call get_presentation_spec and follow it exactly — slides without its narration markup publish SILENT. Returns a presentationId and the watch URL. Narration runs in the background and the inline player tracks it on its own, so reply to the user as soon as this returns and do not call get_presentation_status unless the user asks whether it is done.",
          "inputSchema": {
            "type": "object",
            "required": [
              "indexHtml"
            ],
            "properties": {
              "slug": {
                "type": "string",
                "description": "URL slug; defaults to a slugified title."
              },
              "audio": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Optional. One entry per slide YOU narrated, from the JSON `bisque-voice` prints — word timings, duration, size and digest. Send it and your audio is used (free, unlimited, any OS); leave it out and the server narrates. The response says how many slides speak, and names any that published silent."
              },
              "title": {
                "type": "string",
                "maxLength": 200,
                "description": "Display title for the watch page and listings. Omit to use the title parsed from the document."
              },
              "assets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "path",
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "Public https source to fetch the bytes from (e.g. a fonts.gstatic.com woff2 URL, an image URL)."
                    },
                    "path": {
                      "type": "string",
                      "description": "Bundle-relative path your HTML references, e.g. assets/fonts/inter-600.woff2. Must start with assets/."
                    },
                    "sha256": {
                      "type": "string",
                      "pattern": "^sha256:[a-fA-F0-9]{64}$",
                      "description": "Optional integrity pin — the create fails if the fetched bytes hash differently."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 20,
                "description": "Files the document references relative to itself — fonts, images, Lottie/Rive animations, sound-effect audio, video clips. The SERVER fetches each https url at create time and stores it in the bundle, so reference `assets/...` paths in your HTML and list the sources here instead of inlining base64. 10MB per asset, 30MB total."
              },
              "dryRun": {
                "type": "boolean",
                "default": false,
                "description": "Sandbox: run every check a real create runs (format, slug and org conflicts, tier cap, credit preflight) and write nothing. The reply has status \"validated\" and the webUrl a real create would publish at. Use it to test an integration without touching the channel."
              },
              "handle": {
                "type": "string",
                "description": "Publish under a specific channel handle you own."
              },
              "voiceId": {
                "type": "string",
                "description": "Narration voice. ElevenLabs: a bare id or cloud:<id>. Self-hosted Kokoro: kokoro:<id> (e.g. kokoro:af_heart); local:<id> is accepted as a synonym. Omit to use the voice saved on the account (bisque.cloud/account), falling back to the server default."
              },
              "designMd": {
                "type": "string",
                "description": "Design frontmatter mapped to theme tokens."
              },
              "madeWith": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 80
                },
                "maxItems": 8,
                "description": "Credit the models that made this: the model you are running as, and the narration engine or voice service if you know it — e.g. [\"Claude Opus 5\", \"Kokoro af_heart\"]. Shown to viewers in the watch page's ⋯ menu. Send it on every create; omitting it keeps whatever a previous publish recorded."
              },
              "contextMd": {
                "type": "string",
                "description": "Shared-with-viewer context.md."
              },
              "indexHtml": {
                "type": "string",
                "maxLength": 4194304,
                "minLength": 1,
                "description": "Full html-presentation/v1 document (the presentation-format meta gate applies)."
              },
              "visibility": {
                "enum": [
                  "private",
                  "unlisted",
                  "public"
                ],
                "type": "string",
                "default": "unlisted",
                "description": "unlisted (the default) is shareable by link and plays in chat-embedded players; private requires the owner to sign in, so an inline chat player shows a sign-in wall instead of playing — choose private only when the user asked for it."
              },
              "speechSpeed": {
                "type": "number",
                "description": "Narration speed multiplier passed to the voice. Omit for the server default."
              },
              "presentationId": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "Stable id for idempotent re-creates; defaults to slug-<hash(userId:slug)>."
              },
              "voiceStability": {
                "type": "number",
                "description": "Voice stability setting passed to the narration engine. Omit for the server default."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "webUrl",
              "status",
              "statusUrl",
              "narration"
            ],
            "properties": {
              "status": {
                "enum": [
                  "ready",
                  "queued"
                ],
                "type": "string",
                "description": "ready = nothing needed narration; queued = narration runs in the background — poll get_presentation_status."
              },
              "webUrl": {
                "type": "string",
                "description": "Shareable watch URL (live once status is ready)."
              },
              "narration": {
                "type": "object",
                "required": [
                  "narratedSlides",
                  "totalSlides",
                  "estimatedChars"
                ],
                "properties": {
                  "totalSlides": {
                    "type": "integer"
                  },
                  "estimatedChars": {
                    "type": "integer"
                  },
                  "narratedSlides": {
                    "type": "integer"
                  }
                }
              },
              "statusUrl": {
                "type": "string"
              },
              "presentationId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Create narrated presentation",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "publish_narrated_presentation",
          "title": "Deprecated — use create_presentation with `audio`",
          "description": "DEPRECATED: call create_presentation with an `audio` array instead — it is the same thing in one call, and the slides are viewable while the narration lands. Publish an html-presentation/v1 document using audio YOU synthesized locally (e.g. with `bisque-voice`) — free, unlimited, and works on macOS, Linux and Windows. Send each narrated slide's word timings and MP3 metadata; the server assembles presentation.json (recomputing cues from your narration markers) and returns one upload URL per MP3. Then PUT each file and POST the returned completeUrl with the returned `files` array. RE-PUBLISHING: `audio` is optional — any narrated slide you omit reuses the audio from the last publish whenever its narration text and speechSpeed are unchanged, so an HTML-only edit needs no synthesis at all. The response reports `reused`, `synthesized`, and `staleSlides` (narrated slides whose text changed and have no audio — synthesize exactly those and publish again). Use create_presentation instead to have the server narrate.",
          "inputSchema": {
            "type": "object",
            "required": [
              "indexHtml"
            ],
            "properties": {
              "slug": {
                "type": "string",
                "description": "URL slug; defaults to a slugified title."
              },
              "audio": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "words",
                    "durationMs",
                    "size",
                    "hash"
                  ],
                  "properties": {
                    "hash": {
                      "type": "string",
                      "pattern": "^sha256:[a-fA-F0-9]{64}$",
                      "description": "sha256:<64 hex> digest of the MP3 bytes."
                    },
                    "size": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "Encoded MP3 byte count."
                    },
                    "exact": {
                      "type": "boolean",
                      "description": "Pass through bisque-voice's `exact`. False means timings were distributed proportionally; reported back as a warning."
                    },
                    "speed": {
                      "type": "number"
                    },
                    "voice": {
                      "type": "string"
                    },
                    "words": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "word",
                          "start",
                          "end"
                        ],
                        "properties": {
                          "end": {
                            "type": "number"
                          },
                          "word": {
                            "type": "string"
                          },
                          "start": {
                            "type": "number"
                          }
                        },
                        "additionalProperties": false
                      },
                      "description": "Word timings in SECONDS, 1:1 with the narration's whitespace tokens. Rejected if the count differs — cue markers index this array by position, so a mismatch silently misplaces every later cue."
                    },
                    "chunks": {
                      "type": "integer"
                    },
                    "slideKey": {
                      "type": "string",
                      "description": "Manifest slide key, e.g. slide-00. Use this or slideIndex."
                    },
                    "durationMs": {
                      "type": "integer",
                      "minimum": 1,
                      "description": "Audio duration in whole milliseconds."
                    },
                    "slideIndex": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "0-based index of the slide in the document. Use this or slideKey."
                    },
                    "contentType": {
                      "type": "string",
                      "const": "audio/mpeg",
                      "description": "Rejected unless audio/mpeg — a WAV would publish mislabelled."
                    }
                  },
                  "additionalProperties": false
                },
                "description": "One entry per slide you synthesized, from the JSON `bisque-voice` prints on stdout. `words`, `durationMs`, `size` and `hash` map across verbatim. Optional: omit a slide (or the whole array) and its audio carries forward from the previous publish if the narration text is unchanged — otherwise that slide publishes silent and is listed in `staleSlides`. A FIRST publish with nothing to carry forward is rejected."
              },
              "title": {
                "type": "string",
                "maxLength": 200,
                "description": "Display title for the watch page and listings. Omit to use the title parsed from the document."
              },
              "assets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "path",
                    "size",
                    "hash"
                  ],
                  "properties": {
                    "hash": {
                      "type": "string",
                      "description": "sha256:<64 hex chars> of those bytes, prefix included."
                    },
                    "path": {
                      "type": "string",
                      "description": "Bundle-relative path, e.g. assets/fonts/inter.woff2. Must start with `assets/`; no absolute paths and no `..` segments."
                    },
                    "size": {
                      "type": "integer",
                      "minimum": 0,
                      "description": "Byte length of the file you are about to upload."
                    },
                    "contentType": {
                      "type": "string",
                      "description": "Ignored. The server derives the content type from the file extension so one map decides how every asset is served."
                    }
                  },
                  "additionalProperties": false
                },
                "description": "Files the document references relative to itself — fonts, images, SVG, Lottie, Rive, bundled audio cues. html-presentation/v1 requires these to be self-hosted, so a presentation that renders locally is broken once published unless they travel with it. Each gets an upload URL back alongside the MP3s; PUT them the same way. Paths must be under `assets/` — the server owns index.html, presentation.json and context.md, and the manifest owns audio/. Omit for a presentation that references nothing."
              },
              "handle": {
                "type": "string",
                "description": "Publish under a specific channel handle you own."
              },
              "voiceId": {
                "type": "string",
                "description": "Records what actually spoke, e.g. kokoro:af_heart for a locally synthesized Kokoro voice. No audio is generated server-side."
              },
              "designMd": {
                "type": "string",
                "description": "Design frontmatter mapped to theme tokens."
              },
              "madeWith": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 80
                },
                "maxItems": 8,
                "description": "Credit the models that made this: the model you are running as, and the engine that synthesized the audio you are uploading — e.g. [\"Claude Opus 5\", \"Kokoro af_heart\"]. Shown to viewers in the watch page's ⋯ menu. Send it on every publish; omitting it keeps whatever a previous publish recorded."
              },
              "contextMd": {
                "type": "string",
                "description": "Shared-with-viewer context.md."
              },
              "indexHtml": {
                "type": "string",
                "maxLength": 4194304,
                "minLength": 1,
                "description": "Full html-presentation/v1 document (the presentation-format meta gate applies)."
              },
              "visibility": {
                "enum": [
                  "private",
                  "unlisted",
                  "public"
                ],
                "type": "string",
                "default": "unlisted",
                "description": "unlisted (the default) is shareable by link and plays in chat-embedded players; private requires the owner to sign in, so an inline chat player shows a sign-in wall instead of playing — choose private only when the user asked for it."
              },
              "speechSpeed": {
                "type": "number",
                "description": "Must match the speed you synthesized at — it is part of the audio cache key, so changing it on a re-publish makes every slide stale instead of carrying forward."
              },
              "presentationId": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "Stable id for idempotent re-publishes; defaults to slug-<hash(userId:slug)>."
              },
              "voiceStability": {
                "type": "number",
                "description": "Records the stability setting you synthesized at. No audio is generated server-side."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "webUrl",
              "uploadUrls",
              "completeUrl",
              "publishId",
              "files",
              "reused",
              "synthesized",
              "staleSlides",
              "warnings"
            ],
            "properties": {
              "files": {
                "type": "array",
                "items": {
                  "type": "object"
                },
                "description": "Echo back verbatim as the complete call's `files`."
              },
              "reused": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Slide keys whose audio carried forward — no upload."
              },
              "webUrl": {
                "type": "string",
                "description": "Shareable watch URL."
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "publishId": {
                "type": "string"
              },
              "uploadUrls": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "path",
                    "url",
                    "method",
                    "headers"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "path": {
                      "type": "string"
                    },
                    "method": {
                      "enum": [
                        "PUT"
                      ],
                      "type": "string"
                    },
                    "headers": {
                      "type": "object"
                    }
                  }
                },
                "description": "One pre-signed PUT per file to upload."
              },
              "completeUrl": {
                "type": "string",
                "description": "POST here after every PUT, echoing `files` back verbatim."
              },
              "staleSlides": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Narrated slide keys that will publish SILENT — synthesize exactly these and publish again."
              },
              "synthesized": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Slide keys this request supplied audio for."
              },
              "presentationId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Publish a presentation you narrated yourself",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_presentation_status",
          "title": "Get presentation status",
          "description": "Fetch the build state and result URL for a presentationId.",
          "inputSchema": {
            "type": "object",
            "required": [
              "presentationId"
            ],
            "properties": {
              "presentationId": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "The presentationId returned by create_presentation or publish_narrated_presentation."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "publishStatus",
              "ready"
            ],
            "properties": {
              "ready": {
                "type": "boolean",
                "description": "True once the presentation is viewable."
              },
              "webUrl": {
                "type": "string",
                "description": "Shareable watch URL."
              },
              "narration": {
                "type": "object",
                "description": "Narration progress: status (complete | partial | failed | waiting | …) and per-slide errors when partial/failed. waiting = the rest of the audio is still coming; the slides are viewable and it lands without another call."
              },
              "visibility": {
                "type": "string"
              },
              "keptVersion": {
                "type": "integer",
                "description": "Set when the latest republish failed (publishStatus failed) and the presentation still plays this earlier version at webUrl."
              },
              "publishStatus": {
                "type": "string"
              },
              "presentationId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get presentation status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_presentations",
          "title": "List your presentations",
          "description": "List the authenticated user's presentations, newest first. One call returns at most `limit` of them. A non-null `nextCursor` in the response means more presentations remain: call again with `cursor` set to that value to get the page after this one, and keep going until `nextCursor` is null.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "type": "integer",
                "default": 50,
                "maximum": 100,
                "minimum": 1,
                "description": "Maximum number of presentations to return per page."
              },
              "cursor": {
                "type": "string",
                "description": "The `nextCursor` from a previous call, to read the page after that one. Omit it to start at the newest presentation."
              },
              "visibility": {
                "enum": [
                  "private",
                  "unlisted",
                  "public"
                ],
                "type": "string",
                "description": "Return only presentations with this visibility. Omit to return every one of them."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentations",
              "nextCursor"
            ],
            "properties": {
              "nextCursor": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Pass this back as `cursor` for the next page. Null when this page is the last one."
              },
              "presentations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "presentationId",
                    "title",
                    "slug",
                    "visibility",
                    "publishStatus",
                    "webUrl"
                  ],
                  "properties": {
                    "slug": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "webUrl": {
                      "type": "string"
                    },
                    "createdAt": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "ISO 8601, null when unknown."
                    },
                    "visibility": {
                      "type": "string"
                    },
                    "publishStatus": {
                      "type": "string"
                    },
                    "presentationId": {
                      "type": "string"
                    }
                  }
                },
                "description": "Newest first."
              }
            }
          },
          "annotations": {
            "title": "List your presentations",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_presentation_analytics",
          "title": "Get presentation analytics",
          "description": "Watch analytics for one of your presentations: views, likes, completion rate, per-slide retention funnel, traffic sources, distinct signed-in/anonymous viewers, and organization email domains (personal providers filtered). Lets an agent read how its own published briefings performed.",
          "inputSchema": {
            "type": "object",
            "required": [
              "presentationId"
            ],
            "properties": {
              "presentationId": {
                "type": "string",
                "maxLength": 120,
                "minLength": 1,
                "description": "The presentationId whose view counts and survey responses you want."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "title",
              "slug",
              "viewCount",
              "likeCount",
              "completedCount",
              "uniqueViewers",
              "anonViewers",
              "completionRate",
              "slideReach",
              "sources",
              "orgDomains"
            ],
            "properties": {
              "slug": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "webUrl": {
                "type": "string"
              },
              "sources": {
                "type": "object",
                "description": "Traffic source → view count."
              },
              "likeCount": {
                "type": "integer"
              },
              "viewCount": {
                "type": "integer"
              },
              "orgDomains": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "domain",
                    "viewers"
                  ],
                  "properties": {
                    "domain": {
                      "type": "string"
                    },
                    "viewers": {
                      "type": "integer"
                    }
                  }
                },
                "description": "Organization email domains of signed-in viewers (personal providers filtered), sorted desc."
              },
              "slideReach": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "slideIndex",
                    "reached"
                  ],
                  "properties": {
                    "reached": {
                      "type": "integer"
                    },
                    "slideIndex": {
                      "type": "integer"
                    }
                  }
                },
                "description": "Retention funnel ordered by slide index."
              },
              "anonViewers": {
                "type": "integer"
              },
              "uniqueViewers": {
                "type": "integer",
                "description": "Distinct signed-in viewers."
              },
              "completedCount": {
                "type": "integer"
              },
              "completionRate": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "completedCount / viewCount, 0..1; null when no views."
              },
              "presentationId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get presentation analytics",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_presentation_context",
          "title": "Load a presentation into context",
          "description": "Load any shared Bisque presentation for reading: its metadata, the full per-slide narration transcript with timestamps, and the context.md file its author shipped for agents (extra background the slides summarize). Target it by watch URL (https://bisque.today/p/{handle}/{slug}) or by handle + slug — it does not have to be yours. Use this to read, summarize, cite, or answer questions about a presentation: ground your answers in the returned transcript and context, and cite slides as [slide N].",
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2000,
                "description": "Watch URL, e.g. https://bisque.today/p/{handle}/{slug}. Provide this OR handle + slug."
              },
              "slug": {
                "type": "string",
                "maxLength": 80,
                "description": "URL slug, the last path segment of the watch URL. Use with handle, or pass url instead."
              },
              "handle": {
                "type": "string",
                "maxLength": 80,
                "description": "Channel handle (leading @ allowed)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "title",
              "handle",
              "slug",
              "webUrl",
              "visibility",
              "transcript",
              "transcriptTruncatedSlides",
              "contextMd",
              "contextTruncated"
            ],
            "properties": {
              "slug": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "handle": {
                "type": "string"
              },
              "webUrl": {
                "type": "string"
              },
              "contextMd": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The bundle's context.md (shared agent-facing background); null when the presentation ships none."
              },
              "transcript": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "slideIndex",
                    "startSec",
                    "title",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "startSec": {
                      "type": "number"
                    },
                    "slideIndex": {
                      "type": "integer"
                    }
                  }
                },
                "description": "Per-slide narration, ordered by slide index."
              },
              "visibility": {
                "type": "string"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publishedAt": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "ISO 8601, null when unknown."
              },
              "presentationId": {
                "type": "string"
              },
              "contextTruncated": {
                "type": "boolean"
              },
              "transcriptTruncatedSlides": {
                "type": "integer",
                "description": "Content slides the size-capped transcript dropped; 0 = complete."
              }
            }
          },
          "annotations": {
            "title": "Load a presentation into context",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_presentation_source",
          "title": "Read a presentation's editable source",
          "description": "Read the HTML a presentation was published from, so you can edit it and publish it back to the same URL. Only for a presentation this account may republish; anyone else's reads as not found, including a public one (use get_presentation_context to read those). Target it by presentationId, or by watch URL or handle + slug. To republish, change only what you were asked to in indexHtml and call create_presentation with the same presentationId, slug and visibility, plus each entry of assets as {path, url}; slides whose narration did not change keep their audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "maxLength": 2000,
                "description": "Watch URL, e.g. https://bisque.today/p/{handle}/{slug}. Provide this, handle + slug, or presentationId."
              },
              "slug": {
                "type": "string",
                "maxLength": 80,
                "description": "URL slug, the last path segment of the watch URL."
              },
              "handle": {
                "type": "string",
                "maxLength": 80,
                "description": "Channel handle (leading @ allowed)."
              },
              "presentationId": {
                "type": "string",
                "maxLength": 120,
                "description": "From list_presentations or get_presentation_context."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "presentationId",
              "title",
              "slug",
              "webUrl",
              "visibility",
              "version",
              "voice",
              "indexHtml",
              "contextMd",
              "assets"
            ],
            "properties": {
              "slug": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "voice": {
                "type": "object",
                "properties": {
                  "voiceId": {
                    "type": "string"
                  },
                  "speechSpeed": {
                    "type": "number"
                  }
                },
                "description": "The voice and speed the slides were spoken in. Republishing in them keeps the audio of every unchanged slide."
              },
              "assets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "path",
                    "size",
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "path": {
                      "type": "string"
                    },
                    "size": {
                      "type": "integer"
                    }
                  }
                },
                "description": "Every file under assets/, with a download link that works for one hour. A republish that leaves one out loses it."
              },
              "handle": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "webUrl": {
                "type": "string"
              },
              "version": {
                "type": "integer",
                "description": "The version this source is."
              },
              "madeWith": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "contextMd": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "indexHtml": {
                "type": "string",
                "description": "The HTML as published, complete."
              },
              "visibility": {
                "type": "string"
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publishedAt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "presentationId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Read a presentation's editable source",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_channel",
          "title": "Update channel",
          "description": "Update one of your channels. Set the description — the line a stranger reads in a search result or a link unfurl, at most 160 characters, empty to clear it and go back to naming the newest presentations. Set the avatar from an image URL, which is fetched, center-cropped square and resized. Pass either or both. Omit handle to use your default channel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "handle": {
                "type": "string",
                "maxLength": 30,
                "minLength": 3,
                "description": "Which of your channel handles to update; defaults to your default username."
              },
              "image_url": {
                "type": "string",
                "maxLength": 2000,
                "minLength": 1,
                "description": "https URL of the avatar image (any common format, ≤10 MB)."
              },
              "description": {
                "type": "string",
                "maxLength": 160,
                "description": "What the channel publishes, in the owner's words. Empty clears it."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "handle",
              "channelUrl",
              "updated"
            ],
            "properties": {
              "failed": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "field",
                    "reason"
                  ],
                  "properties": {
                    "field": {
                      "type": "string"
                    },
                    "reason": {
                      "type": "string"
                    }
                  }
                },
                "description": "Fields that did not apply, each with the reason. A field listed here left the channel unchanged; the ones in updated still took effect."
              },
              "handle": {
                "type": "string"
              },
              "updated": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Field names that were written."
              },
              "channelUrl": {
                "type": "string",
                "description": "Public channel page carrying the update."
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The stored line, or null when the write cleared it."
              }
            }
          },
          "annotations": {
            "title": "Update channel",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_artifact",
          "title": "Create an Artifact",
          "description": "Publish an HTML page or a Markdown document as a Bisque Artifact: a persistent, versioned page at a stable URL that people can open, comment on, and that you can update later with update_artifact. Pass the whole document as content. The call waits for the page to be ready and returns its URL. It is private to you unless you pass audience or share_with. A page that should remember what people do on it (a checklist, a poll, a sign-up sheet) declares capabilities ['state.read','state.write'] and, when some paths need different access, state.rules; it then reads and writes JSON documents through window.bisque.state. For a Whiteboard that people and agents draw on together, pass spec 'bisque-canvas/v1' with no content, and board.shapes to start it with frames, stickies, boxes and arrows; read it back with read_board and change it with edit_board. For a narrated presentation use create_presentation instead.",
          "inputSchema": {
            "type": "object",
            "required": [
              "title"
            ],
            "properties": {
              "icon": {
                "type": "string",
                "maxLength": 256,
                "description": "An emoji that stands for the page, e.g. 📊. The tab and Home Screen show icon_image, not this."
              },
              "spec": {
                "enum": [
                  "bisque-canvas/v1"
                ],
                "type": "string",
                "description": "bisque-canvas/v1 makes a Whiteboard: an infinite board people edit live and you read and draw on. Leave content out."
              },
              "type": {
                "enum": [
                  "html",
                  "markdown"
                ],
                "type": "string",
                "description": "Default html."
              },
              "board": {
                "type": "object",
                "properties": {
                  "shapes": {
                    "type": "object",
                    "description": "Shapes by id (1–64 letters, digits, - or _), each { type, x, y, w, h, z?, color?, text?, frame?, points? }, or null to remove one you drew. type is rect, ellipse, sticky, text, arrow (a line from x,y to x+w,y+h), pen (points is a flat [x0, y0, x1, y1, …] list relative to x,y) or frame (a named area; text is its name). color is ink, gray, red, orange, yellow, green, blue or violet. text is the shape's label. frame puts the shape in the frame with that id. z orders them: higher draws on top. Coordinates are board pixels, y grows downward; a sticky is about 200×200. At most 500 a call.",
                    "additionalProperties": {
                      "oneOf": [
                        {
                          "type": "object",
                          "required": [
                            "type",
                            "x",
                            "y",
                            "w",
                            "h"
                          ],
                          "properties": {
                            "h": {
                              "type": "number"
                            },
                            "w": {
                              "type": "number"
                            },
                            "x": {
                              "type": "number"
                            },
                            "y": {
                              "type": "number"
                            },
                            "z": {
                              "type": "number"
                            },
                            "text": {
                              "type": "string"
                            },
                            "type": {
                              "enum": [
                                "rect",
                                "ellipse",
                                "sticky",
                                "text",
                                "arrow",
                                "pen",
                                "frame"
                              ],
                              "type": "string"
                            },
                            "color": {
                              "enum": [
                                "ink",
                                "gray",
                                "red",
                                "orange",
                                "yellow",
                                "green",
                                "blue",
                                "violet"
                              ],
                              "type": "string"
                            },
                            "frame": {
                              "type": "string"
                            },
                            "points": {
                              "type": "array",
                              "items": {
                                "type": "number"
                              }
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                },
                "description": "A Whiteboard's starting shapes.",
                "additionalProperties": false
              },
              "state": {
                "type": "object",
                "properties": {
                  "rules": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "path"
                      ],
                      "properties": {
                        "path": {
                          "type": "string",
                          "description": "A slash path the rule covers, and everything below it; '' is the root. A trailing {self} names each person's own document under the prefix."
                        },
                        "read": {
                          "enum": [
                            "anyone",
                            "viewer",
                            "contributor",
                            "owner"
                          ],
                          "type": "string"
                        },
                        "write": {
                          "enum": [
                            "viewer",
                            "contributor",
                            "owner"
                          ],
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                },
                "description": "Who may read and write which paths of the page's data, by the minimum role: viewer (can open), contributor (a data grant, separate from editing the page), owner. Absent means: everyone who can open reads, contributors and the owner write. Example poll: [{path:'votes',read:'viewer',write:'owner'},{path:'votes/{self}',write:'viewer'}].",
                "additionalProperties": false
              },
              "title": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "A short name, the way a document or app is named."
              },
              "listed": {
                "type": "boolean",
                "description": "Show it in listings (the company library, public discovery) rather than link-only. Default true for a company audience (audience org with organization_id), false otherwise."
              },
              "content": {
                "type": "string",
                "description": "The full document; required except for a Whiteboard. For html: a complete page in a sandboxed frame. Styles, scripts and images are inline, except libraries from cdnjs.cloudflare.com, cdn.jsdelivr.net/npm/, cdn.tailwindcss.com, code.jquery.com or unpkg.com and typefaces from Google Fonts; pin each library to an exact version in its URL (chart.js@4.4.1, never @latest), so the page renders the same for as long as it is published. Nothing else loads, and fetch reaches nowhere. For markdown: the Markdown source."
              },
              "audience": {
                "enum": [
                  "owner",
                  "users",
                  "public"
                ],
                "type": "string",
                "description": "Who can open the link. owner: only you. users: the people in share_with. public: anyone with the link."
              },
              "expires_at": {
                "type": "string",
                "format": "date-time",
                "description": "The same as expires_in_days, as an RFC 3339 moment. Pass one or the other."
              },
              "icon_image": {
                "type": "string",
                "description": "The page's own icon: the favicon in the browser tab and the icon a phone puts on its Home Screen. A data URL: an SVG (data:image/svg+xml,<svg …>) or a base64 PNG, JPEG, WebP, or GIF, at most 512 KB, cropped to a square. An SVG must be self-contained (no links to other files, fonts, or stylesheets); draw shapes rather than text. Without one the page shows the Bisque icon."
              },
              "share_with": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "uid": {
                      "type": "string",
                      "description": "Their Bisque uid, if known."
                    },
                    "role": {
                      "enum": [
                        "viewer",
                        "editor"
                      ],
                      "type": "string",
                      "description": "Default viewer."
                    },
                    "email": {
                      "type": "string",
                      "description": "The person's account email."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 100,
                "description": "People to grant access by email (or uid), with a role. [{ \"email\": \"ana@acme.com\", \"role\": \"viewer\" }]. viewer opens it; editor can also publish new content. Implies audience \"users\" when audience is omitted."
              },
              "description": {
                "type": "string",
                "maxLength": 2000,
                "description": "One sentence saying what the page is; shown in listings."
              },
              "capabilities": {
                "type": "array",
                "items": {
                  "enum": [
                    "state.read",
                    "state.write",
                    "events.emit",
                    "viewer.identity"
                  ],
                  "type": "string"
                },
                "description": "What the page may do at run time. state.read and state.write give it JSON documents at window.bisque.state (get, patch, list, subscribe); viewer.identity tells it who is viewing (window.bisque.viewer); events.emit lets it record typed Events. Omit for a page that only shows things.",
                "uniqueItems": true
              },
              "expires_in_days": {
                "type": "integer",
                "maximum": 3650,
                "minimum": 1,
                "description": "Delete the Artifact this many days from now, as delete_artifact would: it sits in the owner's Trash for 30 days, then its files go. Only when the user asks for it to go away (a scratch page, a one-week poll); leave it out and the Artifact is kept."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "type",
              "title",
              "audience_mode",
              "discoverability",
              "published_version_id",
              "url",
              "version_id",
              "publication_status"
            ],
            "properties": {
              "url": {
                "type": "string",
                "description": "The viewer page."
              },
              "icon": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "html",
                  "markdown",
                  "presentation"
                ],
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "group_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string",
                "description": "When it is deleted, as its owner asked; absent when it is kept."
              },
              "updated_at": {
                "type": "string"
              },
              "version_id": {
                "type": "string",
                "description": "The Version this call authored."
              },
              "artifact_id": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "audience_mode": {
                "type": "string",
                "description": "Who can open it: owner, users, org, or public."
              },
              "icon_image_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The page icon set with icon_image; null for the Bisque icon."
              },
              "version_number": {
                "type": "integer"
              },
              "discoverability": {
                "enum": [
                  "unlisted",
                  "listed"
                ],
                "type": "string"
              },
              "organization_id": {
                "type": "string"
              },
              "latest_version_id": {
                "type": "string"
              },
              "publication_error": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  }
                }
              },
              "publication_status": {
                "enum": [
                  "queued",
                  "processing",
                  "ready",
                  "failed"
                ],
                "type": "string",
                "description": "ready means the URL serves this content now. queued or processing means it is still being prepared; call get_artifact to check. failed carries publication_error."
              },
              "viewer_version_mode": {
                "enum": [
                  "latest",
                  "pinned"
                ],
                "type": "string"
              },
              "published_version_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The Version viewers see; null until a publication is ready."
              }
            }
          },
          "annotations": {
            "title": "Create an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_artifacts",
          "title": "List your Artifacts",
          "description": "List Artifacts you own (scope owned, the default), ones shared with you (shared), or both (all), newest first. Each item carries its id, title, who can open it, and its URL.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "type": {
                "enum": [
                  "html",
                  "markdown",
                  "presentation"
                ],
                "type": "string",
                "description": "Only this type."
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Page size, default 25."
              },
              "scope": {
                "enum": [
                  "owned",
                  "shared",
                  "all"
                ],
                "type": "string",
                "description": "Default owned."
              },
              "cursor": {
                "type": "string",
                "description": "next_cursor from a prior page."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "items",
              "next_cursor"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "artifact_id",
                    "type",
                    "title",
                    "audience_mode",
                    "discoverability",
                    "published_version_id",
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string",
                      "description": "The viewer page."
                    },
                    "icon": {
                      "type": "string"
                    },
                    "type": {
                      "enum": [
                        "html",
                        "markdown",
                        "presentation"
                      ],
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "group_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "expires_at": {
                      "type": "string",
                      "description": "When it is deleted, as its owner asked; absent when it is kept."
                    },
                    "updated_at": {
                      "type": "string"
                    },
                    "artifact_id": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "audience_mode": {
                      "type": "string",
                      "description": "Who can open it: owner, users, org, or public."
                    },
                    "icon_image_url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The page icon set with icon_image; null for the Bisque icon."
                    },
                    "discoverability": {
                      "enum": [
                        "unlisted",
                        "listed"
                      ],
                      "type": "string"
                    },
                    "organization_id": {
                      "type": "string"
                    },
                    "latest_version_id": {
                      "type": "string"
                    },
                    "viewer_version_mode": {
                      "enum": [
                        "latest",
                        "pinned"
                      ],
                      "type": "string"
                    },
                    "published_version_id": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The Version viewers see; null until a publication is ready."
                    }
                  }
                }
              },
              "next_cursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "title": "List your Artifacts",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_artifact",
          "title": "Get an Artifact",
          "description": "Read one Artifact: title, who can open it, the Version viewers see (published_version_id, null while a publication is still being prepared), its URL, and for a markdown document its text (content), so a linked document is read in one call. Pass the art_… id from the end of the link.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "type",
              "title",
              "audience_mode",
              "discoverability",
              "published_version_id",
              "url",
              "content"
            ],
            "properties": {
              "url": {
                "type": "string",
                "description": "The viewer page."
              },
              "icon": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "html",
                  "markdown",
                  "presentation"
                ],
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "content": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The Markdown source of a markdown Artifact's published Version. null for an html page, a presentation, an Artifact that is not yet published, or a sold one you only view."
              },
              "group_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string",
                "description": "When it is deleted, as its owner asked; absent when it is kept."
              },
              "updated_at": {
                "type": "string"
              },
              "artifact_id": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "audience_mode": {
                "type": "string",
                "description": "Who can open it: owner, users, org, or public."
              },
              "icon_image_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The page icon set with icon_image; null for the Bisque icon."
              },
              "discoverability": {
                "enum": [
                  "unlisted",
                  "listed"
                ],
                "type": "string"
              },
              "organization_id": {
                "type": "string"
              },
              "latest_version_id": {
                "type": "string"
              },
              "viewer_version_mode": {
                "enum": [
                  "latest",
                  "pinned"
                ],
                "type": "string"
              },
              "published_version_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The Version viewers see; null until a publication is ready."
              }
            }
          },
          "annotations": {
            "title": "Get an Artifact",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "update_artifact",
          "title": "Update an Artifact",
          "description": "Change an Artifact you own or edit. Pass content to publish a new Version of the page at the same URL (the whole document, not a diff; earlier Versions stay in the history). Pass title, description, icon, or icon_image to change those, and, in a call without content, expires_in_days or expires_at (null keeps it) to set when an Artifact you own is deleted. Any combination in one call. With content the call waits for the new Version to be live before returning. The new Version keeps the base Version's capabilities and state rules unless you pass capabilities or state.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "icon": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 256,
                "description": "null clears it."
              },
              "state": {
                "type": "object",
                "properties": {
                  "rules": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "path"
                      ],
                      "properties": {
                        "path": {
                          "type": "string",
                          "description": "A slash path the rule covers, and everything below it; '' is the root. A trailing {self} names each person's own document under the prefix."
                        },
                        "read": {
                          "enum": [
                            "anyone",
                            "viewer",
                            "contributor",
                            "owner"
                          ],
                          "type": "string"
                        },
                        "write": {
                          "enum": [
                            "viewer",
                            "contributor",
                            "owner"
                          ],
                          "type": "string"
                        }
                      },
                      "additionalProperties": false
                    }
                  }
                },
                "description": "Who may read and write which paths of the page's data, by the minimum role: viewer (can open), contributor (a data grant, separate from editing the page), owner. Absent means: everyone who can open reads, contributors and the owner write. Example poll: [{path:'votes',read:'viewer',write:'owner'},{path:'votes/{self}',write:'viewer'}].",
                "additionalProperties": false
              },
              "title": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "content": {
                "type": "string",
                "description": "The complete new document, same type as before."
              },
              "expires_at": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "The same as expires_in_days, as an RFC 3339 moment. Pass one or the other. null cancels the expiry, so the Artifact is kept."
              },
              "icon_image": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The page's own icon: the favicon in the browser tab and the icon a phone puts on its Home Screen. A data URL: an SVG (data:image/svg+xml,<svg …>) or a base64 PNG, JPEG, WebP, or GIF, at most 512 KB, cropped to a square. An SVG must be self-contained (no links to other files, fonts, or stylesheets); draw shapes rather than text. Without one the page shows the Bisque icon. null goes back to the Bisque icon."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ],
                "maxLength": 2000,
                "description": "null clears it."
              },
              "capabilities": {
                "type": "array",
                "items": {
                  "enum": [
                    "state.read",
                    "state.write",
                    "events.emit",
                    "viewer.identity"
                  ],
                  "type": "string"
                },
                "description": "What the page may do at run time. state.read and state.write give it JSON documents at window.bisque.state (get, patch, list, subscribe); viewer.identity tells it who is viewing (window.bisque.viewer); events.emit lets it record typed Events. Omit for a page that only shows things.",
                "uniqueItems": true
              },
              "expires_in_days": {
                "type": "integer",
                "maximum": 3650,
                "minimum": 1,
                "description": "Delete the Artifact this many days from now, as delete_artifact would: it sits in the owner's Trash for 30 days, then its files go. Only when the user asks for it to go away (a scratch page, a one-week poll); leave it out and the Artifact is kept."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "type",
              "title",
              "audience_mode",
              "discoverability",
              "published_version_id",
              "url"
            ],
            "properties": {
              "url": {
                "type": "string",
                "description": "The viewer page."
              },
              "icon": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "html",
                  "markdown",
                  "presentation"
                ],
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "group_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string",
                "description": "When it is deleted, as its owner asked; absent when it is kept."
              },
              "updated_at": {
                "type": "string"
              },
              "version_id": {
                "type": "string",
                "description": "The Version this call authored."
              },
              "artifact_id": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "audience_mode": {
                "type": "string",
                "description": "Who can open it: owner, users, org, or public."
              },
              "icon_image_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The page icon set with icon_image; null for the Bisque icon."
              },
              "version_number": {
                "type": "integer"
              },
              "discoverability": {
                "enum": [
                  "unlisted",
                  "listed"
                ],
                "type": "string"
              },
              "organization_id": {
                "type": "string"
              },
              "latest_version_id": {
                "type": "string"
              },
              "publication_error": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "message": {
                    "type": "string"
                  }
                }
              },
              "publication_status": {
                "enum": [
                  "queued",
                  "processing",
                  "ready",
                  "failed"
                ],
                "type": "string",
                "description": "ready means the URL serves this content now. queued or processing means it is still being prepared; call get_artifact to check. failed carries publication_error."
              },
              "viewer_version_mode": {
                "enum": [
                  "latest",
                  "pinned"
                ],
                "type": "string"
              },
              "published_version_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The Version viewers see; null until a publication is ready."
              }
            }
          },
          "annotations": {
            "title": "Update an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "share_artifact",
          "title": "Share an Artifact",
          "description": "Set who can open an Artifact you own. audience picks the rule; share_with is the complete list of named people (it replaces the previous list; omit it to keep the current one). Going public deletes every comment thread, so a public change on an Artifact with threads is refused unless delete_threads is true. Returns the URL to send.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "audience"
            ],
            "properties": {
              "listed": {
                "type": "boolean",
                "description": "Show it in listings (the company library, public discovery) rather than link-only. Default false."
              },
              "audience": {
                "enum": [
                  "owner",
                  "users",
                  "public"
                ],
                "type": "string",
                "description": "Who can open the link. owner: only you. users: the people in share_with. public: anyone with the link."
              },
              "share_with": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "uid": {
                      "type": "string",
                      "description": "Their Bisque uid, if known."
                    },
                    "role": {
                      "enum": [
                        "viewer",
                        "editor"
                      ],
                      "type": "string",
                      "description": "Default viewer."
                    },
                    "email": {
                      "type": "string",
                      "description": "The person's account email."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 100,
                "description": "People to grant access by email (or uid), with a role. [{ \"email\": \"ana@acme.com\", \"role\": \"viewer\" }]. viewer opens it; editor can also publish new content. Implies audience \"users\" when audience is omitted."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              },
              "delete_threads": {
                "type": "boolean",
                "description": "Allow going public on an Artifact that has comment threads, deleting them."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "audience_mode",
              "discoverability",
              "grants",
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "grants": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "role": {
                      "enum": [
                        "viewer",
                        "editor"
                      ],
                      "type": "string"
                    },
                    "email": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "principal": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "type": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "artifact_id": {
                "type": "string"
              },
              "audience_mode": {
                "type": "string"
              },
              "discoverability": {
                "enum": [
                  "unlisted",
                  "listed"
                ],
                "type": "string"
              },
              "public_sharing_allowed": {
                "type": "boolean"
              },
              "external_sharing_allowed": {
                "type": "boolean"
              }
            }
          },
          "annotations": {
            "title": "Share an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "delete_artifact",
          "title": "Delete an Artifact",
          "description": "Delete an Artifact you own. Its URL stops working for everyone. Confirm with the user before calling this.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "deleted"
            ],
            "properties": {
              "deleted": {
                "type": "boolean"
              },
              "artifact_id": {
                "type": "string"
              },
              "already_deleted": {
                "type": "boolean"
              }
            }
          },
          "annotations": {
            "title": "Delete an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "read_board",
          "title": "Read a Whiteboard",
          "description": "Read a Whiteboard (an Artifact made with spec bisque-canvas/v1) as structure: its frames, every shape with its text and the frame it sits in, what each arrow connects, and an outline with frames as headings, shapes as bullets and arrows as A → B. Pass region to read one area. Use it before changing a board, to answer a comment about it, or to turn the board into a document or a presentation.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "region": {
                "type": "object",
                "required": [
                  "x",
                  "y",
                  "w",
                  "h"
                ],
                "properties": {
                  "h": {
                    "type": "number",
                    "minimum": 0
                  },
                  "w": {
                    "type": "number",
                    "minimum": 0
                  },
                  "x": {
                    "type": "number"
                  },
                  "y": {
                    "type": "number"
                  }
                },
                "description": "Board coordinates of an area, as a comment pinned to a region carries them; only what overlaps it is returned.",
                "additionalProperties": false
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "frames",
              "shapes",
              "outline",
              "truncated"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "frames": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "shapes": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "outline": {
                "type": "string"
              },
              "truncated": {
                "type": "boolean"
              },
              "artifact_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Read a Whiteboard",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "edit_board",
          "title": "Draw on a Whiteboard",
          "description": "Add, move, restyle or remove shapes on a Whiteboard. Shapes are keyed by an id you choose; sending the same id again changes that shape, and null removes it. People with the board open see the change within a second, and it is recorded as yours. Shapes people drew themselves are read with read_board but not changed here.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "shapes"
            ],
            "properties": {
              "shapes": {
                "type": "object",
                "description": "Shapes by id (1–64 letters, digits, - or _), each { type, x, y, w, h, z?, color?, text?, frame?, points? }, or null to remove one you drew. type is rect, ellipse, sticky, text, arrow (a line from x,y to x+w,y+h), pen (points is a flat [x0, y0, x1, y1, …] list relative to x,y) or frame (a named area; text is its name). color is ink, gray, red, orange, yellow, green, blue or violet. text is the shape's label. frame puts the shape in the frame with that id. z orders them: higher draws on top. Coordinates are board pixels, y grows downward; a sticky is about 200×200. At most 500 a call.",
                "additionalProperties": {
                  "oneOf": [
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "x",
                        "y",
                        "w",
                        "h"
                      ],
                      "properties": {
                        "h": {
                          "type": "number"
                        },
                        "w": {
                          "type": "number"
                        },
                        "x": {
                          "type": "number"
                        },
                        "y": {
                          "type": "number"
                        },
                        "z": {
                          "type": "number"
                        },
                        "text": {
                          "type": "string"
                        },
                        "type": {
                          "enum": [
                            "rect",
                            "ellipse",
                            "sticky",
                            "text",
                            "arrow",
                            "pen",
                            "frame"
                          ],
                          "type": "string"
                        },
                        "color": {
                          "enum": [
                            "ink",
                            "gray",
                            "red",
                            "orange",
                            "yellow",
                            "green",
                            "blue",
                            "violet"
                          ],
                          "type": "string"
                        },
                        "frame": {
                          "type": "string"
                        },
                        "points": {
                          "type": "array",
                          "items": {
                            "type": "number"
                          }
                        }
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "changed"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "changed": {
                "type": "integer"
              },
              "artifact_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Draw on a Whiteboard",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "read_artifact_analytics",
          "title": "Read an Artifact's analytics",
          "description": "Who opened a document or page you own, edit, or published: views, signed-in readers, and which Version each last opened. On a company document or page it names every member who can open it, with their opens and, for a document, whether they read the latest version; company admins read it for every company item. Use it to answer 'who has read the policy?' or 'has the team opened the dashboard?'. A reader list carries email addresses, so answer the question asked rather than pasting it.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "view_count",
              "unique_viewers",
              "readers"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "readers": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object"
                },
                "description": "Company items only; null on a personal one."
              },
              "versions": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "view_count": {
                "type": "integer"
              },
              "artifact_id": {
                "type": "string"
              },
              "last_viewed_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "unique_viewers": {
                "type": "integer"
              },
              "published_version_number": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "title": "Read an Artifact's analytics",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "read_artifact_results",
          "title": "Read what a page collected",
          "description": "Every answer a page collected, by name: a survey's responses (one per person, with the questions), or the page's data documents with who wrote each. Only the page's owner, or an admin of the company that owns it, may read them. Use it to summarize a survey, count sign-ups, or say who has not answered. Answers carry names and email addresses: report what the user asked, not the raw rows.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "kind",
              "truncated"
            ],
            "properties": {
              "kind": {
                "enum": [
                  "survey",
                  "data",
                  "none"
                ],
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "documents": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object"
                }
              },
              "questions": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object"
                }
              },
              "responses": {
                "type": [
                  "array",
                  "null"
                ],
                "items": {
                  "type": "object"
                }
              },
              "truncated": {
                "type": "boolean"
              },
              "artifact_id": {
                "type": "string"
              },
              "published_version_number": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "title": "Read what a page collected",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "pin_artifact",
          "title": "Pin an Artifact",
          "description": "Pin an Artifact to the top of the user's own Artifacts library, the same as the Pin button there. Use it when the user asks you to pin something, so they can find it again. A pin is only for the user: it changes nothing about the Artifact and does not share it. Pinning one that is already pinned moves it to the top.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "pinned"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "pinned": {
                "type": "boolean"
              },
              "artifact_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Pin an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "unpin_artifact",
          "title": "Unpin an Artifact",
          "description": "Take an Artifact off the Pinned shelf of the user's own Artifacts library. The Artifact itself is untouched.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…): the last part of its link, as in bisque.cloud/documents/art_…, /pages/art_… or /artifacts/art_…."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "pinned"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "pinned": {
                "type": "boolean"
              },
              "artifact_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Unpin an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_artifact_threads",
          "title": "List Artifact comment threads",
          "description": "List the comment threads people left on one of your Artifacts, newest activity first. Pass activated_only: true to get only the threads where someone mentioned the agent, which are the ones you may reply to and resolve. Each thread carries its anchor (what it is pinned to), the version it was left on, a preview, and agent_activated.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id"
            ],
            "properties": {
              "after": {
                "type": "string",
                "description": "RFC 3339 date-time; only threads with activity after it."
              },
              "cursor": {
                "type": "string",
                "description": "next_cursor from a prior page."
              },
              "status": {
                "enum": [
                  "open",
                  "resolved",
                  "all"
                ],
                "type": "string",
                "description": "Default open."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…)."
              },
              "activated_only": {
                "type": "boolean",
                "description": "Only threads where the agent was mentioned."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "items",
              "next_cursor"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "thread_id",
                    "artifact_id",
                    "status",
                    "anchor",
                    "version_number",
                    "preview",
                    "message_count",
                    "agent_activated",
                    "created_by",
                    "created_at",
                    "last_message_at"
                  ],
                  "properties": {
                    "anchor": {
                      "type": "object",
                      "description": "Where the thread is pinned: kind element (selector, snapshot, slide), text (quote), or page."
                    },
                    "status": {
                      "enum": [
                        "open",
                        "resolved"
                      ],
                      "type": "string"
                    },
                    "preview": {
                      "type": "string"
                    },
                    "mentions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "thread_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "created_by": {
                      "type": "object",
                      "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
                    },
                    "updated_at": {
                      "type": "string"
                    },
                    "version_id": {
                      "type": "string"
                    },
                    "artifact_id": {
                      "type": "string"
                    },
                    "resolved_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "participants": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "message_count": {
                      "type": "integer"
                    },
                    "version_number": {
                      "type": "integer"
                    },
                    "agent_activated": {
                      "type": "boolean",
                      "description": "True once someone mentioned the agent; only then may the agent reply or resolve."
                    },
                    "last_message_at": {
                      "type": "string"
                    },
                    "root_message_id": {
                      "type": "string"
                    }
                  }
                }
              },
              "artifact_id": {
                "type": "string"
              },
              "next_cursor": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "annotations": {
            "title": "List Artifact comment threads",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_artifact_thread",
          "title": "Get an Artifact comment thread",
          "description": "Read one comment thread on an Artifact with every message, oldest first. Mentions in a body look like @[Name](mention:uid); a mention of the agent is @[Agent](mention:agent).",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "thread_id"
            ],
            "properties": {
              "thread_id": {
                "type": "string",
                "pattern": "^thr_[a-zA-Z0-9]+$",
                "description": "The thread id (thr_…)."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "thread_id",
              "artifact_id",
              "status",
              "anchor",
              "version_number",
              "preview",
              "message_count",
              "agent_activated",
              "created_by",
              "created_at",
              "last_message_at",
              "messages"
            ],
            "properties": {
              "anchor": {
                "type": "object",
                "description": "Where the thread is pinned: kind element (selector, snapshot, slide), text (quote), or page."
              },
              "status": {
                "enum": [
                  "open",
                  "resolved"
                ],
                "type": "string"
              },
              "preview": {
                "type": "string"
              },
              "mentions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "messages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "message_id",
                    "thread_id",
                    "author",
                    "body",
                    "created_at"
                  ],
                  "properties": {
                    "body": {
                      "type": "string"
                    },
                    "author": {
                      "type": "object",
                      "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
                    },
                    "mentions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "edited_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reactions": {
                      "type": "object"
                    },
                    "thread_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "message_id": {
                      "type": "string"
                    },
                    "artifact_id": {
                      "type": "string"
                    },
                    "attachments": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              },
              "thread_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "created_by": {
                "type": "object",
                "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
              },
              "updated_at": {
                "type": "string"
              },
              "version_id": {
                "type": "string"
              },
              "artifact_id": {
                "type": "string"
              },
              "resolved_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "participants": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "message_count": {
                "type": "integer"
              },
              "version_number": {
                "type": "integer"
              },
              "agent_activated": {
                "type": "boolean",
                "description": "True once someone mentioned the agent; only then may the agent reply or resolve."
              },
              "last_message_at": {
                "type": "string"
              },
              "root_message_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get an Artifact comment thread",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_artifact_thread",
          "title": "Start a comment thread on an Artifact",
          "description": "Leave a new comment thread on one of your Artifacts, as the agent. Without an anchor the thread is a general comment on the page. The thread is activated from the start, so you can reply to it and resolve it later. Mention a person with @[Name](mention:uid) using ids from the Artifact's mentionables.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "body"
            ],
            "properties": {
              "body": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1,
                "description": "Markdown subset: bold, italic, code, links, lists."
              },
              "anchor": {
                "type": "object",
                "description": "Optional pin. { kind: \"page\", slideId, slideIndex, timeSec } for a slide or time; { kind: \"element\", selector, xFrac, yFrac, snapshot: { tag, text }, slideId, slideIndex, cueTarget, timeSec } for an element; { kind: \"text\", quote, prefix, suffix, selector, slideId, slideIndex } for a passage."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "thread_id",
              "artifact_id",
              "status",
              "anchor",
              "version_number",
              "preview",
              "message_count",
              "agent_activated",
              "created_by",
              "created_at",
              "last_message_at",
              "messages"
            ],
            "properties": {
              "anchor": {
                "type": "object",
                "description": "Where the thread is pinned: kind element (selector, snapshot, slide), text (quote), or page."
              },
              "status": {
                "enum": [
                  "open",
                  "resolved"
                ],
                "type": "string"
              },
              "preview": {
                "type": "string"
              },
              "mentions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "messages": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "message_id",
                    "thread_id",
                    "author",
                    "body",
                    "created_at"
                  ],
                  "properties": {
                    "body": {
                      "type": "string"
                    },
                    "author": {
                      "type": "object",
                      "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
                    },
                    "mentions": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "edited_at": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reactions": {
                      "type": "object"
                    },
                    "thread_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "message_id": {
                      "type": "string"
                    },
                    "artifact_id": {
                      "type": "string"
                    },
                    "attachments": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              },
              "thread_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "created_by": {
                "type": "object",
                "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
              },
              "updated_at": {
                "type": "string"
              },
              "version_id": {
                "type": "string"
              },
              "artifact_id": {
                "type": "string"
              },
              "resolved_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "participants": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "message_count": {
                "type": "integer"
              },
              "version_number": {
                "type": "integer"
              },
              "agent_activated": {
                "type": "boolean",
                "description": "True once someone mentioned the agent; only then may the agent reply or resolve."
              },
              "last_message_at": {
                "type": "string"
              },
              "root_message_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Start a comment thread on an Artifact",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "reply_to_artifact_thread",
          "title": "Reply in an Artifact comment thread",
          "description": "Post a reply in a comment thread as the agent. Allowed only on activated threads (agent_activated true): someone mentioned the agent, or the agent started the thread. People see it as \"Agent · via <your name>\".",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "thread_id",
              "body"
            ],
            "properties": {
              "body": {
                "type": "string",
                "maxLength": 4000,
                "minLength": 1
              },
              "thread_id": {
                "type": "string",
                "pattern": "^thr_[a-zA-Z0-9]+$",
                "description": "The thread id (thr_…)."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "message_id",
              "thread_id",
              "author",
              "body",
              "created_at"
            ],
            "properties": {
              "body": {
                "type": "string"
              },
              "author": {
                "type": "object",
                "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
              },
              "mentions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "edited_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "reactions": {
                "type": "object"
              },
              "thread_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "message_id": {
                "type": "string"
              },
              "artifact_id": {
                "type": "string"
              },
              "attachments": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              }
            }
          },
          "annotations": {
            "title": "Reply in an Artifact comment thread",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "resolve_artifact_thread",
          "title": "Resolve or reopen an Artifact comment thread",
          "description": "Mark a comment thread resolved (resolved: true) or reopen it (resolved: false), as the agent. Allowed only on activated threads. Resolve after you have addressed the comment, usually after republishing the Artifact; reply first so the person can see what changed.",
          "inputSchema": {
            "type": "object",
            "required": [
              "artifact_id",
              "thread_id",
              "resolved"
            ],
            "properties": {
              "resolved": {
                "type": "boolean"
              },
              "thread_id": {
                "type": "string",
                "pattern": "^thr_[a-zA-Z0-9]+$",
                "description": "The thread id (thr_…)."
              },
              "artifact_id": {
                "type": "string",
                "pattern": "^art_[a-zA-Z0-9]+$",
                "description": "The Artifact id (art_…)."
              }
            },
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "thread_id",
              "artifact_id",
              "status",
              "anchor",
              "version_number",
              "preview",
              "message_count",
              "agent_activated",
              "created_by",
              "created_at",
              "last_message_at"
            ],
            "properties": {
              "anchor": {
                "type": "object",
                "description": "Where the thread is pinned: kind element (selector, snapshot, slide), text (quote), or page."
              },
              "status": {
                "enum": [
                  "open",
                  "resolved"
                ],
                "type": "string"
              },
              "preview": {
                "type": "string"
              },
              "mentions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "thread_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "created_by": {
                "type": "object",
                "description": "Who wrote it: { kind: \"user\", uid, name, handle, avatarUrl } or { kind: \"agent\", principal, name, via }."
              },
              "updated_at": {
                "type": "string"
              },
              "version_id": {
                "type": "string"
              },
              "artifact_id": {
                "type": "string"
              },
              "resolved_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "participants": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "message_count": {
                "type": "integer"
              },
              "version_number": {
                "type": "integer"
              },
              "agent_activated": {
                "type": "boolean",
                "description": "True once someone mentioned the agent; only then may the agent reply or resolve."
              },
              "last_message_at": {
                "type": "string"
              },
              "root_message_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Resolve or reopen an Artifact comment thread",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "format-spec",
          "uri": "bisque://presentations/format-spec",
          "mimeType": "text/markdown",
          "description": "Canonical authoring spec for Bisque presentations."
        },
        {
          "name": "presentation-player",
          "uri": "ui://bisque/presentation-player.html",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Chat-embedded player widget (MCP Apps): renders a tool result's webUrl as the watch player iframe."
        }
      ],
      "prompts": [
        {
          "name": "present",
          "description": "The html-presentation/v1 authoring guidance: how to structure a narrated presentation for create_presentation.",
          "arguments": [
            {
              "name": "topic",
              "required": false,
              "description": "What the presentation is about."
            }
          ]
        }
      ]
    },
    "instructions": "Bisque publishes narrated presentations from an agent and reads any shared one back as text. To publish: call get_presentation_spec, write one html-presentation/v1 document that follows it, call create_presentation, then poll get_presentation_status until ready is true; the result carries the watch URL. To read a presentation someone shared, call get_presentation_context with its watch URL; public and unlisted ones need no credential. To change one you can republish, call get_presentation_source, edit the HTML it returns, and send it back to create_presentation with the same presentationId, slug and visibility. To publish an HTML page or a Markdown document instead, call create_artifact with the whole document; it returns the URL once the page is live, private to the caller until share_artifact opens it up. tools/list, resources/read and prompts/get answer without a credential; tools/call needs a Bisque API key or an OAuth 2.1 token (see https://bisque.today/auth.md). Questions about how Bisque works go to the docs server at https://bisque.today/docs/mcp."
  },
  "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."
}