# Seren Docs

> Seren is a backend control plane for agent-backed applications: Seren Employees, agent services, auth, passwords, skills, models, branchable Postgres, file storage, publisher APIs, MCP, and SDKs.

Base API URL: `https://api.serendb.com`

Canonical OpenAPI 3.1 document: `/openapi.json`

## Recommended Starting Points

- Product overview: `/`
- Five-minute quickstart for hosted MCP, CLI, or TypeScript: `/quickstart`
- How Seren Employees and the underlying agent platform fit together: `/how-seren-works`
- Best practices for defining, connecting, reviewing, and improving employees: `/best-practices`
- Generated API explorer: `/api`
- OpenAPI schema browser: `/schemas`
- Machine-readable schema index: `/schemas/index.json`
- SDK installation and first requests in TypeScript, Python, and Rust: `/sdks`
- CLI and MCP workflows: `/cli`
- Configure and revise a managed Seren Employee: `/guides/configure-a-managed-employee`
- Connect Codex, Claude, Cursor, Gemini CLI, OpenCode, and other MCP clients: `/guides/connect-mcp-clients`
- TypeScript SDK: `pnpm add @serendb/sdk`
- Python SDK: `pip install seren-sdk`
- Rust SDK: `seren-sdk = "0.8"`
- Seren CLI binaries: `https://github.com/serenorg/seren/releases`
- Hosted MCP: `https://mcp.serendb.com/mcp`
- Codex hosted MCP: `codex mcp add seren --url https://mcp.serendb.com/mcp`
- Install Seren Employees skill: `npx skills add serenorg/skills --skill seren-employees`
- Install all Seren skills: `npx skills add serenorg/skills --all`
- List Seren skills: `npx skills add serenorg/skills --list`

## Using Seren Docs With an LLM

Give a web-enabled LLM the URL of the most relevant Seren documentation page as its starting point. Ask it to read this `/llms.txt` index to discover related product and guide pages, then use `/llms-full.txt` or `/openapi.json` when it needs exact API details. Stable operation pages use `/api/operations/{operation_id}` and link back to the interactive explorer.

The rendered docs include a "Copy for LLM" action that creates this prompt with absolute URLs for the current deployment.

## API Reference Formats

Seren publishes one merged OpenAPI 3.1 document for all services. There are not separate OpenAPI files for each product. Use the service path prefixes below to locate a product within the shared contract.

- Interactive API explorer: `/api`
- Canonical OpenAPI contract: `/openapi.json`
- Complete generated text reference: `/llms-full.txt`
- Stable human-readable operation page: `/api/operations/{operation_id}`
- OpenAPI schema browser: `/schemas`
- Machine-readable schema index: `/schemas/index.json`

## Service API References

- Seren Employees: product docs `/employees`; concepts `/how-seren-works`; best practices `/best-practices`; filtered API explorer `/api?q=/publishers/seren-agent`; shared OpenAPI path prefix `/publishers/seren-agent/*`; managed-employee guide `/guides/configure-a-managed-employee`. Seren Employees are the managed product, while the underlying APIs retain the Seren Agent name.
- Seren Cloud: filtered API explorer `/api?q=/publishers/seren-cloud`; shared OpenAPI path prefix `/publishers/seren-cloud/*`. These APIs cover deployments, runs, sessions, approvals, evaluations, schedules, environments, audit records, connectors, and deployment storage.
- Seren Auth: filtered API explorer `/api?q=/auth`; shared OpenAPI path prefix `/auth/*`. These APIs cover users, agent accounts, sessions, email verification, password reset, and organization invitations.
- Seren Passwords: product docs `/passwords`; filtered API explorer `/api?q=/publishers/seren-passwords`; shared OpenAPI path prefix `/publishers/seren-passwords/*`; credential guide `/guides/grant-a-credential`.
- Seren Skills: product docs `/skills`; filtered API explorer `/api?q=/publishers/seren-skills`; shared OpenAPI path prefix `/publishers/seren-skills/*`.
- Seren Memory: product docs `/memory`; filtered API explorer `/api?q=/publishers/seren-memory`; shared OpenAPI path prefix `/publishers/seren-memory/*`; workflow guide `/guides/store-and-recall-memory`.
- Seren DB: product docs `/db`; filtered API explorer `/api?q=/publishers/seren-db`; shared OpenAPI path prefix `/publishers/seren-db/*`; branching guide `/guides/branch-a-database`.
- Seren Storage: product docs `/storage`; filtered API explorer `/api?q=/publishers/seren-storage`; shared OpenAPI path prefix `/publishers/seren-storage/*`.
- Seren Notes: filtered API explorer `/api?q=/publishers/seren-notes`; shared OpenAPI path prefix `/publishers/seren-notes/*`.
- Seren Models: filtered API explorer `/api?q=/publishers/seren-models`; shared OpenAPI path prefix `/publishers/seren-models/*`.
- Seren Private Models: filtered API explorer `/api?q=/publishers/seren-private-models`; shared OpenAPI path prefixes `/publishers/seren-private-models/*`, `/publishers/seren-agent/private-models`, and `/organizations/{organization_id}/private-models-policy`.
- Publisher platform: filtered API explorer `/api?q=/publishers`; shared OpenAPI paths `/publishers/*` plus related billing, payment, and wallet operations. Publisher guides are intentionally not part of the public navigation yet; use the API contract as the source of truth.

## Authentication

Use a Seren API key as a bearer token:

```http
Authorization: Bearer your_seren_api_key
```

The docs API explorer can show demo responses without credentials. Paste a user-owned API key on the page to run live GET requests through the docs proxy.

Hosted MCP uses browser-based OAuth and does not require copying an API key into the assistant. CLI automation and SDK applications can use `SEREN_API_KEY`; all SDKs and the CLI support `SEREN_API_BASE` when a non-default API host is required.