All tools on both endpoints are **read-only**, **non-destructive**, and **idempotent**. The parameter tables below are generated at build time from [`lib/starlight-mcp-catalog.ts`](https://github.com/frankxai/docs-platform/blob/main/lib/starlight-mcp-catalog.ts), so they cannot drift from the schemas the servers enforce.

## 1. Starlight substrate endpoint (`https://starlightintelligence.ai/mcp`) [#1-starlight-substrate-endpoint-httpsstarlightintelligenceaimcp]

### `list_department_packages` — List Starlight department packages

List release candidates and explicitly labeled research previews in the public Starlight Department OS catalog.

*Parameters:* None.

### `get_department_package` — Get a Starlight department package

Get the complete public manifest and distribution state for a Starlight Department OS release candidate. Research previews are not returned as packages.

| Parameter | Required | Type and limits |
|---|---|---|
| `slug` | Yes | one of `growth-studio` |

### `recommend_department` — Recommend a Starlight department

Compile deterministic product fit from a declared outcome, team shape, runtime, authority, and delivery preference. It never forces a research preview into a match.

| Parameter | Required | Type and limits |
|---|---|---|
| `outcome` | Yes | one of `growth`, `product`, `operations`, `people` |
| `team` | Yes | one of `solo`, `small`, `scaled` |
| `runtime` | Yes | one of `codex`, `claude`, `grok`, `openclaw`, `hermes`, `antigravity`, `mcp`, `a2a` |
| `autonomy` | Yes | one of `draft`, `propose`, `execute-reversible` |
| `delivery` | Yes | one of `self-serve`, `guided` |

### `compile_install_plan` — Compile a runtime distribution plan

Compile the current prerequisites, distribution gates, future installation steps, verification, rollback, and disclosures for one package and runtime. A plan never grants artifact availability, marketplace approval, or credentials.

| Parameter | Required | Type and limits |
|---|---|---|
| `slug` | Yes | one of `growth-studio` |
| `target` | Yes | one of `codex`, `claude`, `grok`, `openclaw`, `hermes`, `antigravity`, `mcp`, `a2a` |

### `atlas_search` — Search Starlight Atlas

Search public Atlas editorial drafts by keyword (query), domain or lens. Returns exact source revision, coverage and scoped article records; no inference or write.

| Parameter | Required | Type and limits |
|---|---|---|
| `query` | No | string, up to 200 characters |
| `domain` | No | string, up to 200 characters |
| `lens` | No | one of `foundation`, `frontier`, `historical`, `hypothesis` |
| `limit` | No | integer, 1 to 50 |
| `offset` | No | integer, 0 to 10000 |

### `atlas_get_article` — Get a Starlight Atlas article

Read one public Atlas draft with atomic claims, exact evidence locators, source versions, limitations and canonical source revision. Reading grants no publication authority.

| Parameter | Required | Type and limits |
|---|---|---|
| `slug` | Yes | string, up to 160 characters |

### `stack_summarize` — Summarize a declared AI stack

Calculate recurring costs by currency and native allowance/deadline context from a supplied Starlight stack. Manual declarations, not provider verification. No saved-account access or persistence.

| Parameter | Required | Type and limits |
|---|---|---|
| `stack` | Yes | object (fields below) |
| `stack.schema` | Yes | exactly `starlight.stack.v1` |
| `stack.plans` | Yes | list of objects (fields below), up to 50 |
| `stack.plans[].id` | Yes | string, matching `^[a-zA-Z0-9_-]+$`, up to 64 characters |
| `stack.plans[].provider` | Yes | string, up to 100 characters |
| `stack.plans[].account` | Yes | string, up to 100 characters |
| `stack.plans[].plan` | Yes | string, up to 100 characters |
| `stack.plans[].payer` | Yes | string, up to 100 characters |
| `stack.plans[].amount` | Yes | string, up to 20 characters, or null |
| `stack.plans[].currency` | Yes | string, matching `^[A-Z]{3}$` |
| `stack.plans[].interval` | Yes | one of `monthly`, `annual` |
| `stack.plans[].renewsOn` | Yes | string, date, or null |
| `stack.plans[].cancelBy` | Yes | string, date, or null |
| `stack.plans[].actions` | Yes | list of one of `code_generation`, `code_review`, `web_search`, `image_generation`, `video_generation`, `audio_generation`, `database_storage`, `edge_compute`, `deployment_hosting`, up to 9 |
| `stack.plans[].allowance` | Yes | object (fields below) |
| `stack.plans[].allowance.kind` | Yes | one of `unknown`, `credit_balance`, `key_budget`, `quota_used`, `images_remaining`, `tokens_remaining`, `storage_bytes_remaining` |
| `stack.plans[].allowance.value` | Yes | string, up to 20 characters, or null |
| `stack.plans[].allowance.checkedOn` | Yes | string, date, or null |
| `stack.plans[].allowance.resetsOn` | Yes | string, date, or null |

### `stack_plan` — Plan workflow actions against a declared stack

Match required workflow actions to user-declared capabilities. Returns verification requirements, never permission to dispatch or spend.

| Parameter | Required | Type and limits |
|---|---|---|
| `stack` | Yes | object (fields below) |
| `stack.schema` | Yes | exactly `starlight.stack.v1` |
| `stack.plans` | Yes | list of objects (fields below), up to 50 |
| `stack.plans[].id` | Yes | string, matching `^[a-zA-Z0-9_-]+$`, up to 64 characters |
| `stack.plans[].provider` | Yes | string, up to 100 characters |
| `stack.plans[].account` | Yes | string, up to 100 characters |
| `stack.plans[].plan` | Yes | string, up to 100 characters |
| `stack.plans[].payer` | Yes | string, up to 100 characters |
| `stack.plans[].amount` | Yes | string, up to 20 characters, or null |
| `stack.plans[].currency` | Yes | string, matching `^[A-Z]{3}$` |
| `stack.plans[].interval` | Yes | one of `monthly`, `annual` |
| `stack.plans[].renewsOn` | Yes | string, date, or null |
| `stack.plans[].cancelBy` | Yes | string, date, or null |
| `stack.plans[].actions` | Yes | list of one of `code_generation`, `code_review`, `web_search`, `image_generation`, `video_generation`, `audio_generation`, `database_storage`, `edge_compute`, `deployment_hosting`, up to 9 |
| `stack.plans[].allowance` | Yes | object (fields below) |
| `stack.plans[].allowance.kind` | Yes | one of `unknown`, `credit_balance`, `key_budget`, `quota_used`, `images_remaining`, `tokens_remaining`, `storage_bytes_remaining` |
| `stack.plans[].allowance.value` | Yes | string, up to 20 characters, or null |
| `stack.plans[].allowance.checkedOn` | Yes | string, date, or null |
| `stack.plans[].allowance.resetsOn` | Yes | string, date, or null |
| `actions` | Yes | list of one of `code_generation`, `code_review`, `web_search`, `image_generation`, `video_generation`, `audio_generation`, `database_storage`, `edge_compute`, `deployment_hosting`, up to 9 |

## 2. Estate documentation endpoint (`/api/mcp`) [#2-estate-documentation-endpoint-apimcp]

Available on `https://docs.starlightintelligence.ai/api/mcp` (and every brand docs host):

### `list_docs` — List verified estate documentation pages

List documentation pages across the estate (or for one brand), returning each page title, URL, markdown feed URL, verification status, checked date, and source files.

| Parameter | Required | Type and limits |
|---|---|---|
| `brand` | No | one of `starlight`, `frankx`, `gencreator`, `arcanea`, `akamoto` |

### `search_docs` — Search documentation with provenance citations

Search documentation across all five brands or a single brand. Returns matching pages with excerpt, canonical URL, checked date, and verified source file citations.

| Parameter | Required | Type and limits |
|---|---|---|
| `query` | Yes | string, up to 200 characters |
| `brand` | No | one of `starlight`, `frankx`, `gencreator`, `arcanea`, `akamoto` |
| `limit` | No | integer, 1 to 25 |

### `get_doc` — Read a documentation page as Markdown with provenance

Fetch the full processed Markdown body and frontmatter provenance (status, checked date, sources) for one documentation page by brand and slug.

| Parameter | Required | Type and limits |
|---|---|---|
| `brand` | Yes | one of `starlight`, `frankx`, `gencreator`, `arcanea`, `akamoto` |
| `slug` | Yes | string, up to 160 characters |

## Protocol & wire details [#protocol--wire-details]

- **Transport:** Streamable HTTP (`POST` with `content-type: application/json`).
- **2026-07-28 stateless handshake:** Clients may send `MCP-Protocol-Version: 2026-07-28` and `Mcp-Method` headers directly, or use the standard `initialize` → `tools/list` → `tools/call` JSON-RPC 2.0 sequence.
- **Example `2026-07-28` tool call:**

```bash
curl https://starlightintelligence.ai/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: list_department_packages" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_department_packages","arguments":{},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'
```