Skip to main content

@livepeer/agent is the agent runtime package from the Storyboard project (livepeer/storyboard). It provides a provider-agnostic agent loop, 40+ Livepeer inference capabilities as callable tools, working and session memory, and an MCP server mode for integration with Claude Code, Cursor, and other MCP-compatible tools. API key from daydream.live.

Installation

One-line installer (CLI on PATH + MCP auto-config):
The installer drops livepeer on your PATH and configures Claude Code / Cursor MCP entries automatically. npm (once 1.0.0 is published):
Homebrew (macOS):

CLI Verbs

The CLI exposes verbs for inference, file handling, finishing, and memory: Inference:
Finishing (FFmpeg-backed):
Discovery:
Memory:
All verbs emit JSON when stdout is piped. Use --json to force JSON on a TTY or --no-json to force human output when piped.

Library API

Importing individual verbs (without the full agent loop):
Provider swap: change the LLM backend without changing application code:

MCP Server Mode

@livepeer/agent runs as an MCP server over stdio, exposing all 40+ inference capabilities as MCP tools to Claude Code, Cursor, and any other MCP host:
Add to Claude Code (~/.claude/claude_desktop_config.json):
The one-line installer configures this automatically. Once connected, Claude Code can call livepeer tools directly: run flux-schnell, cinemagraph, concat, detect, and all other CLI verbs are available as MCP tool calls.

Configuration

Credentials live in ~/.livepeer/credentials:
Environment variable overrides take highest precedence: LIVEPEER_API_KEY or DAYDREAM_API_KEY, and LIVEPEER_SDK_URL.

Skills

Skills are markdown system prompt files that shape agent behaviour for specific tasks. The public registry is browsable and installable from the CLI:
Installed skills live in ~/.livepeer/skills/*.md and are loaded automatically by the agent runner when relevant.
@livepeer/agent is under active development through multiple phases (C8 is the current stable milestone). The CLI verb argument shapes and output shapes are frozen at C8; later phases (D–L) add new verbs without breaking existing ones.

Storyboard

The reference application built on @livepeer/agent and @livepeer/creative-kit.

MCP and Livepeer

Connecting Claude Code, Cursor, and other MCP tools to Livepeer.

Agents Overview

Eliza integration and BYOC agent patterns.

AI Pipelines

The underlying inference endpoints the agent SDK routes through.
Last modified on May 31, 2026