{"version":"1.0","name":"knowtheroom","description":"Presenter-authorized tools for decks, rooms, reports, people, and workspace settings.","transport":{"type":"streamable-http","endpoint":"https://knowtheroom-five.vercel.app/api/mcp","protocolVersions":["2025-03-26","2025-06-18","2025-11-25"]},"authentication":{"type":"bearer","header":"Authorization","tokenPrefix":"ktr_","tokenManagementRoute":"/settings"},"tools":[{"name":"onboarding.set_room_context","title":"Set onboarding room context","description":"Save the type of room the presenter is preparing for. This updates workspace setup context only and never reads participants.","inputSchema":{"type":"object","properties":{"roomContext":{"type":"string","enum":["buying_committee","client_leadership","investor_panel","cohort","internal_team","other"],"description":"The kind of room the presenter is preparing for."}},"required":["roomContext"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/onboarding/room","riskClass":"mutate"},{"name":"decks.list","title":"List decks","description":"List decks in this workspace.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/decks","riskClass":"read"},{"name":"deck.get","title":"Get deck","description":"Get one deck, its versions, and its latest analysis.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"}},"required":["deckId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/decks/[deckId]","riskClass":"read"},{"name":"deck.import","title":"Start deck import","description":"Create a deck and private upload ticket. The server never fetches a file URL; upload the bytes to the returned signed URL.","inputSchema":{"type":"object","properties":{"title":{"type":"string","description":"Deck title."},"source":{"type":"string","enum":["powerpoint","slides","upload"],"description":"Where this deck came from."},"fileName":{"type":"string","description":"Original file name, ending in .pdf, .pptx, .ppt, or .key."},"fileType":{"type":"string","description":"Optional declared MIME type."},"changelog":{"type":"string","description":"Optional version note."},"fileRef":{"type":"string","description":"Optional local agent reference. It is not fetched by the server."}},"required":["title","source","fileName"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/decks/import","riskClass":"mutate"},{"name":"deck.analyse","title":"Analyse deck","description":"Confirm an uploaded version and start or re-run its analysis.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"},"versionId":{"type":"string","description":"Deck version UUID.","format":"uuid"}},"required":["deckId","versionId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/decks/[deckId]/analysis","riskClass":"mutate"},{"name":"deck.analysis_status","title":"Get analysis status","description":"Get the progress and state of one deck version.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"},"versionId":{"type":"string","description":"Deck version UUID.","format":"uuid"}},"required":["deckId","versionId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/decks/importing/[deckId]","riskClass":"read"},{"name":"deck.analysis.get","title":"Get deck analysis","description":"Get the story map, timing, style, claims, and findings for one version.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"},"versionId":{"type":"string","description":"Deck version UUID.","format":"uuid"}},"required":["deckId","versionId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/decks/[deckId]/analysis","riskClass":"read"},{"name":"deck.findings.send_to_powerpoint","title":"Send findings to PowerPoint","description":"Send analysis findings through a connected PowerPoint add-in. This is unavailable for uploaded files.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"},"versionId":{"type":"string","description":"Deck version UUID.","format":"uuid"}},"required":["deckId","versionId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/decks/[deckId]/analysis","riskClass":"mutate"},{"name":"rooms.list","title":"List rooms","description":"List rooms in this workspace.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms","riskClass":"read"},{"name":"room.create","title":"Create room","description":"Create a room tied permanently to one deck version.","inputSchema":{"type":"object","properties":{"deckId":{"type":"string","description":"Deck UUID.","format":"uuid"},"versionId":{"type":"string","description":"Deck version UUID.","format":"uuid"},"name":{"type":"string","description":"Room name."},"roomType":{"type":"string","description":"What kind of room this is."},"startsAt":{"type":"string","description":"Optional ISO 8601 time with an offset."},"expectedCount":{"type":"integer","description":"Optional expected attendee count.","minimum":1}},"required":["deckId","versionId","name","roomType"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/decks/[deckId]","riskClass":"mutate"},{"name":"room.get","title":"Get room","description":"Get one presenter-owned room and its deck-version details.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]","riskClass":"read"},{"name":"room.open","title":"Open room","description":"Return the stage, presenter remote, and audience join routes for a room.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]","riskClass":"read"},{"name":"room.state","title":"Get room state","description":"Read the reconnect-safe, aggregate-only room projection.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]","riskClass":"read"},{"name":"room.next","title":"Next slide","description":"Advance a live room by one slide and append a slide event.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/remote/[code]","riskClass":"mutate"},{"name":"room.back","title":"Previous slide","description":"Move a live room back by one slide and append a slide event.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/remote/[code]","riskClass":"mutate"},{"name":"room.set_mode","title":"Set presenter mode","description":"Set the live presenter's Agent driving or I drive mode.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"},"mode":{"type":"string","enum":["agent","manual"],"description":"Presenter driving mode."}},"required":["roomId","mode"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/remote/[code]","riskClass":"mutate"},{"name":"room.live_state","title":"Get live filling state","description":"Return the presenter live-room columns: stage readiness, arrivals, and preparation progress. This never includes raw answers.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]/live","riskClass":"read"},{"name":"room.pair_remote","title":"Pair presenter phone","description":"Create a single-use pairing link for the presenter's phone remote. The phone does not sign in. The link expires in ten minutes.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/rooms/[roomId]/present","riskClass":"mutate"},{"name":"room.start","title":"Start room","description":"Start a ready room, deliver cached openers, and append the opening event.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/rooms/[roomId]/live","riskClass":"mutate"},{"name":"room.stop_sharing","title":"Stop sharing the room screen","description":"Leave the filling screen without starting the presentation. The audience is unchanged.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/rooms/[roomId]/live","riskClass":"mutate"},{"name":"room.end","title":"End room","description":"End a live room, prepare its deterministic report, and append the closing events.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/remote/[code]","riskClass":"mutate"},{"name":"room.report","title":"Finish room report","description":"Retry deterministic report preparation for an ended room.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/remote/[code]","riskClass":"mutate"},{"name":"room.report.get","title":"Get room report","description":"Get the report and aggregate-only objection ledger for a room.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]/report","riskClass":"read"},{"name":"room.report.followups.update","title":"Update report follow-ups","description":"Replace the private follow-up drafts in a reported room. Follow-ups contain only labels and messages, never participant records or answers.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"},"followUps":{"type":"array","maxItems":12,"description":"The complete set of follow-up drafts to save.","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable follow-up identifier."},"label":{"type":"string","description":"Short follow-up label."},"message":{"type":"string","description":"Private draft message."}},"required":["id","label","message"],"additionalProperties":false}}},"required":["roomId","followUps"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/rooms/[roomId]/report","riskClass":"mutate"},{"name":"room.report.export","title":"Export room report","description":"Return a JSON report or its aggregate objection ledger.","inputSchema":{"type":"object","properties":{"roomId":{"type":"string","description":"Room UUID.","format":"uuid"},"format":{"type":"string","enum":["json","ledger"],"description":"Export shape."}},"required":["roomId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/rooms/[roomId]/report","riskClass":"read"},{"name":"people.list","title":"List people","description":"List named people and role-only guest cohorts without de-anonymising guests.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/people","riskClass":"read"},{"name":"person.get","title":"Get person","description":"Get a named person's presenter-authorized room history.","inputSchema":{"type":"object","properties":{"personId":{"type":"string","description":"Person UUID.","format":"uuid"}},"required":["personId"],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/people/[personId]","riskClass":"read"},{"name":"person.remove","title":"Remove person","description":"Permanently remove one named person and their linked answers after explicit confirmation. Room aggregates remain.","inputSchema":{"type":"object","properties":{"personId":{"type":"string","description":"Person UUID.","format":"uuid"},"confirm":{"type":"boolean","description":"Must be true to remove this person."}},"required":["personId","confirm"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"route":"/people/[personId]","riskClass":"destructive"},{"name":"settings.get","title":"Get settings","description":"Get workspace, presenter, integration, and token metadata. Token secrets are never returned here.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/settings","riskClass":"read"},{"name":"integrations.list","title":"List integrations","description":"List integration connection status without exposing configuration secrets.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"route":"/settings","riskClass":"read"},{"name":"agent_tokens.create","title":"Create agent token","description":"Create a new bearer token. The raw secret is returned exactly once.","inputSchema":{"type":"object","properties":{"label":{"type":"string","description":"A recognisable label for this token."}},"required":["label"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/settings","riskClass":"mutate"},{"name":"agent_tokens.rotate","title":"Rotate agent token","description":"Replace one active token. The old token stops working after rotation.","inputSchema":{"type":"object","properties":{"tokenId":{"type":"string","description":"Active token UUID.","format":"uuid"},"label":{"type":"string","description":"Optional label for the replacement token."}},"required":["tokenId"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"route":"/settings","riskClass":"mutate"}],"pages":[{"route":"/home","title":"Home"},{"route":"/decks","title":"Decks"},{"route":"/rooms","title":"Rooms"},{"route":"/people","title":"People"},{"route":"/settings","title":"Settings"}]}