# Alexandria

> Company context layer — a registry of everything a company knows (docs, code, notes, transcripts, skills), indexed for humans and AI agents. Hybrid search, an LLM-maintained wiki, REST API, and MCP.

## Docs

- [Product docs & quickstart](https://alexandria.page/docs)
- [Human quickstart](https://alexandria.page/docs#humans)
- [Agent / API quickstart](https://alexandria.page/docs#agents)
- [Core concepts](https://alexandria.page/docs#concepts)
- [REST endpoint list](https://alexandria.page/docs#api)

## API

- Base URL: https://api.alexandria.page
- MCP endpoint: https://api.alexandria.page/mcp
- Health (no auth): GET https://api.alexandria.page/health

## Auth

- Create API keys in the web app at https://alexandria.page/app/settings
- Send `Authorization: Bearer alx_...` on all `/v1/*` and `/mcp` requests
- Keys are scoped to a single workspace

## Endpoints

- `POST /v1/sources` — create source (`title`, `source_type`, `tier`; `content` or `url` required for managed/indexed)
- `GET /v1/sources` — list (`source_type`, `status`, `tags`, `q`)
- `GET /v1/sources/:id` — fetch content (`return_mode`, `query`)
- `POST /v1/search` — hybrid search (`query`, optional `filters`, `top_k`, `return_mode`)
- `GET /v1/wiki/index` — wiki index
- `GET /v1/wiki/pages?path=` — read wiki page (`return_mode`, `query`)
- `POST /v1/wiki/pages` — write wiki page (`path`, `content`)
- `GET /v1/wiki/log` — maintainer log (`tail`)
- `POST /v1/notes` — create managed note (`title`, `content`)
- `GET /v1/skills` — list skill sources
- `GET /v1/skills/:id` — fetch skill (`return_mode`, `query`)
- `ALL /mcp` — MCP Streamable HTTP (tools: search_context, fetch_source, add_source, write_note, read_wiki_page, search_wiki, list_skills, fetch_skill)

## Return modes

Used on search and content fetch endpoints:

- `raw` — full text (default for search)
- `headroom` — compressed for context windows
- `llm_extract` — verbatim line ranges relevant to `query`

## Source tiers

- `managed` — Alexandria stores and indexes content
- `indexed` — content ingested for search
- `pointer` — metadata / URI only

## Plans

Managed at https://alexandria.page/app/settings/billing

- Free — $0 — 2 members, 50 sources, 200 searches/mo
- Team — $29/mo — 10 members, 1,000 sources, 5,000 searches/mo
- Pro — $99/mo — 25 members, 10,000 sources, 50,000 searches/mo

## Product surfaces

- Web app: https://alexandria.page (sign up → onboarding → /app)
- Landing: https://alexandria.page/
- Docs: https://alexandria.page/docs

## Contact

- Email: hello@alexandria.page