API & MCP

Everything a person can do on Shared Review Room, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://pageboardreviewroom.usefulweb.app/api/v1/calculate – run Shared Review Room
GET https://pageboardreviewroom.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Shared Review Room

Create an expiring room for text or a small PNG/JPEG reference, invite participants, resolve pinned comments and export the discussion. The owner can revoke the room.

Inputs of Shared Review Room
Field	Type	Default	Description
`operation`	select (create, read, join, comment, presence, edit, resolve, reopen, delete, revoke)	"create"	Action
`title`	textarea	"Design review"	Room title
`reference`	textarea	"Review this layout together."	Reference text or PNG/JPEG data URL
`hours`	number	2	Room lifetime (hours)
`roomId`	textarea	—	Room ID
`peer`	textarea	—	Participant ID
`accessKey`	textarea	—	Room access key
`ownerKey`	textarea	—	Owner key
`participantKey`	textarea	—	Private participant key
`name`	textarea	"Guest"	Your display name
`comment`	textarea	—	Comment
`commentId`	textarea	—	Comment ID
`requestId`	textarea	—	Idempotency key
`x`	number	50	Pin X (%)
`y`	number	50	Pin Y (%)

Example request

Try an example

curl -X POST https://pageboardreviewroom.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://pageboardreviewroom.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: pageboard_review_room
Local stdio connector: node src/mcp-stdio.ts --tool=pageboard-review-room

{
  "mcpServers": {
    "pageboard-review-room": { "type": "http", "url": "https://pageboardreviewroom.usefulweb.app/mcp" }
  }
}