Install the GEN MCP

The GEN MCP gives your AI assistant access to GEN’s content studio: trend research, content ideas, Vidsheets, AI video, images, voices, songs, assets, scheduling, watchlists, recurring jobs, and credits.

Mint Personal Access Token

Claude Manus Codex

Remote MCP

Use this when your MCP client supports a remote MCP server over Streamable HTTP. Copy this into your MCP client:

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

Replace gen_pat_your_key_here with a GEN API key from Settings -> API Keys in gen.pro.

Command-line clients

Claude Code and other CLI clients connect to the same hosted server:

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

The GEN MCP is hosted-only — there is no package to install or local process to run.

How the MCP fits with the GEN agent

For Vidsheet editing, MCP forwards typed actions to the GEN API, which owns validation, creation-card behavior, ownership, and persistence. GEN’s chat plans over that MCP surface. Natural-language tools such as gen_chat and gen_ask delegate to GEN’s agent service; this delegation is separate from the Vidsheet editing path.

• Exact edit → discover supported fields with gen_discover, then call gen_vidsheet_action. Read saved state with the gen_discover sheet view (include=["full"] for the whole dump). See Work with a Vidsheet for draft, generation, and layer examples.
• Fuzzy goal → gen_chat (build something) or gen_ask (question about social data). The agent plans, calls the tools, and returns a run_id you poll with gen_get_run_status.

Older per-target Vidsheet mutation tools are retired; use the action/discovery workflow above. Job lifecycle remains separate: gen_stop_generation stops a job, and gen_continue_generation continues an owned stopped job using credits and a stable retry key. See lifecycle and retry details.

Previously used the local package?

The downloadable gen-mcp-server package (PyPI, uvx gen-mcp-server) is retired and no longer served. Remove it and use the hosted config above. A client already configured with https://mcp.gen.pro/mcp keeps working — that path is still accepted.

What It Can Do

Use your client’s tools/list for the current tool set and gen://api-reference for guidance. For Vidsheet edits, start with the action and discovery guide.

Area	What your assistant can do
Ask GEN	Use gen_chat, gen_ask, gen_run_research, and gen_generate_content_ideas for natural-language work
Create media	Generate supported videos, images, songs, and voices; final-video rendering is unavailable through hosted MCP
Build Vidsheets	Read a sheet with the gen_discover sheet view, discover card/settings schemas with gen_discover, and use gen_vidsheet_action for supported structure, drafts, media, and generation
Manage assets	List libraries, create direct uploads, import media from URLs, rename assets, and delete assets
Run strategy workflows	Create content ideas, query watchlists, research trends, and manage recurring jobs
Publish	Connect social accounts, schedule posts, update schedules, edit supported metadata on published posts, and remove scheduled posts
Manage account data	List agents, workspaces, organizations, API keys, avatars, credit balance, usage, and plans

Credits and x402

GEN MCP tools use workspace credits for paid generation, research, voice, and song work. Saving a Vidsheet draft or changing its properties does not start generation. Check balance with gen_get_credit_balance and estimate paid jobs with gen_estimate_job.

To add credits:

• For Stripe, use gen_list_credit_plans, then gen_buy_credits.
• For USDC via x402, use gen_create_x402_credit_purchase, then gen_settle_x402_credit_purchase with the signed payment.

When a paid tool cannot run because the workspace lacks credits, MCP returns a structured result with status: "payment_required", status_code: 402, funding_error_kind: "out_of_credits", Stripe and x402 payment_options, and the original call under retry. This is not a completed operation. Show the payment choices and obtain approval; after payment succeeds, retry the same MCP tool once with the same arguments. MCP never purchases credits automatically.

The x402 quote lists every configured network when you omit network. Present those choices instead of assuming one chain. See Credits for signing and settlement details.

Workspace funding wallets are backend infrastructure for settlement and sweeping. MCP clients should present the returned payment methods, not ask users to hunt for hidden workspace wallets.

The hosted server is the official GEN MCP — every client connects to https://mcp.gen.pro.