These 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`) [#starlight-platform-endpoints-httpsstarlightintelligenceai]

| 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](/starlight/team-planning) |
| `GET` | `/api/v1/atlas` | Atlas keyword/domain/lens search; see [research with Atlas](/starlight/atlas) |
| `GET` | `/.well-known/agent.json` | Public agent capabilities and authority boundary manifest |

```bash
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>`) [#documentation--agent-feed-endpoints-docsbrand]

| 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 [#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](https://agentskills.io/specification) and [Agent Plugins](https://agent-plugins.org/specification) specifications.