gen-mcp-server 0.1.25

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.

Direct posting API: POST https://agent.gen.pro/v1/post with your GEN PAT in X-API-Key. Send schedule_type: "now" to publish immediately, or schedule_type: "specific_time" with an ISO8601 scheduled_time to post later.

Post now:

curl -X POST https://agent.gen.pro/v1/post \
  -H "X-API-Key: YOUR_GEN_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_ID",
    "platform": "instagram",
    "media_url": "https://assets.gen.pro/videos/example.mp4",
    "description": "Launch day",
    "schedule_type": "now"
  }'

Post later:

curl -X POST https://agent.gen.pro/v1/post \
  -H "X-API-Key: YOUR_GEN_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "YOUR_AGENT_ID",
    "platform": "instagram",
    "media_url": "https://assets.gen.pro/videos/example.mp4",
    "description": "Launch day",
    "schedule_type": "specific_time",
    "scheduled_time": "2026-06-25T18:00:00Z"
  }'

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.

Hosted (Manus / claude.ai connectors / ChatGPT)

Cloud agents connect to a URL instead of launching a local process. GEN hosts the same server over streamable HTTP at https://mcp.gen.pro/mcp — each caller sends its own PAT as a bearer token (multi-tenant).

Manus: Settings → Integrations → Custom MCP Servers → Add Server

• Server URL: https://mcp.gen.pro/mcp
• Authentication: Bearer token → your gen_… PAT

Self-host the HTTP transport: gen-mcp-server --http (serves 0.0.0.0:8080/mcp; override with GEN_MCP_HOST / GEN_MCP_PORT). Callers authenticate with Authorization: Bearer <gen_PAT>.

Setup

• Transport: stdio (local clients) or --http streamable HTTP (hosted).
• Auth: GEN_API_KEY env (stdio) or Authorization: Bearer <PAT> (hosted).

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