# Sketch

> Sketch turns a brand (from a URL) into on-brand marketing assets: creative posts, carousels,
> landing pages, presentations, infographics, and short-form videos with AI voice + music. Agents
> can drive the whole thing over MCP or a small REST API.

## Use it as an AI agent (MCP — recommended)

Streamable-HTTP MCP endpoint: `https://sketch.protaige.com/api/mcp`

- Auth: send your key as `Authorization: Bearer sk_...`. Connectors that can't set headers may append
  `?key=sk_...` to the endpoint URL (aliases: `api_key`, `apiKey`, `token`).
- `GET https://sketch.protaige.com/api/mcp` returns the server info + tool names (a probe; the JSON-RPC traffic is POST).
- No key needed for the guest tools: `audit_site`, `decompose_layers`.

Tools:
- `audit_site` { url } — scored brand/marketing audit of any public site. **No account needed.**
- `decompose_layers` { imageUrl, action? } — split an image into editable layers. **No account needed.**
- `list_brands` {} — the brands on your account (get a brandId for generation).
- `generate_content` { type, brandId, prompt } — make an asset. type ∈ creative|carousel|landing|
  presentation|infographic|video|demo-video.
- `update_content` { id, title?, prompt?, regenerate? } — edit or regenerate a saved asset.
- `list_content` {} — recent generated assets.
- `plan_campaign` { brandId, goal, cadence?, weeks?, startDate? } — a dated campaign calendar.
- `get_campaign` { campaignId } — status of a planned campaign.
- `publish_content` { contentId|mediaUrl, text?, mode? } — post/schedule to a connected social account.
- `list_domains` {} — custom domains on the account.

## REST API (v1)

Auth: `Authorization: Bearer sk_...` on every call.

- `GET https://sketch.protaige.com/api/v1/brands` — list your brands.
- `POST https://sketch.protaige.com/api/v1/brands` — create a brand. Body `{ "url": "https://…" }` (scan a site) or
  `{ "brand": { … } }` (bring your own). Returns `{ id, name, … }`.
- `POST https://sketch.protaige.com/api/v1/generate` — `{ "type", "brandId", "prompt", "channels"?, "voiceId"?,
  "videoModel"?, "sourceContent"? }`. Light types return `{ artifact }`; heavy types return
  `{ jobId, poll }` (poll the returned URL until done).
- `GET|PATCH|DELETE https://sketch.protaige.com/api/v1/content/{id}` — read, edit, or delete a saved asset.

## Getting a key

Create an API key in **Settings → Developers** (https://sketch.protaige.com/settings) or on the guide page
https://sketch.protaige.com/use-with-ai. Keys are prefixed `sk_`. Requests without a valid key get a 401 with a message
telling you exactly where to create one; the two guest tools above still work without one.

## Free / no-account capabilities

You can `audit_site` and `decompose_layers` with no account or key at all — good for a first taste,
up to 10 calls per day. After that (or for anything brand-specific — list/generate/campaigns/publish)
create a free account + key; the error tells you exactly where.