HTTP API reference
Public Starlight and Docs Platform HTTP endpoints for catalogues, recommendations, install plans, team plans, Atlas search, and documentation feeds.
LiveChecked against
starlightintelligence.ai/app/api/v1/, docs-platform/app/api/mcp/route.ts, docs-platform/app/api/search/route.ts, docs-platform/proxy.tsThese endpoints return public catalogues, deterministic plans, and source-verified documentation. None of them execute remote code, store customer secrets, or mutate external accounts.
Starlight platform endpoints (https://starlightintelligence.ai)
| Method | Path | What it returns |
|---|---|---|
GET | /api/v1/departments | Release candidates and explicitly labeled research previews |
GET | /api/v1/departments/growth-studio | Complete public package manifest and contract |
POST | /api/v1/recommend | Deterministic package recommendation from five declared inputs |
POST | /api/v1/install-plan | Prerequisites, distribution gates, verification, and rollback steps for a target runtime |
POST | /api/v1/agent-kits/plan | Isolated Railway agent sizing and permissions plan (provisions nothing) |
POST | /api/v1/team-plan | Proposed role profiles (2 to 144); see plan an agent team |
GET | /api/v1/atlas | Atlas keyword/domain/lens search; see research with Atlas |
GET | /.well-known/agent.json | Public agent capabilities and authority boundary manifest |
curl https://starlightintelligence.ai/api/v1/install-plan \
-H "content-type: application/json" \
-d '{"slug":"growth-studio","target":"codex"}'Documentation & agent feed endpoints (docs.<brand>)
| Method | Path | What it returns |
|---|---|---|
GET | /llms.txt | Brand-scoped index of all documentation pages (or full estate index on the Atlas root) |
GET | /llms-full.txt | Complete Markdown bundle of every page in the brand |
GET | /<slug>.md | Raw processed Markdown with verified provenance header for any page |
GET | /api/search?q=<query>&brand=<key> | Brand-scoped Orama full-text search results |
GET | /api/mcp | Server discovery metadata and tool descriptors for the docs MCP server |
POST | /api/mcp | JSON-RPC 2.0 Streamable HTTP MCP endpoint (list_docs, search_docs, get_doc) |
Schemas & specifications
- Department package schema:
https://starlightintelligence.ai/schemas/starlight.department.v1.json - Evidence draft schema:
https://starlightintelligence.ai/schemas/starlight.department_evidence_draft.v1.json - External format compatibility: Packages align with the Agent Skills and Agent Plugins specifications.
MCP tools reference
Every tool on the public Starlight MCP endpoint and this documentation platform's /api/mcp server, generated directly from code schemas.
What is live, in preview, or not available
One verified table of what you can use today, what returns plans only, what is in preview, and what does not exist yet.