Seren

Official Rust SDK, CLI, and MCP server for SerenAI - the team behind SerenDB, a serverless Postgres platform with built-in agent commerce and micropayments.

Packages

Package	Description	How to use
api	Rust SDK (seren crate)	Add as a Git or path dependency
cli	Command-line interface (binary seren)	Install from source or GitHub Releases
mcp	MCP server for AI assistants	Use the hosted endpoint, or run seren mcp start after installing the CLI

Quick Start

MCP Server (AI Integration)

Connect Claude or other AI assistants to SerenAI:

# Claude Code (recommended - no local install needed)
claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcp

Or configure manually for Claude Desktop:

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

See mcp/README.md for local server setup and all configuration options.

CLI

# Install from a local checkout (see Installation below for source/binary options)
cargo install --path cli

# Login and start managing databases
seren auth login
seren projects list
seren projects create --name my-project --region aws-us-east-1

Rust SDK

[dependencies]
seren = { git = "https://github.com/serenorg/seren.git", tag = "v0.6.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.list_projects(None, None, None).await?;
    println!("Found {} projects", projects.into_inner().data.len());

    Ok(())
}

Installation

From Source

git clone https://github.com/serenorg/seren.git
cd seren

# Build all packages
cargo build --release

# Install the CLI binary (the MCP server is built in; run it with `seren mcp start`)
cargo install --path cli

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 (Apple Silicon and Intel), Linux (gnu and musl, on x86_64 and aarch64), and Windows (x86_64). The MCP server is built into the same binary; run it with seren mcp start.

Development

Prerequisites

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

Building

# Build all packages
cargo build --workspace

# Run tests
cargo test --workspace

# Lint
cargo clippy --workspace --all-targets -- -D warnings

# Format
cargo fmt --all

Project Structure

seren/
|-- api/            # Rust SDK - OpenAPI-generated type-safe client
|-- cli/            # CLI tool - clap-based database 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: cli/README.md
• SDK Reference: api/README.md
• MCP Server: mcp/README.md
• API Documentation: docs.serendb.com

License

MIT License - see LICENSE for details.

Support

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