Quickstart
Bring Seren Employees into your workflow
Start with Seren Desktop, or work with your employees in the hosted web app. Connect Seren MCP to Claude, Codex, or another MCP-compatible agent, use the CLI from a terminal or automation, or build employee workflows into an application with a typed SDK.
Before you begin
Choose one working connection
You need a Seren account and access to at least one employee. Choose hosted MCP when work starts in an AI assistant, the CLI for a terminal or automation, or an SDK when Seren is part of an application. By the end of the selected path, you will be able to list your employees and inspect their current activity.
Learn how employees and agent APIs fit togetherPath 1 - AI assistants
Connect hosted Seren MCP
Add Seren's hosted MCP address to Codex or Claude. The first time the assistant uses the server, your browser opens so you can sign in. You do not need to copy an API key into the assistant.
codex mcp add seren --url https://mcp.serendb.com/mcp
claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcpAfter authorization, ask for an overview:
List my Seren employees, then summarize each employee's health, recent activity, and pending approvals.You are connected when the assistant returns your employee list and can describe recent activity without asking for an API key.
Learn more about Seren MCPPath 2 - Terminals and CI
Work with employees from a terminal
Download the unified binary from GitHub Releases, or install it with Cargo. Browser login stores credentials in the selected Seren profile; JSON output is available for scripts and coding agents.
cargo install --git https://github.com/serenorg/seren.git --package seren-cli
seren auth login
seren me
seren -o json agent cloud overviewYou are connected when seren me identifies your account and the overview command returns employee state as JSON.
Path 3 - Applications
Use Seren from a TypeScript application
Install the SDK, set your Seren API key, and call the operation you need. The SDK handles the connection and authentication details for you.
pnpm add @serendb/sdkimport { serenAgentListDeployments } from "@serendb/sdk";
const { data, error } = await serenAgentListDeployments();
if (error) throw error;
console.log(data.data);Set SEREN_API_KEY and, when needed, SEREN_API_BASE before the process imports the SDK.
You are connected when the request completes without an authentication error and data.data contains the deployments available to the API key.
Next