Get started

Javascript SDK

Agents build on a real API

Agents build against the Backlit Javascript SDK, a small browser library that AI-generated static apps (glows) use at runtime, giving you the signed-in user’s identity, read and write access to glow-shared data, per-user data, and owner-scoped records, realtime change events, and write-only telemetry.

It loads from one script tag with no build step, and every method is async with typed errors. The full reference is published as Markdown and a TypeScript declaration, so an agent can read the whole surface without scraping HTML, and task guides walk through the common jobs, from migrating an existing app to adding realtime and push.

Read the SDK docs →

Or read it the way an agent would: sdk.md, sdk.d.ts, llms.txt, and llms-full.txt (the whole reference plus every guide in one fetch).

For AI agents

Agents deploy without asking

Backlit is built for two surfaces, and the agent surface is first-class. An AI agent can discover the platform, create a glow, push HTML, set an allowlist, and roll back, entirely on a user’s behalf, without a human touching a dashboard.

MCP server

Add Backlit as a custom connector once; your assistant gets a set of tools to build and deploy glows in the chat. No API keys to copy.

https://mcp.backlit.run/mcp
REST deploy API

A documented OpenAPI surface at a stable URL. Per-glow keys are scoped, revocable, and stored hash-only. Deploy and rollback are transactional.

https://glow.backlit.run/openapi.yaml
agent · REST deploy
# Upload a new version, a gzipped tar bundle of the site
curl -X POST https://glow.backlit.run/v1/glows/{id}/deploy \
  -H "Authorization: Bearer blk_..." \
  -F bundle=@site.tar.gz
 
# The live pointer flips in the same transaction, no partial state.
# Roll back instantly to any prior version:
curl -X POST https://glow.backlit.run/v1/glows/{id}/rollback \
  -H "Authorization: Bearer blk_..." \
  -d '{"version_id":"v-2026-05-24-abc"}'
Add Backlit to Claude
  1. Open Settings → Connectors (web: claude.ai/settings/connectors).
  2. Click Add custom connector.
  3. Name it Backlit and paste https://mcp.backlit.run/mcp.
  4. Click Connect and sign in to authorize.
  5. Make your open chat aware of it. A conversation you already had running won’t notice the new connection on its own. Start a new chat, or tell Claude “Check your connections and use Backlit,” then ask it to publish.
Add Backlit to ChatGPT
  1. Open Settings → Connectors and enable Developer mode.
  2. Click Create (or Add custom connector).
  3. Name it Backlit and paste https://mcp.backlit.run/mcp.
  4. Set authentication to OAuth, click Connect, and sign in.
  5. Allow the deploy host glow.backlit.run, then turn on the Backlit connector in a chat.
  6. Make your open chat aware of it. An open conversation won’t load the new connector by itself. Start a new chat, or tell ChatGPT “Use the Backlit connector,” then ask it to publish.