Instant provisioning, per-database API keys, branching, time-travel, vector search, and MCP discovery, on every plan including Free; some tools need a paid plan.
curl -X POST \
.../api/v1/quick-start \
-H "Content-Type: application/json" \
-d '{"email":"me@app.com",
"password":"...",
"username":"me",
"org_name":"MyApp",
"db_name":"main"}'
# Returns: token, api_key,
# org_id, db_id, endpointscurl -X POST .../execute \
-H "X-API-Key: hdb_..." \
-d '{"sql":"CREATE TABLE users (
id SERIAL,
name TEXT,
embed VECTOR(768)
)"}'# Create a branch
POST .../branches
{"name":"staging",
"as_of":"now"}
# Time-travel query
POST .../query-at
{"sql":"SELECT *...",
"as_of":"2025-01-01T00:00:00Z"}HeliosDB Cloud is the managed service: it runs HeliosDB Nano databases behind these endpoints. File storage (buckets and signed URLs) and edge functions are on the HeliosDB roadmap and are not part of HeliosDB Cloud or Nano today.
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/v1/quick-start | Create account + DB + API key |
POST |
/api/v1/auth/signup-baas | Instant signup (auto-activated) |
POST |
.../:db_id/execute | Execute SQL query |
GET |
.../:db_id/branches | List branches |
POST |
.../:db_id/branches | Create branch (with as_of + from) |
POST |
.../:db_id/branches/switch | Switch active branch |
POST |
.../:db_id/branches/merge | Merge branches |
POST |
.../:db_id/query-at | Time-travel query |
POST |
.../:db_id/api-keys | Create scoped API key |
POST |
/api/v1/mcp | MCP server (Streamable HTTP; protocol 2026-07-28 and 2025-03-26 to 2025-11-25) — API key or JWT required |
GET |
/api/v1/openapi.json | OpenAPI 3.1 specification |
/api/v1/mcpA remote MCP server that standard clients connect to directly — Claude Code, Cursor, VS Code, the MCP Inspector and the official TypeScript and Python SDKs (protocol 2026-07-28 and 2025-03-26 to 2025-11-25, stateless, no sessions). Configure your database API key as a static header: Authorization: Bearer hdb_... or X-API-Key: hdb_... (quick-start returns one; create more in the console under Databases → API Keys), or use a session JWT. There is no OAuth flow; anonymous calls get 401. Every tool runs the same checks as its REST endpoint — organization, database, scopes, tier — and a key works only for its own database; a refused call comes back as an isError result with the reason.
claude mcp add --transport http heliosdb https://cloud.heliosdb.com/api/v1/mcp \
--header "Authorization: Bearer $HDB_API_KEY"{ "mcpServers": { "heliosdb": {
"url": "https://cloud.heliosdb.com/api/v1/mcp",
"headers": { "Authorization": "Bearer hdb_..." } } } }curl -X POST https://cloud.heliosdb.com/api/v1/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $HDB_API_KEY" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'execute_sql
list_branches
create_branch
merge_branch
query_at
create_api_key
vector_search
analytics_query_stats
list_materialized_views
assign_variant
replication_status
delete_branch
list_databases
create_database
delete_database
All 27 tools in tools/list work over MCP, each with its JSON input schema — including list_databases, create_database, delete_database, verify_email, logout (session JWT only) and mark_trusted (platform operators only). Each tools/call counts against the monthly API request allowance. Account creation stays on REST (POST /api/v1/quick-start). The AI-native retrieval tools (helios_graphrag_search, heliosdb_hybrid_search, LSP tools) and the WebSocket/SSE transports come with a self-hosted HeliosDB Nano MCP server, a build-from-source feature.
Instant is the standard free level of the agent-ready BaaS: an API signup creates the account, database and key with no human step. Verifying the email address and completing a feedback session unlock higher quotas; no credit card is needed.
Sign up via BaaS — start in seconds
Confirm your email — quotas scale up
Opt in for feedback — max free quotas
All levels include: vector search, BM25-ranked full-text search, per-database API keys, branching, time-travel, AES-256-GCM encryption at rest and zero-knowledge encryption. Check “Allow feedback contact” during signup to reach the Feedback given level after a short feedback session with the team. Console accounts at cloud.heliosdb.com are for business email addresses and start at the Verified level; see HeliosDB Cloud.
One curl command. Your database is ready.