twocents-mcp

# twocents — human feedback for AI agents (MCP server)

A remote [MCP](https://modelcontextprotocol.io) server, live at **`https://twocents.page/mcp`**.
Connect it and your AI agent can send any HTML page to real people for visual
review — and read their pinned notes back. No auth, no API key, no install for
reviewers.

## Tools

- **`share_page`** — send a self-contained HTML document, get back a review link.
  Anyone who opens it can pin notes directly on the page — no login, works on any
  device. Call again with the same room id and connected reviewers see the update
  live.
- **`get_feedback`** — the pinned notes, returned as markdown with the anchor
  text/selector for each note so your agent can find and fix the exact spot. Pass
  the optional `handled` array (note ids already decided in earlier sessions) and
  those collapse to one line each, so the response leads with what's new.

## Config

```json
{
  "mcpServers": {
    "twocents": {
      "url": "https://twocents.page/mcp"
    }
  }
}
```

## Connect

**Claude Code**

```bash
claude mcp add --transport http twocents https://twocents.page/mcp
```

**Claude.ai** (web or desktop) — Settings → Connectors → *Add custom connector* →
paste `https://twocents.page/mcp`

**Cursor or any MCP client** — use the config block above (an HTTP MCP server; no
auth, no API key).

## The loop

Ask your agent to *"share this page for feedback"* → send the link to anyone →
they pin notes on the live page → ask your agent to *"get the feedback"* and apply
it. The whole review cycle without leaving your editor.

## What's in this repo

The complete server source: [`mcp.js`](./mcp.js) — a zero-dependency Streamable
HTTP (stateless) JSON-RPC handler, ~300 lines. It runs inside a Cloudflare Worker
and stores pages/notes in a Durable Object per review room (`env.ROOMS`); the
Worker, relay, and reviewer UI live in the main (private) twocents.page codebase.
[`server.json`](./server.json) is the [MCP registry](https://registry.modelcontextprotocol.io)
manifest (`page.twocents/twocents`).

Privacy model: a room id is an unguessable capability — knowing it is the
permission to read/write that room. Review links are excluded from search
indexing.

## See it in action

Every page in our [interactive explainer library](https://twocents.page/p/) has a
live review room — open one and pin a note. Or [get feedback on your own
work](https://twocents.page/start).