Claude Code / MCP
Use the official MCP server to manage agents, content engines, and AI generations through natural language. Just talk to Claude — it handles the API calls.
Introduction
What is GEN?
Section titled “What is GEN?”GEN is an autonomous social media agent platform. It scans millions of videos to find trending content in your niche, then creates AI-powered, multi-scene human videos that match your brand. Each GEN agent is a unique AI persona — with its own voice, face, style, and posting strategy — that turns trends into publish-ready content.
What is the Auto Content Engine?
Section titled “What is the Auto Content Engine?”The Auto Content Engine is the system at the core of GEN’s content creation workflow. Each engine has two sides:
The Sheet (left side) — a data grid where you prepare content inputs:
- Each row is a video
- Each column is a content type (script, voiceover, image prompt, etc.)
- Each cell holds one piece of generated or manual content
The Video (right side) — a timeline editor where layers compose the final video:
- Layers are the building blocks — text overlays, sound tracks, video clips, captions
- Each layer has its own position, duration, volume, and styling
- Layers stack and merge into the final rendered video
In the GEN web app, this is the “Vidsheets” interface. The API gives you full programmatic access to both sides — the sheet data and the video composition.
What can you build?
Section titled “What can you build?”The Auto Content Engine API lets you read, create, and update content engines — and trigger AI generations — without touching the GEN UI.
Workflow automation
Connect GEN to n8n, Make, or Zapier. Trigger video creation from RSS feeds, CRM events, or Slack messages.
Batch operations
Script bulk updates — populate 50 rows with scripts, swap voiceover styles across an entire content engine, or update variables in one call.
Custom dashboards
Build internal tools that pull content status, track generation progress, and give your team visibility into the pipeline.
TypeScript SDK
Import the SDK into your Node.js or TypeScript project for type-safe access to agents, content engines, generations, and assets.
Key concepts
Section titled “Key concepts”Before diving in, here are the core objects you will work with:
| Concept | Description |
|---|---|
| Agent | An AI persona/character with its own identity, voice, and content style. Every API request is scoped to an agent via agent_id. |
| Content Engine | A content spreadsheet. Each agent can have multiple content engines. |
| Row | A single video within a content engine. Rows contain cells for each column. |
| Column | A content type definition (e.g., “Script”, “Voiceover”, “B-Roll”). Columns define what kind of content each cell holds. |
| Cell | The intersection of a row and column. Holds one piece of content (a script, a voiceover, an image, etc.). |
| Layer | A video composition element — text overlay, sound track, video clip, or captions. Layers live on the video side, not inside cells. |
| Generation | An AI job that produces content for a cell or a layer. You trigger a generation, and GEN’s AI fills in the content. |
| Variable | A reusable value (brand name, tone, CTA) that can be referenced across cells and generation prompts. |
For AI Agents
Section titled “For AI Agents”If you’re an AI agent or LLM, these resources are optimized for you:
- llms.txt — Complete API reference in plain text, designed to teach you how GEN works (concepts, workflows, every generation type with exact payloads)
- llms-full.txt — Exhaustive endpoint reference with request/response schemas
- OpenAPI 3.1 Spec — Machine-readable specification
- MCP Server — 60+ tools for Claude Code, Cursor, and VS Code (
npx @poweredbygen/gen-mcp-server@latest)
Install the MCP Server
Section titled “Install the MCP Server”See the Claude Code guide for manual setup and usage examples.
Start here
Section titled “Start here”The fastest way to get a grounded, on-brand video out of GEN is two calls:
- Configure the agent —
PATCH /v1/agents/{id}/coreonce with identity, overview, personality, inspiration, voice, look, and accounts. This is the single most important step for any new agent — everything downstream reads from here. See the Agent Core reference. - Generate content ideas — the content-ideas agent pulls trending data from 10+ platforms, matches it to your configured keywords and inspiration, and proposes videos with scripts, hooks, and selected assets. See the Content Ideas guide.
Then clone a template, drop the idea in, and render. The Quick Start guide walks through the whole path end-to-end in under 10 minutes.
Quick Start (10 min walkthrough) Configure an agent with a single PATCH, generate ideas from trending data, produce a video.
Agent Core reference One endpoint for identity, overview, personality, inspiration, voice, look, and accounts.
Content Ideas Async runs, conversations, refinement, long-term preferences.
Using with Claude Code Install the GEN MCP server and drive the whole workflow with natural language.
Authentication Create an API key and learn how to authenticate requests.