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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49794aac90b927e0cc31084522bf6eab1369bcd3f7ef3f5614ba7f4983c7a9dc
|
|
| MD5 |
a284d983639bd64c7a0923db63da2b49
|
|
| BLAKE2b-256 |
a6c17257a00778ba312dca6fd61d648c9299bc7e0448e89371c8382ccc68321c
|
File details
Details for the file gen_mcp_server-0.1.12-py3-none-any.whl.
File metadata
- Download URL: gen_mcp_server-0.1.12-py3-none-any.whl
- Upload date:
- Size: 47.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4ae25736a0f7c41156a6fb9ca8aedb6818480b6b980d90f2833b2ebd845c3e80
|
|
| MD5 |
12a5240025e0d521bf8be564a402190b
|
|
| BLAKE2b-256 |
2275e0579f27fc52864cd42ddb555ab328ff53f2a343565357a559ff7d82afb7
|