How do I install the Spacetimedb HTTP skill?

Run npx skillmds@latest add danmossa/spacetimedb-http in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Spacetimedb HTTP safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Spacetimedb HTTP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Spacetimedb HTTP free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Spacetimedb HTTP?

danmossa (@danmossa) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Spacetimedb HTTP by danmossa — Agent Skill

Name: Spacetimedb HTTP
Author: danmossa

Spacetimedb HTTP

Use when calling SpacetimeDB HTTP endpoints for identity, database operations, reducer calls, SQL execution, schema metadata, logs, energy endpoints, or authorization headers. Triggers on: HTTP API, REST, Authorization header, bearer token, /v1/identity, /v1/database, HTTP reducer call, HTTP SQL.

danmossa 614adbb 4 files · 25.0 KB Updated Sep 17, 2026

File contents

Use this skill for SpacetimeDB HTTP route behavior and request construction.

Core HTTP patterns

Most HTTP endpoints accept Authorization: Bearer <token>. Without it, database endpoints usually allocate or use an anonymous identity with public-table access only.
POST /v1/identity returns { "identity": string, "token": string }.
POST /v1/database/:name_or_identity/call/:reducer invokes a reducer or procedure. The request body is a JSON array of arguments.
POST /v1/database/:name_or_identity/sql runs one or more SQL statements separated by ; and returns JSON statement results with schema and rows.
GET /v1/database/:name_or_identity/schema?version=... returns RawModuleDef JSON and maps to spacetime describe.
GET /v1/database/:name_or_identity/logs requires database ownership and maps to spacetime logs.
WebSocket subscriptions use /v1/database/:name_or_identity/subscribe with the v1.bsatn.spacetimedb or v1.json.spacetimedb subprotocol; prefer SDKs unless building custom tooling.

Request cautions

Management endpoints are primarily for tooling, debugging, and administration; use SDK WebSocket clients for normal app traffic.
Anonymous HTTP reducer calls pass an anonymous identity to ReducerContext; module auth logic may reject them.
HTTP SQL sees only public rows for anonymous callers and is subject to RLS.
Route SQL syntax to spacetimedb-sql before writing non-trivial query strings.

Reference map

Need	Open
Authorization headers and ping	references/http-authorization.md
Database endpoints	references/http-database.md
Identity endpoints	references/http-identity.md

Guidance

Include the required bearer token behavior when giving endpoint examples.
Route SQL syntax questions to spacetimedb-sql.
Route SDK connection questions to spacetimedb-clients.

---name: spacetimedb-httpdescription: Use when calling SpacetimeDB HTTP endpoints for identity, database operations, reducer calls, SQL execution, schema metadata, logs, energy endpoints, or authorization headers. Triggers on: HTTP API, REST, Authorization header, bearer token, /v1/identity, /v1/database, HTTP reducer call, HTTP SQL.license: MIT---Use this skill for SpacetimeDB HTTP route behavior and request construction.## Core HTTP patterns- Most HTTP endpoints accept `Authorization: Bearer <token>`. Without it, database endpoints usually allocate or use an anonymous identity with public-table access only.- `POST /v1/identity` returns `{ "identity": string, "token": string }`.- `POST /v1/database/:name_or_identity/call/:reducer` invokes a reducer or procedure. The request body is a JSON array of arguments.- `POST /v1/database/:name_or_identity/sql` runs one or more SQL statements separated by `;` and returns JSON statement results with `schema` and `rows`.- `GET /v1/database/:name_or_identity/schema?version=...` returns `RawModuleDef` JSON and maps to `spacetime describe`.- `GET /v1/database/:name_or_identity/logs` requires database ownership and maps to `spacetime logs`.- WebSocket subscriptions use `/v1/database/:name_or_identity/subscribe` with the `v1.bsatn.spacetimedb` or `v1.json.spacetimedb` subprotocol; prefer SDKs unless building custom tooling.## Request cautions- Management endpoints are primarily for tooling, debugging, and administration; use SDK WebSocket clients for normal app traffic.- Anonymous HTTP reducer calls pass an anonymous identity to `ReducerContext`; module auth logic may reject them.- HTTP SQL sees only public rows for anonymous callers and is subject to RLS.- Route SQL syntax to [spacetimedb-sql](../spacetimedb-sql/SKILL.md) before writing non-trivial query strings.## Reference map| Need | Open || ------------------------------ | -------------------------------------------------------------------- || Authorization headers and ping | [references/http-authorization.md](references/http-authorization.md) || Database endpoints | [references/http-database.md](references/http-database.md) || Identity endpoints | [references/http-identity.md](references/http-identity.md) |## Guidance- Include the required bearer token behavior when giving endpoint examples.- Route SQL syntax questions to [spacetimedb-sql](../spacetimedb-sql/SKILL.md).- Route SDK connection questions to [spacetimedb-clients](../spacetimedb-clients/SKILL.md).

Frequently asked questions