Skip to main content

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.

Project description

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, 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 video link, account, hashtag, trend, sound, hook, or comment and get a real answer from GEN's social warehouse (TikTok, Instagram, YouTube + more): 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 the scripts and hooks to make them.

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, 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 (a link, account, hashtag, trend, sound, comment). One front door; the agent figures out what to pull.
  • gen_generate_content_ideas / gen_research / gen_make_video — named shortcuts for the moves you reach for most.
  • gen_chat — hand the agent any open-ended, multi-step goal and let it run.
  • ~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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gen_mcp_server-0.1.11.tar.gz (42.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gen_mcp_server-0.1.11-py3-none-any.whl (47.3 kB view details)

Uploaded Python 3

File details

Details for the file gen_mcp_server-0.1.11.tar.gz.

File metadata

  • Download URL: gen_mcp_server-0.1.11.tar.gz
  • Upload date:
  • Size: 42.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for gen_mcp_server-0.1.11.tar.gz
Algorithm Hash digest
SHA256 7829147d2986bc238b7f0dc71e9a48b88d9029974b631790e928da70e874f335
MD5 2bff6b813a3e3d37b1187a1ef197510e
BLAKE2b-256 3ac2e4e8914d67dedce3d0b652c4a1687310f3a062689fd9e47e00f79c8ec720

See more details on using hashes here.

File details

Details for the file gen_mcp_server-0.1.11-py3-none-any.whl.

File metadata

File hashes

Hashes for gen_mcp_server-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 edea567020b3d20982e95bcc529d1f1cca762930871b26307a67923dd3593e06
MD5 f2fd64541bdb9f9ab3cc5781af9b9b61
BLAKE2b-256 66e6da263606e6da18f850fa4923dbf76e7af40f54f769c3e87f66b3d29e2544

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page