Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

GEN

PYPI · GEN-MCP-SERVER · SCANNED SEP 21

GEN is an autonomous social media agent: it spots trends, writes scripts, and creates videos.

Available components

+15 this week 74 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
  • 1 of 23 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency19
  • Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 39 days ago).Pass
  • Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability75
  • 75% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 4625 tokens (~71/item across 65 items; 62 tools + 3 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
  • Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage67
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "gen_delete_asset" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 63 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Install

How do I install the GEN MCP server?

GEN runs locally as a PyPI package, launched with uvx gen-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · gen-mcp-server

# add to Claude Code
claude mcp add poweredbygen-gen-mcp-server -- uvx gen-mcp-server
// .cursor/mcp.json
{
  "mcpServers": {
    "poweredbygen-gen-mcp-server": {
      "command": "uvx",
      "args": [
        "gen-mcp-server"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "poweredbygen-gen-mcp-server": {
      "command": "uvx",
      "args": [
        "gen-mcp-server"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add poweredbygen-gen-mcp-server -- uvx gen-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "poweredbygen-gen-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "gen-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add poweredbygen-gen-mcp-server --command uvx --arg gen-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  poweredbygen-gen-mcp-server:
    command: "uvx"
    args: ["gen-mcp-server"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "poweredbygen-gen-mcp-server": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "gen-mcp-server"
      ]
    }
  }
}
# add to Vellum
assistant mcp add poweredbygen-gen-mcp-server -t stdio -c uvx -a gen-mcp-server
// mcp.json
{
  "mcpServers": {
    "poweredbygen-gen-mcp-server": {
      "command": "uvx",
      "args": [
        "gen-mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 20 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 18 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 16 Sept 26 0
    • Stability: 0.97 → pass security
  • 15 Sept 26 +16
    • Malware scan: unverified → pass security
  • 14 Sept 26 −15
    • Malware scan: pass → unverified security
  • 13 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Sept 26 −2
    • Stability: pass → 0.83 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Sept 2026 · Analysed pypi/gen-mcp-server@0.1.10

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 23 packages
Packages resolved 23
Stale 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 62 exposed · ~4,611 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
gen_ask ~327

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. Examples of questions to send here: - "What is this TikTok about? https://www.tiktok.com/@x/video/123" (analyze a single video: transcript, hooks, what makes it work) - "What's trending in #skincare in the last 30 days?" - "Who are the top creators posting about #crypto and what are their stats?" - "Tell me about the @nasa account — followers, what they post, engagement." - "What age group and gender watches gardening content?" - "When is the best time to post for the beauty niche?" - "What are people saying in the comments of <video url>?" - "Which hooks performed best for fitness creators this month?" - "What sounds are rising in the cooking niche right now?" GEN answers from its social data warehouse. The user does NOT scrape; they ASK and GEN looks it up and answers. Send the question verbatim — do not pre-parse links/hashtags out of it. For BUILDING/generating content (videos, songs, vidsheets), use gen_chat instead.

NameTypeReqDescription
agent_idstringyes
auto_confirmboolean
conversation_id
questionstringyes
waitboolean

No output schema declared.

No examples provided.

gen_buy_credits ~89

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.

NameTypeReqDescription
cancel_urlstringyes
credit_plan_idstringyes
organization_idstringyes
success_urlstringyes

No output schema declared.

No examples provided.

gen_chat ~271

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 -> render, etc.). FIRST consider the specialized tools; use gen_chat only when none fits: - a QUESTION about social data (link/account/hashtag/trend/sound/comment) -> gen_ask - content ideas for a niche -> gen_generate_content_ideas - research trends / creators / the web -> gen_research - make a video about a topic -> gen_create_video - an exact single operation (create one image, schedule one post, render one cell) -> the specific deterministic gen_* tool Use gen_chat when the request is open-ended, multi-step, or doesn't map cleanly to any of the above.

NameTypeReqDescription
agent_idstringyes
auto_confirmboolean
conversation_id
goalstringyes
waitboolean

No output schema declared.

No examples provided.

gen_clone_engine ~38

Clone a vidsheet into the same or a different agent.

NameTypeReqDescription
engine_idstringyes
target_agent_idstringyes

No output schema declared.

No examples provided.

gen_clone_template ~38

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

NameTypeReqDescription
agent_idstringyes
slugstringyes

No output schema declared.

No examples provided.

gen_clone_voice ~48

Clone a voice from an audio sample (paid).

NameTypeReqDescription
agent_idstringyes
base64_audiostringyes
language
namestringyes

No output schema declared.

No examples provided.

gen_create_engine ~38

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

NameTypeReqDescription
agent_idstringyes
titlestring

No output schema declared.

No examples provided.

gen_create_image ~138

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.

NameTypeReqDescription
agent_idstringyes
aspect_ratiostring
number_of_imagesinteger
promptstringyes
versionstring

No output schema declared.

No examples provided.

gen_create_recurring_job ~139

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.

NameTypeReqDescription
agent_idstringyes
auto_publishboolean
cadencestring
delivery_typestring
email
namestringyes
promptstringyes
time_of_daystring
timezonestring

No output schema declared.

No examples provided.

gen_create_row ~42

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

NameTypeReqDescription
agent_idstringyes
engine_idstringyes

No output schema declared.

No examples provided.

gen_create_song ~203

Generate one original song/music track from a text prompt. Use this for plain song creation requests like "create a song", "generate background music", "make a 30 second jingle", or "create 5 songs" (call once per desired song). Do NOT use gen_create_song_mix unless the user explicitly asks to combine/mix/transition multiple songs into one long DJ-style output. `model` is one of: ACE-Step (default) or HeartMuLa. `duration` is seconds, defaults to 240, and must be 1-240. Optionally pass an HTTPS `reference_audio_url` to guide the style. Paid — returns a job to poll with gen_get_generation.

NameTypeReqDescription
agent_idstringyes
durationinteger
instrumentalboolean
modelstring
promptstringyes
reference_audio_url
seed

No output schema declared.

No examples provided.

gen_create_song_mix ~197

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, artist, url, asset_id, bpm, key, mood. `output_format` is mp3 or wav. Returns pending_engine until the renderer worker is installed, or pending_song_generation when songs must be generated first.

NameTypeReqDescription
auto_orderboolean
desired_duration_seconds
generate_missing_count
output_formatstring
prompt
tracks
transition_stylestring

No output schema declared.

No examples provided.

gen_create_song_mix_from_files ~152

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.

NameTypeReqDescription
agent_idstringyes
auto_orderboolean
desired_duration_seconds
file_pathsarrayyes
folder_id
output_formatstring
prompt
transition_stylestring

No output schema declared.

No examples provided.

gen_create_video ~176

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. For a FINISHED multi-scene video from a brief (plan + script + render), use gen_make_video instead. Use this tool when you want exactly one clip from one prompt.

NameTypeReqDescription
agent_idstringyes
aspect_ratiostring
durationinteger
modelstring
promptstringyes

No output schema declared.

No examples provided.

gen_create_voice ~59

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

NameTypeReqDescription
agent_idstringyes
description
gender
generation_id
language
namestringyes

No output schema declared.

No examples provided.

gen_delete_asset ~30

Delete a content resource.

NameTypeReqDescription
agent_idstringyes
resource_idstringyes

No output schema declared.

No examples provided.

gen_delete_recurring_job ~32

Delete a recurring job.

NameTypeReqDescription
agent_idstringyes
job_idstringyes

No output schema declared.

No examples provided.

gen_delete_scheduled_post ~27

Delete a scheduled post from the calendar.

NameTypeReqDescription
post_idstringyes

No output schema declared.

No examples provided.

gen_design_voice ~63

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

NameTypeReqDescription
agent_idstringyes
gender
language
namestringyes
promptstringyes
textstringyes

No output schema declared.

No examples provided.

gen_disconnect_social ~52

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

NameTypeReqDescription
agent_idstringyes
platformstringyes

No output schema declared.

No examples provided.

gen_duplicate_row ~51

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

NameTypeReqDescription
agent_idstringyes
engine_idstringyes
row_idstringyes

No output schema declared.

No examples provided.

gen_estimate_job ~54

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.

NameTypeReqDescription
agent_idstringyes
jobsarrayyes

No output schema declared.

No examples provided.

gen_generate_content_ideas ~174

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'. topic: optional focus ('a specific product', 'black friday'); omit to use the agent's configured niche. count: how many ideas (default 5). Use this for IDEATION. To then BUILD a chosen idea into a video use gen_create_video or gen_chat; to ANALYZE existing content use gen_ask.

NameTypeReqDescription
agent_idstringyes
conversation_id
countinteger
topic
waitboolean

No output schema declared.

No examples provided.

gen_get_agent ~24

Get a single agent's details.

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_get_agent_core ~49

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

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_get_asset ~35

Get a content resource including its downloadable CDN url.

NameTypeReqDescription
agent_idstringyes
resource_idstringyes

No output schema declared.

No examples provided.

gen_get_cell ~46

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

NameTypeReqDescription
agent_idstringyes
cell_idstringyes
engine_idstringyes

No output schema declared.

No examples provided.

gen_get_credit_balance ~31

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

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_get_credit_usage ~54

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

NameTypeReqDescription
agent_idstringyes
pageinteger

No output schema declared.

No examples provided.

gen_get_engine ~40

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

NameTypeReqDescription
agent_idstringyes
engine_idstringyes

No output schema declared.

No examples provided.

gen_get_generation ~52

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

NameTypeReqDescription
agent_idstringyes
generation_idstringyes

No output schema declared.

No examples provided.

gen_get_me ~32

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

gen_get_run_status ~37

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

NameTypeReqDescription
run_idstringyes

No output schema declared.

No examples provided.

gen_get_social_connect_url ~157

Get an OAuth URL the user opens in a browser to connect a social account for publishing. platform: youtube | tiktok | instagram | x. The MCP never handles credentials. Flow: 1. Call this -> returns {url: "<oauth consent url>"}. 2. Give the user the url; they open it and approve in their browser. 3. The platform redirects back to GEN and the connection is saved. 4. Confirm with gen_list_connected_socials. Use this when a user asks to connect/link their YouTube (etc.) account, or when publishing fails because the platform isn't connected yet.

NameTypeReqDescription
agent_idstringyes
platformstring

No output schema declared.

No examples provided.

gen_get_template ~25

Get a single template by slug or id.

NameTypeReqDescription
slugstringyes

No output schema declared.

No examples provided.

gen_import_asset_from_url ~80

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.

NameTypeReqDescription
agent_idstringyes
folder_id
urlstringyes

No output schema declared.

No examples provided.

gen_list_agents ~36

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

NameTypeReqDescription
organization_id

No output schema declared.

No examples provided.

gen_list_assets ~49

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

NameTypeReqDescription
agent_idstringyes
pageinteger
type

No output schema declared.

No examples provided.

gen_list_columns ~33

List all columns in a vidsheet.

NameTypeReqDescription
agent_idstringyes
engine_idstringyes

No output schema declared.

No examples provided.

gen_list_connected_socials ~62

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.

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_list_credit_plans ~30

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

NameTypeReqDescription
cyclestring

No output schema declared.

No examples provided.

gen_list_my_voices ~29

List the agent's own custom/created voices.

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_list_recurring_jobs ~31

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

NameTypeReqDescription
agent_idstringyes

No output schema declared.

No examples provided.

gen_list_rows ~33

List all rows in a vidsheet.

NameTypeReqDescription
agent_idstringyes
engine_idstringyes

No output schema declared.

No examples provided.

gen_list_scheduled_posts ~59

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

NameTypeReqDescription
agent_idstringyes
end_date
start_date

No output schema declared.

No examples provided.

gen_list_templates ~50

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

NameTypeReqDescription
pageinteger

No output schema declared.

No examples provided.

gen_list_voices ~33

List available voices (optionally filtered by provider).

NameTypeReqDescription
agent_idstringyes
provider

No output schema declared.

No examples provided.

gen_list_workspaces ~21

List all workspaces (organizations) you can access.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

gen_make_video ~170

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'. brief: what the video should be about + any constraints (length, aspect ratio, style, platform). This is the high-level BUILD path (it composes many steps end to end). For ONE raw clip from a single prompt use gen_create_video instead; for content IDEAS first use gen_generate_content_ideas.

NameTypeReqDescription
agent_idstringyes
briefstringyes
conversation_id
waitboolean

No output schema declared.

No examples provided.

gen_pause_recurring_job ~32

Pause a recurring job.

NameTypeReqDescription
agent_idstringyes
job_idstringyes

No output schema declared.

No examples provided.

Common questions

What is the GEN MCP server?

GEN is an MCP server listed in the public MCP registry as io.github.poweredbyGEN/gen-mcp-server. GEN is an autonomous social media agent: it spots trends, writes scripts, and creates videos. This page covers its PyPI package (gen-mcp-server).

Is the GEN MCP server safe to use?

GEN scores 74 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the GEN MCP server expose?

GEN exposes 62 tools: gen_version, gen_get_me, gen_list_workspaces, gen_list_agents, gen_get_agent, and 57 more. Their descriptions and schemas cost roughly 4,611 tokens of context every time the server is loaded.

Is the GEN MCP server still maintained?

GEN is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the GEN MCP server under?

GEN declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.