Metadata-Version: 2.4
Name: gen-mcp-server
Version: 0.1.17
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, Facebook, YouTube, 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 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:

```bash
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:

```bash
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

```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.

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