MCP

​

What MCP may do

• Read balance: tool credits (same payload as GET /api/v1/credits/balance). Free.
• Spend: billable tools/call (Instant Post submit, take_screenshot, kitchen renders). Deduct on success only.
• Free: Instant Post poll / zip / list, get_job, credits, initialize, tools/list.

​

What MCP must not do

​

Instant Post

• Submit: url (website or YouTube / LinkedIn / Instagram / TikTok), or idea_prompt, plus existing video inputs. No extra submit fields.
• Poll: pack summary when completed (clips, stills, captions, studio_url). zip.url is null until you call zip.
• Zip: on-demand CDN JSON (zip_url), not bytes through MCP.
• List: recent Instant Post jobs.

​

Client configs

{
  "mcpServers": {
    "screencrafter": {
      "url": "https://api.screencrafter.io/api/v1/mcp",
      "headers": { "X-API-Key": "sc_live_YOUR_KEY" }
    }
  }
}

claude mcp add --scope user --transport http screencrafter https://api.screencrafter.io/api/v1/mcp \
  --header "X-API-Key: sc_live_YOUR_KEY"

[mcp_servers.screencrafter]
url = "https://api.screencrafter.io/api/v1/mcp"
http_headers = { "X-API-Key" = "sc_live_YOUR_KEY" }

[mcp_servers.screencrafter]
url = "https://api.screencrafter.io/api/v1/mcp"
headers = { "X-API-Key" = "sc_live_YOUR_KEY" }