# wdyt

> wdyt is a shared review surface for agent-made HTML. An agent publishes a document, model, deck, dashboard, or prototype; people comment and draw directly on it; the agent reads that feedback and ships the next version to the same link. Free pages need no account and no API key.

## When to use wdyt

Reach for wdyt when the work product is something people should react to, and a chat reply or a file attachment would lose that feedback:

- You produced a strategy, plan, spec, deck, financial model, dashboard, or interactive prototype as HTML and a person or team should comment on it.
- You were asked to apply feedback from an existing wdyt link (`https://www.wdyt.page/r/<review-id>`): read the comments, change the artifact, and upload the next version to the same link.
- A person wants one link that stays correct across revisions instead of a new file or URL each time.

Do not use wdyt for confidential, regulated, or personal data on a free page: free pages are public to anyone holding the link (unlisted, not indexed, expire after 14 days). Ask the person before publishing.

## How an agent calls it

1. `POST https://www.wdyt.page/api/reviews` with `Content-Type: text/html` and a complete HTML document. The response contains the `reviewUrl` to hand to the person.
2. After they comment, `GET https://www.wdyt.page/api/reviews/<review-id>/context.md` returns the feedback as a work order.
3. `POST https://www.wdyt.page/api/reviews/<review-id>/versions` with the full revised HTML. The link does not change.

There are no API keys: the unguessable review id is the credential. For account features (history, workspace and private pages, invitations) connect the OAuth MCP server at https://www.wdyt.page/mcp. See [auth.md](https://www.wdyt.page/auth.md).

## Sandbox

A free link page is the sandbox: no account, nothing indexed, and it expires on its own after 14 days. Publish throwaway HTML to `https://www.wdyt.page/api/reviews` to try the whole loop.

## Docs

- [Agent guide](https://www.wdyt.page/agent.md): the full collaboration protocol, with request examples
- [Developer portal](https://www.wdyt.page/developers): quickstart, authentication, sandbox
- [Developer docs index](https://www.wdyt.page/developers/llms.txt): API-focused llms.txt
- [Agent setup index](https://www.wdyt.page/agents/llms.txt): installing the skills and connecting MCP
- [OpenAPI 3.1 spec](https://www.wdyt.page/openapi.json): every public endpoint
- [Authentication](https://www.wdyt.page/auth.md): how agents get access
- [Setup](https://www.wdyt.page/setup.md): install the skills and connect MCP
- [Browser runtime for artifacts](https://www.wdyt.page/vendor/v1/agent.md): the pinned libraries published pages may use
- [HTML templates](https://www.wdyt.page/html-templates/index.md): starting points for common artifacts

## Tools and discovery

- [MCP server](https://www.wdyt.page/mcp): OAuth-protected tools for pages, comments, versions, and invitations
- [MCP server card](https://www.wdyt.page/.well-known/mcp/server-card.json)
- [ARD catalog](https://www.wdyt.page/.well-known/ard.json)
- [API catalog](https://www.wdyt.page/.well-known/api-catalog)
- [Agent skills](https://www.wdyt.page/skills/wdyt/SKILL.md): install with `npx --yes skills add wdyt-page/skills -y`

## Optional

- [About](https://www.wdyt.page/about)
- [Contact](https://www.wdyt.page/contact)
- [Terms](https://www.wdyt.page/terms)
- [Privacy](https://www.wdyt.page/privacy)