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.12.tar.gz (42.8 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.12-py3-none-any.whl (47.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: gen_mcp_server-0.1.12.tar.gz
  • Upload date:
  • Size: 42.8 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.12.tar.gz
Algorithm Hash digest
SHA256 49794aac90b927e0cc31084522bf6eab1369bcd3f7ef3f5614ba7f4983c7a9dc
MD5 a284d983639bd64c7a0923db63da2b49
BLAKE2b-256 a6c17257a00778ba312dca6fd61d648c9299bc7e0448e89371c8382ccc68321c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for gen_mcp_server-0.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 4ae25736a0f7c41156a6fb9ca8aedb6818480b6b980d90f2833b2ebd845c3e80
MD5 12a5240025e0d521bf8be564a402190b
BLAKE2b-256 2275e0579f27fc52864cd42ddb555ab328ff53f2a343565357a559ff7d82afb7

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