gen-mcp-server 0.1.15

GEN is an autonomous social media agent: it spots trends, writes scripts, and creates videos. Official MCP server for Claude Code, Cursor, and VS Code.

GEN — gen-mcp-server

GEN is an autonomous social media agent: it spots trends, writes scripts, and creates videos — across 10+ platforms, and publishes to TikTok, Instagram, Facebook, YouTube, and X. This is the official MCP server for GEN: everything the agent does, available from Claude Code, Cursor, or VS Code.

Every other tool does one step. GEN runs the whole loop:

Spot  →  Script  →  Create  →  Publish  →  Learn  →  repeat
trends    ideas     video      post       results

You're not operating a tool. You're directing an agent that does the work — then keeps doing it.

What you can do from your client

Spot trends — read what's actually working. Ask about any uploaded media attachment, video link, account, hashtag, trend, sound, hook, or comment and get a real answer from GEN's social warehouse (TikTok, Instagram, YouTube + more) plus media analysis when actual files are available: why a video performed, what's rising in a niche, an account's hooks and stats, how an audience is reacting. The agent reads trends before it creates — it doesn't generate blind.

Write scripts & ideas — turn the signal into a plan. Data-driven content ideas tuned to your niche, then readable scripts, narrations, ad reads, stories, and hooks built from what is already working.

Create videos — from idea to finished cut. Complete multi-scene videos (avatar, B-roll, captions, voice, music, render) — or any single piece on demand.

Publish & run it on autopilot. Post to TikTok, Instagram, Facebook, YouTube, and X; or hand the agent a standing goal and it runs the whole loop on a schedule — spot, script, create, publish — without you in the seat.

How you drive it

• gen_ask — ask GEN anything about real social data or media attachments (uploaded image/video/audio/doc/spreadsheet, YouTube/TikTok/Instagram link, account, hashtag, trend, sound, comment). One front door; the agent figures out what to pull or analyze.
• gen_generate_content_ideas / gen_research / gen_make_video — named shortcuts for the moves you reach for most. Use gen_generate_content_ideas(output="scripts") for direct spoken/readable script requests, purpose="voiceover" / "ad read" / "short story" when known, and script_only=true when the user asks for no explanation.
• gen_chat — hand the agent any open-ended, multi-step goal and let it run. Pass uploaded media refs in attachments when the goal depends on a file; leave YouTube/social links in the goal text.
• ~60 deterministic gen_* tools for exact single actions (create one image/video/song, render, schedule, manage assets/voices/credits).
• Ask "what can you do?" anytime — the agent lists its full, current playbook.

Quick start

pip install gen-mcp-server      # or: uvx gen-mcp-server

claude mcp add GEN --env GEN_API_KEY=your-pat -- gen-mcp-server

Cursor / VS Code: add a stdio server running gen-mcp-server with GEN_API_KEY set.

Get a Personal Access Token at gen.pro → log in → pick an agent → API page → Create API Key.

Setup

• Transport: stdio. Auth: GEN_API_KEY (Personal Access Token).

Var	Required	Default
GEN_API_KEY	yes	—
GEN_API_BASE_URL	no	https://api.gen.pro/v1
GEN_AGENT_API_URL	no	https://agent.gen.pro/v1
GEN_AGENT_CORE_API_URL	no	https://agent-core.gen.pro/v1

Credits

GEN is credit-based: generation, voice, and research cost credits; reads and CRUD are free. On an empty balance, tools return insufficient_credits and point you to gen_buy_credits. Price a job first with gen_estimate_job; check your balance with gen_get_credit_balance.

---

Built by GEN — the end of managing social media. · API docs