GEN MCP Server

GEN MCP Server

⚠️ The downloadable package is deprecated — use https://mcp.gen.pro

This is the FINAL PyPI release of gen-mcp-server. GEN no longer ships adownloadable MCP: the official GEN MCP is the hosted server athttps://mcp.gen.pro. No further versions will be published to PyPI.

The package still works so existing integrations have a migration window, butit will not receive new tools, fixes, or API updates — the hosted server isalready ahead of it and is the only surface kept in sync with the GEN API.Installing it emits a DeprecationWarning; the stdio CLI prints a notice tostderr on start.

Use the official hosted MCP (all clients)

No install. Point your MCP client at the hosted endpoint and authenticate withyour GEN Personal Access Token (from https://gen.pro — log in, pick an agent,open the API page in the sidebar, click Create API Key):

{
  "name": "gen",
  "url": "https://mcp.gen.pro",
  "headers": { "Authorization": "Bearer gen_pat_…" }
}

(Existing configs using https://mcp.gen.pro/mcp keep working.)

Claude Code:

claude mcp add --transport http gen https://mcp.gen.pro \
  --header "Authorization: Bearer gen_pat_…"

Manus: Settings → Integrations → Custom MCP Servers → Add Server

• Server URL: https://mcp.gen.pro
• Authentication: Bearer token → your gen_… PAT

claude.ai connectors / ChatGPT: add a custom MCP connector with the sameURL + bearer token.

The hosted server is multi-tenant — each caller acts as their own GEN identity;your PAT scopes everything you can see and do.

What it is

MCP (Model Context Protocol) server for the GEN platform — lets Claude and anyMCP-compatible AI drive the GEN Auto Content Engine + Agent Core: the full5-step journey from onboarding an agent to publishing a video.

Step 1           Step 2            Step 3              Step 4             Step 5
──────           ──────            ──────              ──────             ──────
Set Up    →    Generate    →     Idea to      →     Edit &      →     Export &
Agent          Ideas             Vidsheet            Generate           Publish

Read the gen://api-reference MCP resource for the full teaching document, andapi.gen.pro for the API reference. Tool descriptionsstart with the step name (e.g. "Step 4 (Edit & Generate): …") so AI tooling canroute quickly.

Legacy local install (deprecated — migrate to the hosted URL above)

The stdio mode still functions for the migration window:

uvx gen-mcp-server           # or: pip install gen-mcp-server && gen-mcp-server
export GEN_API_KEY=your-api-key

It prints a deprecation notice to stderr on start. Do not build newintegrations on it; use https://mcp.gen.pro.

Optional base-URL overrides (legacy stdio only):

export GEN_API_BASE_URL=https://api.gen.pro/v1
export GEN_AGENT_API_URL=https://agent.gen.pro/v1
export GEN_AGENT_CORE_API_URL=https://agent-core.gen.pro/v1

Development (this repo stays alive — it IS the hosted server)

This repository remains the source of the hosted mcp.gen.pro deployment; onlythe PyPI distribution is retired.

git clone https://github.com/poweredbyGEN/gen-mcp-server.git
cd gen-mcp-server
uv venv && . .venv/bin/activate
uv pip install -e .
GEN_MCP_PORT=8080 gen-mcp-server --http   # hosted streamable-http mode, serves `/` and `/mcp`

See also

• API Docs: api.gen.pro — full API reference and guides
• TypeScript SDK: github.com/poweredbyGEN/gen-typescript-sdk

Changelog

1.0.0 — FINAL PyPI RELEASE (deprecation pointer)

• The downloadable package is deprecated; the official GEN MCP is the hostedserver at https://mcp.gen.pro (GEN-4785)
• DeprecationWarning on import when installed from PyPI; stderr notice onstdio CLI start. Hosted (--http) mode is unaffected
• Includes everything on main at cut time, including the Python/FastMCP rewrite(GEN-3788) and the 2026-07-30 tool additions (billing, social, schedule,assets, generation, compose — 31 tools) never previously published

0.5.0

• Restructured all 81 tools around the 5-step user journey (GEN-2879)
• Rewrote the embedded gen://api-reference resource as a step-by-step teaching document with chained curl examples
• Tool descriptions now start with the phase (e.g. "Step 1 (Agent Setup): …") so AI tooling can route quickly

0.4.x

• Added Agent Core flat endpoints (GEN-2755)
• Stripped vendor branding from tool descriptions
• Added gen_run_research, expanded API_REFERENCE with agentic chat docs
• Content monitoring + publishing tools

License

MIT