Human feedback for AI agents: share HTML, get a live review link, read anchored notes as markdown.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch the reviewer notes for a page shared with share_page, as markdown grouped by page. Each note carries the anchored text, the element and its markup as the reviewer saw it, so you can locate and apply it; each page heading carries a URL to read the whole page back, so you never have to guess which file it is. Show your human each new note and apply only the ones they approve. Pass the note ids already decided in earlier sessions as "handled" to see only what is new.
The room id returned by share_page.
Note ids the creator already decided on (applied or skipped) — e.g. the keys of a saved .twocents/decisions.json. These are summarized in one line each instead of repeated in full, so the response leads with what still needs a decision.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Fetch the reviewer notes for a page shared with share_page, as markdown grouped by page. Each note carries the anchored text, the element and its markup as the reviewer saw it, so you can locate and apply it; each page heading carries a URL to read the whole page back, so you never have to guess which file it is. Show your human each new note and apply only the ones they approve. Pass the note ids already decided in earlier sessions as "handled" to see only what is new.
| Argument | Type | Description |
|---|---|---|
| room* | string | The room id returned by share_page. |
| handled | array | Note ids the creator already decided on (applied or skipped) — e.g. the keys of a saved .twocents/decisions.json. These are summarized in one line each instead of repeated in full, so the response leads with what still needs a decision. |
{
"type": "object",
"required": [
"room"
],
"properties": {
"room": {
"type": "string",
"description": "The room id returned by share_page."
},
"handled": {
"type": "array",
"items": {
"type": "string"
},
"description": "Note ids the creator already decided on (applied or skipped) — e.g. the keys of a saved .twocents/decisions.json. These are summarized in one line each instead of repeated in full, so the response leads with what still needs a decision."
}
}
}Mark notes resolved once you have actually applied them. This is what closes the loop: the note leaves the active list for every later get_feedback, and the reviewer who wrote it sees it marked resolved on the page — live, if they have it open — instead of finding their old note sitting next to content you already fixed. Pass "what" you changed; that sentence is shown to the reviewer, so write it for them, not for the log. Requires the creatorKey that share_page returned when the room was created — the review link alone cannot resolve, or any reader could clear feedback that was not theirs. Nothing is deleted: call again with resolved:false to reopen a note.
| Argument | Type | Description |
|---|---|---|
| by | string | Who applied it, if you want it credited. Max 80 chars. |
| ids* | array | Note ids to resolve — the `id:` field of each note in get_feedback output. |
| room* | string | The room id the notes belong to. |
| what | string | One sentence on what you changed, shown to the reviewer beside their note. Max 400 chars. |
| resolved | boolean | Defaults to true. Pass false to reopen a note you resolved by mistake. |
| creatorKey* | string | The room's creator key, returned by share_page when the room was created and kept in .twocents/state.json. For a room created before creator keys existed, the first key you present claims the room. |
Share a page or document and get back a review link to send to people. Pass "html" for a self-contained page, or "markdown" for a plan, spec, PR description or report — markdown is rendered to a styled, readable document for you, so prefer it whenever the thing you want a human to approve is prose rather than a built page. Reviewers open the link and pin notes directly on it — no login or install. Call again with the same room id to update the page; connected reviewers see the update live. Use get_feedback to collect the notes. Rooms are sticky per project: if the project has a .twocents/state.json, pass its room id instead of creating a new room, so the review link stays stable across sessions.
| Argument | Type | Description |
|---|---|---|
| html | string | A complete, self-contained HTML document (inline CSS/JS/images — no local file references, they will 404 for reviewers). Max ~120 KB. |
| path | string | For multi-page sets: the filename this content lives at in the room (e.g. "about.html" or "plan.md"). Defaults to "index.html", the page reviewers land on. For a set of more than one page prefer share_pages, which publishes them all in one atomic request — sharing them one call at a time can leave a half-published room whose links point at pages that were never stored. |
| room | string | Room id from a previous share_page call, to update that page. Omit to create a new room. |
| source | string | Where this content came from, for whoever reads the feedback later — a project path like "DROPS.md" or "public/p/foo/index.html", or a note like "drafted in this conversation, not yet a file". You are the only one who knows this: twocents receives HTML, never a path, so if you omit it a future session gets reviewer notes with nothing to point them at the right file. get_feedback echoes it back verbatim. |
Publish a multi-page set — an entry page plus the pages it links to — into one room as a single atomic operation. Either the whole set lands or nothing changes, so a reviewer never opens a page whose links point at pages that were never stored. Use this instead of calling share_page N times whenever you have more than one page. Note the ceiling: a room is a review set, not a host — it holds 200 pages and 6 MB total. For a large generated corpus, share the entry points a human would actually read and link out to the rest; nobody pins notes on four hundred pages. If the pages are already files on disk, prefer the uploader — it reads them from the folder instead of making you emit every byte: curl -fsSL <origin>/agent.mjs -o .twocents/agent.mjs && FBL_ROOM=<room> node .twocents/agent.mjs --publish <dir>
| Argument | Type | Description |
|---|---|---|
| room | string | Room id to publish into. Omit to create a new room. |
| entry | string | Which page reviewers land on, if it is not already "index.html". Must be one of the paths in "pages"; its content is also stored as index.html so the review link opens it. |
| pages* | array | The pages of this set. Each item needs a "path" (the filename in the room, e.g. "index.html" or "plan.md") plus exactly one of "html" or "markdown". Link between them with plain relative hrefs; formats mix freely. |
| prune | boolean | Delete pages already stored in this room that are not in this request. Use it when republishing a set whose layout changed, so stale pages from the old layout do not linger unreachable. Default false — without it a room only ever accretes. |
| forkable | boolean |
{
"type": "object",
"required": [
"room",
"ids",
"creatorKey"
],
"properties": {
"by": {
"type": "string",
"description": "Who applied it, if you want it credited. Max 80 chars."
},
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Note ids to resolve — the `id:` field of each note in get_feedback output."
},
"room": {
"type": "string",
"description": "The room id the notes belong to."
},
"what": {
"type": "string",
"description": "One sentence on what you changed, shown to the reviewer beside their note. Max 400 chars."
},
"resolved": {
"type": "boolean",
"description": "Defaults to true. Pass false to reopen a note you resolved by mistake."
},
"creatorKey": {
"type": "string",
"description": "The room's creator key, returned by share_page when the room was created and kept in .twocents/state.json. For a room created before creator keys existed, the first key you present claims the room."
}
}
}| forkable | boolean | Whether reviewers may take their own copy of this page to work on (default true). Pass false for something you are circulating for comment but do not want handed onward — it hides the Fork button and makes the fork command refuse. It is a stated intent rather than a lock: anyone holding the review link can already read the page. |
| markdown | string | Markdown to render as a document, instead of "html". Use this for plans, specs, PR descriptions, summaries — anything you want a human to read and approve before you act. Pass exactly one of html or markdown. Max ~120 KB. |
| creatorKey | string | Only needed to change "forkable" on a room you created in an EARLIER session — the key that share_page returned then. New rooms are claimed automatically. |
{
"type": "object",
"anyOf": [
{
"required": [
"html"
]
},
{
"required": [
"markdown"
]
}
],
"required": [],
"properties": {
"html": {
"type": "string",
"description": "A complete, self-contained HTML document (inline CSS/JS/images — no local file references, they will 404 for reviewers). Max ~120 KB."
},
"path": {
"type": "string",
"description": "For multi-page sets: the filename this content lives at in the room (e.g. \"about.html\" or \"plan.md\"). Defaults to \"index.html\", the page reviewers land on. For a set of more than one page prefer share_pages, which publishes them all in one atomic request — sharing them one call at a time can leave a half-published room whose links point at pages that were never stored."
},
"room": {
"type": "string",
"description": "Room id from a previous share_page call, to update that page. Omit to create a new room."
},
"source": {
"type": "string",
"description": "Where this content came from, for whoever reads the feedback later — a project path like \"DROPS.md\" or \"public/p/foo/index.html\", or a note like \"drafted in this conversation, not yet a file\". You are the only one who knows this: twocents receives HTML, never a path, so if you omit it a future session gets reviewer notes with nothing to point them at the right file. get_feedback echoes it back verbatim."
},
"forkable": {
"type": "boolean",
"description": "Whether reviewers may take their own copy of this page to work on (default true). Pass false for something you are circulating for comment but do not want handed onward — it hides the Fork button and makes the fork command refuse. It is a stated intent rather than a lock: anyone holding the review link can already read the page."
},
"markdown": {
"type": "string",
"description": "Markdown to render as a document, instead of \"html\". Use this for plans, specs, PR descriptions, summaries — anything you want a human to read and approve before you act. Pass exactly one of html or markdown. Max ~120 KB."
},
"creatorKey": {
"type": "string",
"description": "Only needed to change \"forkable\" on a room you created in an EARLIER session — the key that share_page returned then. New rooms are claimed automatically."
}
}
}| Whether reviewers may take their own copy of this set (default true). Pass false to hide the Fork button and make the fork command refuse. A stated intent, not a lock. |
| creatorKey | string | Only to change "forkable" on a room created in an earlier session. |
{
"type": "object",
"required": [
"pages"
],
"properties": {
"room": {
"type": "string",
"description": "Room id to publish into. Omit to create a new room."
},
"entry": {
"type": "string",
"description": "Which page reviewers land on, if it is not already \"index.html\". Must be one of the paths in \"pages\"; its content is also stored as index.html so the review link opens it."
},
"pages": {
"type": "array",
"items": {
"type": "object",
"required": [
"path"
],
"properties": {
"html": {
"type": "string",
"description": "A complete, self-contained HTML document."
},
"path": {
"type": "string",
"description": "Filename in the room, e.g. \"notes.html\". Max 200 chars."
},
"source": {
"type": "string",
"description": "Where this page came from, e.g. a project path. Echoed by get_feedback."
},
"markdown": {
"type": "string",
"description": "Markdown to render as a document, instead of \"html\"."
}
}
},
"description": "The pages of this set. Each item needs a \"path\" (the filename in the room, e.g. \"index.html\" or \"plan.md\") plus exactly one of \"html\" or \"markdown\". Link between them with plain relative hrefs; formats mix freely."
},
"prune": {
"type": "boolean",
"description": "Delete pages already stored in this room that are not in this request. Use it when republishing a set whose layout changed, so stale pages from the old layout do not linger unreachable. Default false — without it a room only ever accretes."
},
"forkable": {
"type": "boolean",
"description": "Whether reviewers may take their own copy of this set (default true). Pass false to hide the Fork button and make the fork command refuse. A stated intent, not a lock."
},
"creatorKey": {
"type": "string",
"description": "Only to change \"forkable\" on a room created in an earlier session."
}
}
}