Skip to content
Space Context for developers

Documentation

Space Context for developers

Film a space once, and your agents know it: an API, MCP server, CLI and SDK that turn a video of a physical space into structured, searchable context.

Open .md
Set up with your agent One prompt for Claude Code, Cursor, Codex or ChatGPT sets up the MCP server, the skill and the SDK; you only approve the sign-in.
  • Quickstart

    A free test key, the demo space, your first scan.

    5 minutes
  • API

    Every operation, parameter and response, from the contract.

    REST · OpenAPI 3.1
  • MCP server

    Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code.

    OAuth · remote
  • CLI

    Scan from the terminal, then search, ask and export.

    npx spacecontext
  • TypeScript SDK

    One call from a video to the document, with live progress.

    @spacecontext/sdk
  • Console

    Sign in, create keys, add a card, follow your scans.

    Keys · billing

Docs for agents

Every page is also plain Markdown at its URL with .md.

Space Context is the context layer for the physical world. Your agents know your code, your documents and your calendar; they know nothing about the places you live and work in. Film a space once, and they know it too.

It turns a video of a physical space (a flat, a holiday rental, an office, a van, an appliance) into a structured Space Document: every area, every item and where it is, its condition, what is broken, where the water shut-off and the fuse box are, how things work, with the original video frames as evidence. You read it, search it and ask it questions from your code, from the terminal or from an AI assistant.

Four ways in

Best forStart here
MCP serverGiving Claude (or any MCP client) read access to your spaces, without writing codeConnect an assistant
CLIScanning a video and exporting an Agent Skill from the terminalInstall the CLI
TypeScript SDKBuilding it into a Node.js, Deno or Cloudflare Workers app: one call from a video to the Space DocumentTypeScript SDK
REST APIBuilding it into your product in any language: JSON over HTTPS, with an OpenAPI 3.1 contractAPI overview

All four use the same account as the Space Context iPhone app, and the same API keys from the console.

What you can do

  • Scan a video (MP4, MOV, M4V, 3GP, WebM or Matroska, up to 4 GB and 10 minutes) or up to 120 photos. The analysis runs on our side; no ffmpeg needed (the CLI uses it, when installed, to compress a bigger video). → Scans
  • Read a space as JSON, by section. → The Space Document
  • Search across all your spaces, in any language: “where did I see a ladder?” → Search and ask
  • Ask one space a question and get a short answer with its sources and photos, or “not documented”. → Search and ask
  • Compare two scans of the same space: items added, removed, moved, issues new or resolved. → Skills and comparisons
  • Export a space as an Agent Skill folder that any agent can read. → Use a space in Claude Code
  • Get notified when a scan completes or fails. → Webhooks
  • Pay as an agent: an agent with USDC on Base or Solana buys credit and a key in one call, with no account and no card. → Agents that pay (x402)

Try it for free

A test key (sc_test_…) runs every flow for free on the demo space, two real scans of an apartment in Brisbane (photos at check-in, a narrated video at check-out): scans complete instantly, nothing is charged and none of your data is involved. Create one in the console and follow the quickstart.

The first live scan of a new account is free as well (one free scan per card). After that, live scans are paid from a prepaid balance. Live scans, and live keys that can scan, need a card on file: saved in the console without a charge, or a top-up already paid. See Billing.

Use these docs from an agent

Every page of this documentation is also served as plain Markdown (the page’s URL with .md), and the whole set comes in the formats agents read best:

For tooling: the OpenAPI contract (code generation, validation) and a ZIP of every page with the contract, for offline use.

Space Context docs · llms.txt · download Edit on GitHub

esc

↑↓ navigate↵ openesc close