GitHub - serenorg/seren: Seren CLI & MCP

Seren is an agent-ready backend control plane for managed agents, secure vault access, skills, model services, and supporting backend resources. It gives developers and AI coding agents one way to run Seren Employees on Seren Cloud, provision encrypted password vault access, install reusable skills, route model usage, manage branchable Postgres and object storage, and use payment flows when production work needs them. Every capability is reachable from the terminal, an SDK, or an MCP-compatible assistant.

What Seren Provides

Seren is useful when an application or agent needs durable backend capabilities it can operate directly. The tooling exposes the operational surface around the platform so agents can inspect state, make changes, run services, access approved credentials, and recover from problems with the same primitives a backend engineer would use.

How Agents Connect

Seren exposes the same platform through three interfaces:

These same tools power the broader Seren product. Seren Desktop is the open-source AI workspace for knowledge workers and engineers - chat, skills, reusable employees, files, notes, memory, local terminals, and connected accounts - and the CLI and MCP server in this repo are the service layer those agents run on: managed agents, vaults, skills, model access, databases, storage, payments, approvals, and operator controls.

graph TB
    Agent[AI assistant or developer] --> MCP[Seren MCP server]
    Agent --> CLI[seren CLI]
    App[Rust application] --> SDK[Rust SDK]
    MCP --> API[SerenAI API]
    CLI --> API
    SDK --> API
    API --> Cloud[Seren Employees and cloud runs]
    API --> Vaults[Seren Passwords]
    API --> Skills[Skills and model services]
    API --> DB[SerenDB projects and branches]
    API --> Storage[Object storage]
    API --> Publishers[Publishers and payments]

Skill Ecosystem

Seren skills are installable capability packs for coding agents. The seren CLI pulls from a public registry (serenorg/seren-skills) and installs a skill into the skills directory of whatever agent you use - Claude Code, Codex, Cursor, Gemini, GitHub Copilot, Windsurf, and more - so one skill works across agents instead of being tied to a single assistant. Many skills are built around Seren publishers, so an installed skill teaches an agent to call that integration, run SQL, or drive a managed agent through the Seren backend.

seren skills search issues              # discover skills in the registry
seren skills add linear-issue-tracking  # install into your agent's skills directory
seren skills installed                  # list installed skills
seren skills init my-skill              # scaffold your own

Quick Start

Connect an AI Assistant

If your MCP client supports streamable HTTP, connect it to the hosted Seren MCP endpoint:

claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcp

Manual MCP configuration:

{
  "mcpServers": {
    "seren": {
      "url": "https://mcp.serendb.com/mcp",
      "transport": "streamable-http"
    }
  }
}

After authorization, ask your assistant to deploy managed agents, review cloud runs, retrieve approved vault credentials, fetch skill guidance, inspect projects, run SQL, create branches, manage storage, or use publisher payment flows. See mcp/README.md for local server setup, OAuth hosting, Seren Passwords delegation, x402 signing, and tool examples.

Install and Use the CLI

cargo install --git https://github.com/serenorg/seren.git --package seren-cli

seren auth login
seren -o json agent cloud overview
seren skills search issues
seren projects list
seren projects create --name my-project --region aws-us-east-1
seren branches --project-id <project-id> create --name dev

See cli/README.md for the command reference and common workflows.

Use the Rust SDK

[dependencies]
seren = { git = "https://github.com/serenorg/seren.git", tag = "v0.8.0" }

use seren::{Client, ClientConfig};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ClientConfig::new("seren_your_api_key");
    let client = Client::from_config(&config)?;

    let projects = client.seren_db_list_projects().await?;
    println!("Found {} projects", projects.into_inner().data.len());

    Ok(())
}

The seren crate is generated from the Seren OpenAPI spec, and typed clients for other languages can be generated from the same source.

Packages

Installation

From Source

git clone https://github.com/serenorg/seren.git
cd seren
cargo build --release
cargo install --path cli

The MCP server is built into the same seren binary:

Pre-Built Binaries

Pre-built seren binaries are published on GitHub Releases for each tagged version: https://github.com/serenorg/seren/releases

Each release ships seren for macOS, Linux, and Windows. The MCP server is included in the same binary.

Development

Prerequisites

• Rust 1.85+ (edition 2024)
• PostgreSQL for MCP OAuth mode and integration tests

Common Commands

cargo build --workspace
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all

Project Structure

seren/
|-- api/            # Rust SDK - OpenAPI-generated type-safe client
|-- cli/            # CLI tool - clap-based platform management
|-- mcp/            # MCP server - stdio, HTTP, and OAuth modes
|   |-- oauth/      # OAuth 2.1 + PKCE implementation
|   |-- wallet/     # x402 crypto payment support
|   `-- migrations/ # Embedded SQL migrations
|-- openapi/        # OpenAPI spec source for SDK codegen
|-- docker/         # Dockerfiles
`-- Cargo.toml      # Workspace configuration

Documentation

• CLI Reference
• SDK Reference
• MCP Server
• Managed Agents Guide
• SerenDB Documentation

Support

• Documentation: https://docs.serendb.com
• Issues: https://github.com/serenorg/seren/issues
• Discord: https://discord.gg/jseg7q4KS7

License

MIT License. See LICENSE for details.