Docs · MCP server
Let AI assistants build websites with JustCopy
JustCopy's MCP server lets an AI assistant (ChatGPT, Claude, Cursor or any client that speaks the Model Context Protocol) build, change and publish a website for a person's business. The assistant describes the business; JustCopy writes the site with sign-in, saved data and photo uploads built in, and puts it online.
Connect
- Add the server https://justcopy.ai/mcp to your MCP client (in Claude: Settings → Connectors → Add custom connector; in Claude Code: claude mcp add --transport http justcopy https://justcopy.ai/mcp).
- The client opens JustCopy's sign-in. The person signs in (or creates a free account) and allows access.
- Ask the assistant for a website. It calls create_site, then get_site until the site is ready, and shares the link.
Tools
| Tool | What it does | Arguments | Returns |
|---|---|---|---|
| list_sites | The person's websites, newest first, with status and public link. Permission: See your websites. | limit (optional, 1–50) | sites: siteId, name, status, liveUrl, studioUrl |
| create_site | Builds a new website or simple web app from a plain description. Returns at once; the build runs for one to three minutes. Permission: Build and change websites. | description (the business and what the site should have) | siteId, name, status "building", studioUrl |
| get_site | Status of one site, its links, what the builder said and suggested next changes. Can wait for a running build. Permission: See your websites. | siteId, waitSeconds (optional, up to 20) | status (building, ready, live, needs_upgrade, failed), liveUrl, studioUrl, lastReply, suggestions, upgradeUrl |
| change_site | Makes a change the person asks for, in plain words. Paid plans; on the free plan get_site returns an upgrade link. Permission: Build and change websites. | siteId, request | siteId, status "building" |
| publish_site | Puts a built site online at a public link, free on every plan. Publishing again updates it. Permission: Publish websites. | siteId, address (optional subdomain) | liveUrl |
Builds take one to three minutes, so create_site and change_site return straight away and get_site reports progress. No call holds a connection open for minutes, which keeps it working in every client.
Sign-in and permissions
- OAuth 2.1 with PKCE (S256). Authorization server metadata:
https://justcopy.ai/.well-known/oauth-authorization-server; protected resource metadata:https://justcopy.ai/.well-known/oauth-protected-resource/mcp. - Clients register themselves (dynamic client registration) or present a Client ID Metadata Document.
- Permissions:
sites:read(see your websites),sites:write(build and change websites),sites:publish(put websites online). - Access tokens last one hour; refresh tokens rotate. The person can revoke access at any time.
- Every call acts as the signed-in person, on their own websites only, within their own plan.
Plans and limits
- Free plan: build websites (3 builds a day, up to 5 sites) and publish them with a small JustCopy badge.
- Changing a site after its first build, your own domain and no badge are part of the paid plans, from $9.99 a month. When a step needs a paid plan the tool says so and returns an upgradeUrl for the person.
- Up to 120 requests a minute per account.
Protocol
Streamable HTTP, stateless. The server answers both the 2026-07-28 revision and the initialize-era revisions (2025-11-25, 2025-06-18, 2025-03-26), so older and newer clients connect to the same address. Tool results carry structured content matching each tool's output schema; error details travel in _meta.