# weft

> A hosted MCP for Claude. Build websites you can talk to.

weft lets you build and edit AI-discoverable websites entirely through chat with Claude. Each site is a real GitHub repository and Vercel project that you own; weft orchestrates the build, edit, and deploy steps via the Model Context Protocol.

Sites built with weft ship with Schema.org JSON-LD, /llms.txt, /api/site.json, sitemap, and Open Graph tags baked in by default — they are discoverable and citable by AI search the moment they deploy.

## Install

1. In Claude Desktop or claude.ai: Settings → Connectors → Add Custom Connector
2. URL: https://weft.fyi/api/mcp
3. Sign in with GitHub. Paste a Vercel personal access token. Done.

Then, in chat: "make me a site for my band, dark theme, accent in rust."

## Tools (Model Context Protocol)

- create_site(brief): provision a new GitHub repo + Vercel project; generate initial content from the brief; deploy.
- edit_site(siteId, instruction): apply a chat-driven edit; one atomic commit; auto-redeploy.
- regenerate_site(siteId, brief): rewrite canonical content from a fresh brief; same repo, same domain.
- list_sites(): list sites you have created.
- deploy_status(siteId): latest Vercel deploy state (QUEUED / BUILDING / READY / ERROR).
- undo_last_change(siteId): non-destructive revert of the most recent commit.
- set_domain(siteId, domain): attach a custom domain to a site's Vercel project.
- upload_media(siteId, filename, base64): upload an image to public/media/.

## Architecture

Two-speed sites:

- Slow lane (canonical) — human-approved facts, static, indexed by AI search. Edited only via the chat-with-site MCP tools.
- Fast lane (dynamic, coming soon) — visit-time personalization, an on-site /chat agent, and self-improving improvement-PR agents. The dynamic layer never invents facts.

Stack: Next.js 15 + Drizzle + Neon Postgres on Vercel. OAuth 2.1 with RFC 7591 Dynamic Client Registration and RFC 7636 PKCE. GitHub identity (no separate signup). Per-user Vercel token (paste once). Generated sites use Astro with @astrojs/sitemap.

## Pages

- [Home](https://weft.fyi/)
- [Source on GitHub](https://github.com/timncox/weft)
- [MCP endpoint](https://weft.fyi/api/mcp)
- [OAuth metadata](https://weft.fyi/.well-known/oauth-authorization-server)

## About this file

This file follows the /llms.txt convention to help large language models discover and cite weft accurately. weft generates one for every site it builds — and serves one for itself.