GEN MCP server

Read from the package source without running it. The installed server may list more.

• gen_ask

  Ask GEN a question about real social media data and get an answer. THIS IS THE TOOL FOR ANY QUESTION ABOUT A VIDEO LINK, ACCOUNT, HASHTAG, TREND, SOUND, HOOK, COMMENT, OR CREATOR — across TikTok, Instagram, YouTube, and more.

• gen_buy_creditswrite action

  Start a credit purchase (Stripe checkout) — returns a payment link the user opens to pay. CONFIRM the plan + price with the user BEFORE calling; this spends real money. Use when the user is out of credits.

• gen_chat

  The CATCH-ALL: do anything the GEN chat product can BUILD or compose that no more specific tool covers — e.g. 'duplicate this row and make it punchier', 'turn this idea into a vidsheet', 'restructure this sheet for a 3-part series', or any multi-step goal that chains several actions. Delegates to the GEN agent composer which plans + executes across the platform (create vidsheet -> generate scenes

• gen_clone_engine

  Clone a vidsheet into the same or a different agent.

• gen_clone_template

  Clone a template into an agent as a ready-to-use vidsheet.

• gen_clone_voice

  Clone a voice from an audio sample (paid).

• gen_create_enginewrite action

  Create a new empty vidsheet (content engine) for an agent.

• gen_create_imagewrite action

  Generate an image. `version` selects the Gemini image model: 'nano-banana-pro' (Gemini 3 Pro Image — highest quality, default here), 'nano-banana' (2.5 Flash), or 'nano-banana-2' (3.1 Flash). 2K output. aspect_ratio one of 1:1 | 9:16 | 16:9. Paid — returns a job to poll.

• gen_create_recurring_jobwrite action

  Create a recurring task that runs the given prompt on a schedule — e.g. prompt='create a 16:9 video about my niche', cadence='daily'. The fired job runs the same composer as chat, so it can generate + render video. Set auto_publish to post automatically when ready.

• gen_create_rowwrite action

  Create a new row (e.g. a new scene) in a vidsheet.

• gen_create_songwrite action

  Generate one original song/music track from a text prompt.

• gen_create_song_mixwrite action

  Create a DJ-style song-mix job that combines multiple songs/tracks into one long audio output. Use for requests like "mix these 5 songs", "combine these tracks into one long song", or "create 5 songs and combine them". Do NOT use for plain song creation/generation; use gen_create_song for that. Provide at least two `tracks` unless `generate_missing_count` is set. Each track can include title, arti

• gen_create_song_mix_from_fileswrite action

  Upload local audio files into the agent's GEN assets, then create a DJ-style song-mix job from those uploaded asset ids. Use when a local MCP client such as Claude Code has MP3/WAV/OGG/WebM files on disk and the user asks to combine or mix them together. Do NOT use for plain song creation/generation; use gen_create_song for that.

• gen_create_videowrite action

  Generate ONE raw video clip from a single text prompt. `model` one of: seedance-1.0-lite/1.0-pro/1.5-pro/2.0, veo_3(_1), kling_2_1/2_6, sora_2, pika, grok. Seedance 2.0 supports duration 4-15s. Paid — returns a job to poll with gen_get_generation.

• gen_create_voicewrite action

  Create/save a custom voice (from a prior design/clone generation).

• gen_delete_assetwrite action

  Delete a content resource.

• gen_delete_recurring_jobwrite action

  Delete a recurring job.

• gen_delete_scheduled_postwrite action

  Delete a scheduled post from the calendar.

• gen_design_voice

  Design a new voice from a text description (paid). Returns a job.

• gen_disconnect_social

  Disconnect a connected social account (tiktok/instagram/youtube/x) from the agent. Use when the user wants to unlink a platform.

• gen_duplicate_row

  Duplicate a row (with its values) — e.g. to repeat a scene template.

• gen_estimate_job

  Estimate the credit cost of one or more generation jobs BEFORE running them. Free to call. Pair with gen_get_credit_balance to check affordability.

• gen_generate_content_ideas

  Generate data-driven content ideas tuned to what's working right now in the agent's niche (GEN's content-ideas engine). Use this when the user wants IDEAS / suggestions for what to post — 'give me content ideas', 'what should I make this week', 'ideas for my brand'.

• gen_get_agent

  Get a single agent's details.

• gen_get_agent_core

  Read the agent's full setup/brand profile in one call (identity, brand, voice, monitored items, linked accounts) — the Setup page state.

• gen_get_asset

  Get a content resource including its downloadable CDN url.

• gen_get_cell

  Get a cell's value, metadata, layers, and generations.

• gen_get_credit_balance

  Get the agent's available credit balance. Check before paid ops.

• gen_get_credit_usage

  List credit transactions / usage history for analysis (e.g. 'how many credits did I spend on video this week?'). Read-only.

• gen_get_engine

  Get a vidsheet with its columns, rows, cells, and layers.

• gen_get_generation

  Poll a generation/job until status is completed | failed | stopped. On completion the output URL(s) arrive in the result/output_resources.

• gen_get_me

  Get the authenticated user's profile and workspace memberships. Call first to verify your GEN_API_KEY and discover your workspaces.

• gen_get_run_statuswrite action

  Poll an agent run started by gen_ask / gen_chat (status + messages + plan).

• gen_get_social_connect_url

  Get an OAuth URL the user opens in a browser to connect a social account for publishing. platform: youtube | tiktok | instagram | x.

• gen_get_template

  Get a single template by slug or id.

• gen_import_asset_from_url

  Import media from a public URL (YouTube/TikTok/Instagram/direct file) into the agent's assets. No length limit — use for long B-roll to combine into longer videos. Returns a job; poll the import status.

• gen_list_agents

  List agents, optionally filtered by organization/workspace. Use the returned agent_id for all downstream content operations.

• gen_list_assets

  List the agent's content resources / asset library (images, video, audio). Optional type filter.

• gen_list_columns

  List all columns in a vidsheet.

• gen_list_connected_socials

  List which social accounts (tiktok/instagram/youtube/x) the agent has connected for publishing. Call this before scheduling/publishing a post, or to check whether the user still needs to connect a platform.

• gen_list_credit_plans

  List available credit / subscription plans (to buy or upgrade).

• gen_list_my_voices

  List the agent's own custom/created voices.

• gen_list_recurring_jobs

  List the agent's recurring jobs (daily/weekly tasks).

• gen_list_rows

  List all rows in a vidsheet.

• gen_list_scheduled_posts

  List scheduled posts (the content calendar), optional date range. Returns an empty list when the agent has no calendar yet (not an error).

• gen_list_templates

  List available vidsheet templates (faceless YouTube, auto-clip podcast, animated series, AI influencer, etc.). Cloning one is the 80% path.

• gen_list_voices

  List available voices (optionally filtered by provider).

• gen_list_workspaces

  List all workspaces (organizations) you can access.

• gen_make_video

  Make a FINISHED, multi-scene video from a natural-language brief — GEN plans the scenes, writes the script, generates the footage/voice, and renders a complete video. Use this for 'make a video about X', 'create a 30s TikTok on X', 'turn this idea into a video'.

• gen_pause_recurring_job

  Pause a recurring job.

• gen_render_video

  Render the final composed video for a final_video cell — combines all layers/rows (the scenes) into ONE deliverable. This is how you assemble a long / multi-scene video. Returns a generation_id; poll gen_get_generation.

• gen_research

  Research a topic across social + the web — trending content, top creators/accounts in a niche, and community/news signal. Use this for open 'research X' / 'who's winning in X' / 'what's happening with X' requests: 'research the cold plunge niche', 'top creators in #fitness', 'what are people saying about <topic> on Reddit and X'.

• gen_resume_recurring_job

  Resume a paused recurring job.

• gen_run_recurring_job_nowwrite action

  Trigger a recurring job to run immediately (don't wait for its schedule).

• gen_schedule_postwrite action

  Schedule/create a post. platform: tiktok|instagram|youtube|x. schedule_type 'now' for immediate, 'specific_time' (+scheduled_time ISO8601) for a calendar slot.

• gen_stop_generation

  Stop a running generation (refunds the pre-charged credits).

• gen_update_agent_corewrite action

  Update agent setup/brand fields (brand_name, description, keywords, video_type, target_platforms, etc.). Sparse — send only what changes.

• gen_update_cellwrite action

  Update a cell's value (e.g. set a scene's script or prompt).

• gen_update_recurring_jobwrite action

  Update a recurring job (name, prompt, schedule, delivery, auto_publish).

• gen_update_scheduled_postwrite action

  Update a scheduled post (time, description, media, etc.).

• gen_upgrade_workspace

  Upgrade a workspace to a higher subscription tier — returns a checkout link. CONFIRM with the user BEFORE calling; this changes billing.

• gen_version

  Return the running GEN MCP server version. Use when the user asks 'what version of the GEN MCP am I on?' or to confirm an update landed. No network call. To get the newest published version, point them to https://pypi.org/project/gen-mcp-server/ — `uvx` users auto-update on restart; `pip` users run `pip install -U gen-mcp-server`.

• Code scan26 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancerepository not readable: repo not found3/15
• Maintainer identityno repository or website to verify2/10

GEN: common questions

Is GEN MCP server safe?

With care: it is graded C, so read the findings first (55/100). Read the GEN safety report

How do I install GEN?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does GEN need an API key?

Yes. The registry entry asks for GEN_API_KEY.

Is GEN maintained?

The latest release is v0.1.10.

What can I use instead of GEN?

Servers from other publishers that do the same job: Taisly Social Media Posting MCP server, Claude Real Video MCP server and Agent-Native Assets MCP server. Compare all GEN alternatives.