Metadata-Version: 2.4
Name: gen-mcp-server
Version: 0.1.12
Summary: 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-URL: Homepage, https://gen.pro
Project-URL: Documentation, https://api.gen.pro
Project-URL: Repository, https://github.com/poweredbyGEN/gen-agentic
Author: GEN
License: MIT
Keywords: ai,content,gen,gen-pro,mcp,video
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# GEN — gen-mcp-server

<!-- mcp-name: io.github.poweredbyGEN/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](https://gen.pro): 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

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

```bash
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](https://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](https://gen.pro) — the end of managing social media. · [API docs](https://api.gen.pro)
