GEN is an MCP server published by io.github.poweredbyGEN, hosted at mcp.gen.pro. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 19 tools, including gen_agent_action, gen_analyze, gen_ask, gen_asset_action, gen_billing_action.
GEN is the creative AI video engineer. Free editor/social publishing; AI credits via card/x402.
1 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Only agent profile/settings/appearance. Read current actions with gen_discover domain=agent view=actions.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_agent_action",
"title": "Create, update, or remove assistants and their profiles",
"description": "Only agent profile/settings/appearance. Read current actions with gen_discover domain=agent view=actions.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Create, update, or remove assistants and their profiles",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only collect sources/analyze videos/trends/research. start directly; write a short chat acknowledgement. analytics(agent_id,view):Query workspace metrics; next: inspect rows. Finish: gen_task_action wait/get. analyze_account(agent_id,username):Analyze supplied social account; next: read job. analyze_socials(agent_id):Analyse own connected socials; next: read job. apify_scrape(actor_id,agent_id,idempotency_key,input):Run external data collector; next: read job. aura_user_stats(agent_id,emails,environment):Read user campaign metrics; next: inspect rows. chart(agent_id):Create chart from data; next: open artifact. clip_moments(agent_id,sources):Content run step; use gen_content_action find_clips. Finish: gen_task_action wait/get. collect(agent_id,targets):Collect typed targets and scope; next: gen_discover analyze.job. Finish: gen_task_action wait/get. collect_enrichment_status(agent_id,job_id):Read collect enrichment job; next: use analysis. comment_mining(agent_id,target):Find comment patterns; next: read analyze.job. Finish: gen_task_action wait/get. comments(agent_id):Read stored video comments; next: read returned job. Finish: gen_task_action wait/get. comments_online(agent_id,video_ids):Collect live video comments; next: read job. creators(agent_id,query):Creators for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. hooks(agent_id,query):Hooks for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. import_urls(agent_id,platform,videos_urls):Import source URLs for analysis; next: read returned job. layer_analysis(agent_id,cell_id,vidsheet_id):Analyze owned layer media; next: read vidsheet.layer_analysis. monitor_status(agent_id):Read comment monitoring state; never commenter text. report(agent_id,window):Topic report; next: gen_discover analyze.job. Finish: gen_task_action wait/get. research_scrape(agent_id,input,source):Collect sources for research; next: read job. research_web(agent_id):Web, news, Reddit, X search for query; save=true keeps it; next: gen_discover analyze.job. Finish: gen_task_action wait/get. search_posts(agent_id,keyword):Search social posts for query; next: read job. sounds(agent_id,view):Find music matching criteria; next: use sound refs. Finish: gen_task_action wait/get. transcribe(agent_id):Transcribe public social video; next: gen_discover job. transcribe_status(agent_id,video_ids):Read accepted transcription; next: use text. trends(agent_id,query):Trends for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. upload_by_ids(agent_id,video_ids):Import provider media IDs; next: read resources. video_analysis(agent_id,video_url):Analyze source video; next: read analysis. Finish: gen_task_action wait/get. web_asset_scrape(agent_id,url):Find media assets on web page; next: use assets. Finish: gen_task_action wait/get.
Only chat run_id: workflow; omit: one user wait, several ask which, zero hub; message = the person's whole message, copied exactly, every word (including a leading 'no'/'ok' and any request at the end); never summarize, shorten or split it. ask(client_message_id,question):Start a durable/scheduled goal: question + client_message_id. Follow next_steps. New content: gen_content_action. Finish: gen_task_action wait/get. cancel_pending(conversation_id,pending_id):Cancel pending_id; read platform.conversation. chat(client_message_id,message):Exact message to run_id's workflow; omitted: one user wait, several ask which, zero hub. Requires client_message_id. steer(conversation_id):Steer active conversation; follow next_steps. stop(run_id):Stop run_id; read task.run_status.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_ask",
"title": "Ask GEN anything, or chat about a build goal",
"description": "Only chat run_id: workflow; omit: one user wait, several ask which, zero hub; message = the person's whole message, copied exactly, every word (including a leading 'no'/'ok' and any request at the end); never summarize, shorten or split it.\nask(client_message_id,question):Start a durable/scheduled goal: question + client_message_id. Follow next_steps. New content: gen_content_action. Finish: gen_task_action wait/get.\ncancel_pending(conversation_id,pending_id):Cancel pending_id; read platform.conversation.\nchat(client_message_id,message):Exact message to run_id's workflow; omitted: one user wait, several ask which, zero hub. Requires client_message_id.\nsteer(conversation_id):Steer active conversation; follow next_steps.\nstop(run_id):Stop run_id; read task.run_status.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"ask",
"cancel_pending",
"chat",
"steer",
"stop"
],
"type": "string"
},
"run_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN run result",
"required": [
"run_id",
"conversation_id",
"status",
"messages"
],
"properties": {
"run_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"markdown",
"card"
],
"properties": {
"card": {
"anyOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string"
},
"summary": {
"type": "object"
}
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"markdown": {
"type": "string"
}
},
"additionalProperties": true
}
},
"conversation_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "GEN queued message result",
"required": [
"queued",
"status"
],
"properties": {
"queued": {
"type": "boolean"
},
"status": {
"type": "string"
},
"position": {
"type": [
"integer",
"null"
]
},
"timed_out": {
"type": "boolean"
},
"pending_id": {
"type": [
"string",
"null"
]
},
"active_run_id": {
"type": [
"string",
"null"
]
},
"conversation_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "Legacy family dispatch result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"required": [
"status",
"run_id",
"question",
"next_tool",
"next_args",
"typed_options"
],
"properties": {
"run_id": {
"type": "string"
},
"status": {
"const": "waiting_for_user"
},
"question": {
"type": "string"
},
"next_args": {
"type": "object",
"required": [
"run_id",
"message"
],
"properties": {
"run_id": {
"type": "string"
},
"message": {
"type": "string"
}
}
},
"next_tool": {
"const": "gen_ask"
},
"typed_options": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
]
},
"annotations": {
"title": "Ask GEN anything, or chat about a build goal",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only owned media/files: manage/analyze. analyze(kind):Analyze owned media, not content intake; next: read returned job. Finish: gen_task_action wait/get. complete_asset_upload(signed_id):Register the finished direct upload as an owned asset; next: read asset.detail. create_direct_upload(byte_size,checksum,content_type,filename):Prepare an owned file upload; next: PUT bytes, then complete_asset_upload. delete_asset(resource_id):Delete the named owned asset; next: read asset.list. import_asset_from_url(url):Import a URL into owned assets; next: use returned resource ID. run_computer(command):Execute supplied code in the compute sandbox; next: read returned outputs.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_asset_action",
"title": "Analyze, upload, import, and delete assets",
"description": "Only owned media/files: manage/analyze.\nanalyze(kind):Analyze owned media, not content intake; next: read returned job. Finish: gen_task_action wait/get.\ncomplete_asset_upload(signed_id):Register the finished direct upload as an owned asset; next: read asset.detail.\ncreate_direct_upload(byte_size,checksum,content_type,filename):Prepare an owned file upload; next: PUT bytes, then complete_asset_upload.\ndelete_asset(resource_id):Delete the named owned asset; next: read asset.list.\nimport_asset_from_url(url):Import a URL into owned assets; next: use returned resource ID.\nrun_computer(command):Execute supplied code in the compute sandbox; next: read returned outputs.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"analyze",
"complete_asset_upload",
"create_direct_upload",
"delete_asset",
"import_asset_from_url",
"run_computer"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Analyze, upload, import, and delete assets",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Only subscriptions/funding/billing settings. buy_credits(credit_plan_id,organization_id):Buy a credit pack when balance is low; next: open returned checkout. create_x402_credit_purchase(workspace_id):Prepare an x402 credit purchase; next: settle its payment. list_owned_invoices(organization_id):Read owned-workspace invoices; invoice URL next. list_owned_subscriptions():Read owned-workspace subscriptions; billing plans next. open_checkout(credit_plan_id,organization_id):Open plan checkout for a workspace; next: follow the returned URL. prepare_funding_recovery():Present owned-workspace funding choices; next: choose a plan or top up. settle_x402_credit_purchase(checkout_session_id,payment_signature,workspace_id):Settle the prepared x402 purchase; next: read credit balance.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_billing_action",
"title": "Read billing and manage credit purchases",
"description": "Only subscriptions/funding/billing settings.\nbuy_credits(credit_plan_id,organization_id):Buy a credit pack when balance is low; next: open returned checkout.\ncreate_x402_credit_purchase(workspace_id):Prepare an x402 credit purchase; next: settle its payment.\nlist_owned_invoices(organization_id):Read owned-workspace invoices; invoice URL next.\nlist_owned_subscriptions():Read owned-workspace subscriptions; billing plans next.\nopen_checkout(credit_plan_id,organization_id):Open plan checkout for a workspace; next: follow the returned URL.\nprepare_funding_recovery():Present owned-workspace funding choices; next: choose a plan or top up.\nsettle_x402_credit_purchase(checkout_session_id,payment_signature,workspace_id):Settle the prepared x402 purchase; next: read credit balance.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"buy_credits",
"create_x402_credit_purchase",
"list_owned_invoices",
"list_owned_subscriptions",
"open_checkout",
"prepare_funding_recovery",
"settle_x402_credit_purchase"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Read billing and manage credit purchases",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only standalone characters from owned image/video; video/series: gen_content_action. copy_to_mine(agent_id,character_id):Copy shared character to mine; next: get copy. create(agent_id,content_resource_id):Standalone character/clone_voice from owned image/video; content intake: content-ideas-and-videos. create_talking_character(agent_id,character_id,clips,look_id):Standalone talking clips from look/voice; next: read generation; content intake: content-ideas-and-videos. delete_character(agent_id,character_id):Delete character; next: confirm preview after user approval. delete_look(agent_id,character_id,look_id):Delete look; next: confirm preview after user approval. delete_talking_character(agent_id,character_id,talking_character_id):Delete talking clip; next: confirm preview after user approval. edit_talking_character(agent_id,character_id,clips,talking_character_id):Revise saved talking clips; next: read generation. get(agent_id,character_id):Read character; next: choose look/voice. get_talking_character(agent_id,character_id,talking_character_id):Read talking character; next: build with its media. list(agent_id):Read pool; next: get a character. rename(agent_id,character_id,name):Rename character/look/clip; next: get character. set_primary_voice(agent_id,character_id,voice):Save selected voice; next: get character. set_profile(agent_id,character_id,profile):Save appearance fields; next: get character. share_character(agent_id,character_id,organization_id):Grant workspace access; next: inspect grant. unshare_character(agent_id,character_id,organization_id):Revoke workspace access; next: inspect grant. upload_look(agent_id,character_id,content_resource_id):Add owned image; next: get character. upload_talking_character(agent_id,character_id,content_resource_id):Standalone owned video/clone_voice; content intake: content-ideas-and-videos. validate_cast(agent_id,build_inputs):Validate saved cast before build; next: repair missing media.
| Parameter | Type | Description |
|---|---|---|
| op | string | one of ["copy_to_mine","create","create_talking_character","delete_character","delete_look","delete_talking_character","edit_talking_character","get","get_talking_character","list","rename","set_primary_voic… |
| agent_id * |
Only plan videos from a topic/goal/product/story/multi-scene script; specified media/file edits: other tools. Flow: generate_ideas>brief(confirm/change)>characters(approve/change)>ideas(expand_idea idea_id)>storyboard(create_video_from_idea draft)>Draft>Full. start directly; write a short chat acknowledgement. approve_characters(run_id):Approve cast; next: ideas. Finish: gen_task_action wait/get. back_to_ideas(run_id):Back to ideas; pick idea_id. Finish: gen_task_action wait/get. confirm_brief(run_id):Confirm brief; next: characters. Finish: gen_task_action wait/get. create_content_resource(signed_id):Save a source/asset; read content.resource. create_video_from_idea():Build a saved idea (idea_id, idea_ids or idea_title) into a Draft or Full video (default paid full); read content.video_job. Finish: gen_task_action wait/get. delete_content_resource(resource_id):Delete source; read content.list. expand_idea():Storyboard a saved idea named by idea_id into a fuller plan; read its job. Finish: gen_task_action wait/get. find_clips(brief):Clip ideas from a video; next: create_video_from_idea. Finish: gen_task_action wait/get. generate_ideas():New brief/uploads: brief>cast>ideas>Draft>Full. Never for an idea already saved (idea_id): create_video_from_idea or expand_idea. Waiting replies: gen_ask chat run_id. Finish: gen_task_action wait/get. recreate_video():Recreate a source video's structure as saved ideas, also when the person asks for it as another length or format; next: create_video_from_idea. Finish: gen_task_action wait/get. reimagine_video(direction):Adapt a source video to a new concept or direction the person gives as ideas; next: create_video_from_idea. Finish: gen_task_action wait/get. remove_content_preference(preference):Delete saved rule by text; first read agent.settings to find it. save_idea(brief,title,video_type_id):Save an authored idea's script and structure; next: create_video_from_idea. set_content_preference(preference):Save long_term (all future content) or session (conversation) rules, including 'never'; read agent.settings. set_idea_status(idea_id,status):Set idea status; read content.idea. update_content_resource(filename,resource_id):Update source; read content.resource.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| no_paid |
Only records/options/job results/action schemas.
| Parameter | Type | Description |
|---|---|---|
| tool | string | |
| view | string | |
| action | string | |
| domain | string | one of ["vidsheet","agent","asset","billing","content","location","media","platform","publish","task","voice","watchlist","social","analyze","contracts","characters","generate","ask"] |
| row_id | string | |
| target | any | |
| cell_id | string | |
| agent_id | any | |
| layer_id | string | |
| vidsheet_id | string |
{
"name": "gen_discover",
"title": "Discover",
"description": "Only records/options/job results/action schemas.",
"inputSchema": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"view": {
"type": "string"
},
"action": {
"type": "string"
},
"domain": {
"enum": [
"vidsheet",
"agent",
"asset",
"billing",
"content",
"location",
"media",
"platform",
"publish",
"task",
"voice",
"watchlist",
"social",
"analyze",
"contracts",
"characters",
"generate",
"ask"
],
"type": "string"
},
"row_id": {
"type": "string"
},
"target": {},
"cell_id": {
"type": "string"
},
"agent_id": {},
"layer_id": {
"type": "string"
},
"vidsheet_id": {
"type": "string"
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "Discovery view document",
"required": [
"result"
],
"properties": {
"result": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
}
},
"description": "result is the view's document: parse it for the records, ids and options the view serves. Its shape is the view's own (see the tool description).",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN discovery result"
},
"annotations": {
"title": "Discover",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Only problems/product feedback to GEN.
| Parameter | Type | Description |
|---|---|---|
| rating | any | |
| message * | any | |
| agent_id | any | |
| category | any | |
| conversation_id | any |
{
"name": "gen_feedback",
"title": "Send feedback about GEN",
"description": "Only problems/product feedback to GEN.",
"inputSchema": {
"type": "object",
"required": [
"message"
],
"properties": {
"rating": {},
"message": {},
"agent_id": {},
"category": {},
"conversation_id": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "Feedback receipt",
"required": [
"status",
"feedback_id",
"message"
],
"properties": {
"status": {
"enum": [
"received"
],
"type": "string"
},
"ticket": {
"type": [
"string",
"null"
]
},
"message": {
"type": "string",
"description": "The thank-you to relay to the user."
},
"feedback_id": {
"type": "string"
},
"relay_to_user": {
"type": "boolean"
}
}
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN feedback result"
},
"annotations": {
"title": "Send feedback about GEN",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Only specified media in one generation; planned videos: gen_content_action. start directly; create_image(prompt):Render images from the person's prompt; next: read returned generation. Finish: gen_task_action wait/get. create_song():Compose one requested song, jingle or sound; next: read returned generation. Finish: gen_task_action wait/get. create_song_mix(tracks):Mix supplied songs into one output; next: read the returned generation. create_video(prompt):Render one clip from text or the person's image, with the named model; next: read returned generation. Finish: gen_task_action wait/get. swap_character(prompt,reference_images,video):Swap a person in their video for their image's character; next: read generation. Finish: gen_task_action wait/get. transcribe():Transcribe the person's own audio/video file; next: read returned job. Finish: gen_task_action wait/get.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| no_paid | any | |
| agent_id | any | |
| confirm_token | any | |
| spending_run_id | any | |
| max_paid_operations | any |
{
"name": "gen_generate",
"title": "Create images, videos, songs, and transcripts",
"description": "Only specified media in one generation; planned videos: gen_content_action. start directly;\ncreate_image(prompt):Render images from the person's prompt; next: read returned generation. Finish: gen_task_action wait/get.\ncreate_song():Compose one requested song, jingle or sound; next: read returned generation. Finish: gen_task_action wait/get.\ncreate_song_mix(tracks):Mix supplied songs into one output; next: read the returned generation.\ncreate_video(prompt):Render one clip from text or the person's image, with the named model; next: read returned generation. Finish: gen_task_action wait/get.\nswap_character(prompt,reference_images,video):Swap a person in their video for their image's character; next: read generation. Finish: gen_task_action wait/get.\ntranscribe():Transcribe the person's own audio/video file; next: read returned job. Finish: gen_task_action wait/get.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"model": {
"type": [
"string",
"null"
]
},
"action": {
"enum": [
"create_image",
"create_song",
"create_song_mix",
"create_video",
"swap_character",
"transcribe"
],
"type": "string"
},
"prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": [
"string",
"null"
]
}
]
},
"duration": {
"type": [
"integer",
"null"
]
},
"aspect_ratio": {
"type": [
"string",
"null"
]
},
"number_of_images": {
"type": [
"integer",
"null"
],
"maximum": 10,
"minimum": 1
},
"reference_images": {
"type": [
"array",
"null"
],
"items": {}
}
},
"additionalProperties": true
}
},
"no_paid": {},
"agent_id": {},
"confirm_token": {},
"spending_run_id": {},
"max_paid_operations": {}
},
"x-gen-funding": {
"operations": {
"transcribe": "paid_media",
"create_song": "paid_media",
"create_image": "paid_media",
"create_video": "paid_media",
"swap_character": "paid_media",
"create_song_mix": "credits"
},
"eligibility": {
"code": "FUNDING_UNAVAILABLE",
"message": "The funding decision is unavailable.",
"field_path": "agent_id"
},
"schema_version": "gen-generate-funding/2"
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Create images, videos, songs, and transcripts",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only report ideas from supplied research.
| Parameter | Type | Description |
|---|---|---|
| count * | any | |
| sources * | any | |
| agent_id * | any | |
| period_end | any | |
| references * | any | |
| report_key * | any | |
| excluded_keys | any | |
| peer_evidence | any | |
| playbook_text * | any | |
| playbook_principles * | any |
Only workspace members/preferences/API access. create_api_key():Create a workspace API credential; next: give the person the returned download_url. create_organization(name):Create a workspace with the supplied name; next: read platform.organization. create_proof_of_genesis_backup(asset_url):Save an asset's proof-of-genesis backup; next: read platform.backups. delete_organization(organization_id):Delete the named workspace; next: confirm only after user approval. invite_member(organization_id,username_or_email):Invite the named person to a workspace role; next: read platform.members. leave_workspace(organization_id):Leave the named workspace; next: read platform.organizations. remove_member(organization_id,user_id):Remove the named workspace member; next: read platform.members. remove_proof_of_genesis_backup(backup_id):Delete the named backup; next: read platform.backups. request_email_link_code(email):Start email linking for the supplied address; next: verify_email_link_code. resend_email_link_code(request_id):Resend a requested email code; next: verify_email_link_code. revoke_all_api_keys():Revoke every caller API key; next: sign in again. revoke_api_key(token_id):Revoke the named API key; next: read platform.api_keys. set_member_role(organization_id,role,username_or_email):Change the named workspace member's role; next: read platform.members. start_seat_checkout(organization_id,return_url):Open checkout to add workspace seats; next: follow returned URL. transfer_workspace_ownership(organization_id,username_or_email):Transfer workspace ownership to its named member; next: confirm. update_api_key(name,token_id):Rename the named API credential; next: read platform.api_keys. update_organization(name,organization_id):Rename the named workspace; next: read platform.organization. update_session_preferences(conversation_id,preferences):Save conversation preferences; next: read platform.preferences. upgrade_workspace(credit_plan_id,organization_id,return_url):Open the workspace plan upgrade; next: follow returned checkout URL. verify_email_link_code(code,request_id):Verify the requested email code as text; next: read the link result.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id |
Only connect accounts/publish/schedule. Read current actions with gen_discover domain=publish view=actions.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_publish_action",
"title": "Schedule, publish, or remove posts",
"description": "Only connect accounts/publish/schedule. Read current actions with gen_discover domain=publish view=actions.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Schedule, publish, or remove posts",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only this MCP connection's sign-in link.
| Parameter | Type | Description |
|---|---|---|
| url * | any |
{
"name": "gen_sign_in_link",
"title": "Create a GEN sign-in link",
"description": "Only this MCP connection's sign-in link.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "Agent sign-in link",
"required": [
"url",
"expires_at"
],
"properties": {
"url": {
"type": "string",
"description": "The one-time GEN sign-in URL to hand to the user."
},
"expires_at": {
"type": "string",
"description": "ISO-8601 instant after which the link no longer works."
}
}
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN agent sign-in link result"
},
"annotations": {
"title": "Create a GEN sign-in link",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Only schedule/wait/read accepted tasks. create_monitoring_job(platform,search_type,value):Schedule source monitoring; next: read task.list. create_recurring_job(job_type,prompt,schedule):Save scheduled prompt and delivery; next: read task.list. decide_agent_run(approved,run_id):Approve or reject pending run; next: read task.run_status. delete_recurring_job():Delete named recurring job; next: read task.list. duplicate_recurring_job(job_id,vidsheet_url):Copy named recurring job; next: read task.list. ensure_default_recurring_job():Ensure default recurring job exists; next: read task.list. get(task_id):Read accepted MCP task by task_id; next: use result or wait. pause_recurring_job():Pause named recurring job; next: read task.list. render_email(assistant_content,payload):Render content as email; next: inspect document. resume_recurring_job():Resume paused recurring job; next: read task.list. revoke_grant(grant_id):Revoke scheduled-work grant; next: read task.list. run_recurring_job_now(job_id):Run named recurring job once; next: read task.run_status. update_monitoring_job(job_id,platform,search_type,value):Update saved monitoring settings; next: read task.list. update_recurring_job():Update schedule or delivery; next: read task.list. wait(task_id):Wait up to 60s for task_id; next: get result or wait.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_task_action",
"title": "Manage recurring jobs and monitoring tasks",
"description": "Only schedule/wait/read accepted tasks.\ncreate_monitoring_job(platform,search_type,value):Schedule source monitoring; next: read task.list.\ncreate_recurring_job(job_type,prompt,schedule):Save scheduled prompt and delivery; next: read task.list.\ndecide_agent_run(approved,run_id):Approve or reject pending run; next: read task.run_status.\ndelete_recurring_job():Delete named recurring job; next: read task.list.\nduplicate_recurring_job(job_id,vidsheet_url):Copy named recurring job; next: read task.list.\nensure_default_recurring_job():Ensure default recurring job exists; next: read task.list.\nget(task_id):Read accepted MCP task by task_id; next: use result or wait.\npause_recurring_job():Pause named recurring job; next: read task.list.\nrender_email(assistant_content,payload):Render content as email; next: inspect document.\nresume_recurring_job():Resume paused recurring job; next: read task.list.\nrevoke_grant(grant_id):Revoke scheduled-work grant; next: read task.list.\nrun_recurring_job_now(job_id):Run named recurring job once; next: read task.run_status.\nupdate_monitoring_job(job_id,platform,search_type,value):Update saved monitoring settings; next: read task.list.\nupdate_recurring_job():Update schedule or delivery; next: read task.list.\nwait(task_id):Wait up to 60s for task_id; next: get result or wait.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"create_monitoring_job",
"create_recurring_job",
"decide_agent_run",
"delete_recurring_job",
"duplicate_recurring_job",
"ensure_default_recurring_job",
"get",
"pause_recurring_job",
"render_email",
"resume_recurring_job",
"revoke_grant",
"run_recurring_job_now",
"update_monitoring_job",
"update_recurring_job",
"wait"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Manage recurring jobs and monitoring tasks",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Only upload local files to caller-owned assets.
| Parameter | Type | Description |
|---|---|---|
| file | any | |
| phase | any | |
| agent_id | any | |
| filename | any | |
| folder_id | any | |
| upload_id | any | |
| content_type | any |
{
"name": "gen_upload_asset",
"title": "Upload a file into an asset library",
"description": "Only upload local files to caller-owned assets.",
"inputSchema": {
"type": "object",
"properties": {
"file": {},
"phase": {},
"agent_id": {},
"filename": {},
"folder_id": {},
"upload_id": {},
"content_type": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"title": "GEN upload result",
"properties": {
"ok": {
"type": "boolean"
},
"curl": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"string",
"null"
]
},
"asset": {
"type": [
"object",
"null"
]
},
"error": {
"type": [
"object",
"null"
]
},
"phase": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"outcome": {
"type": [
"string",
"null"
]
},
"put_url": {
"type": [
"string",
"null"
]
},
"drop_url": {
"type": [
"string",
"null"
]
},
"filename": {
"type": [
"string",
"null"
]
},
"max_bytes": {
"type": [
"integer",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"upload_id": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"integer",
"null"
]
},
"expires_in": {
"type": [
"integer",
"null"
]
},
"content_type": {
"type": [
"string",
"null"
]
},
"upload_token": {
"type": [
"string",
"null"
]
}
},
"description": "A request ticket (pending), an owned asset (completed), a state, or a typed refusal.",
"additionalProperties": true
},
"annotations": {
"title": "Upload a file into an asset library",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Only edit/generate Vidsheet rows. add_column():Add a workspace column with required name and kind; fill rows only through set_cell; next: read vidsheet.columns. add_layer():Add a timeline layer to the target row; next: read vidsheet.layers. apply_storyboard():Apply an authored storyboard to an owned row; next: read the saved sheet. clone_template():Create a workspace from a template_slug; next: read vidsheet.sheet. close_gap(target):Close the gap immediately before the target layer, shifting that layer and its later track siblings together; refuses when no gap exists. continue_generation(generation_id,idempotency_key):Resume the accepted generation_id; next: read vidsheet.generation. create(target,values):Add a Vidsheet, column, row, layer or variable. create_engine():Create the workspace engine for template_slug and idea_id; next: read vidsheet.engine. create_sheet():Create an editable workspace without a saved idea; next: read vidsheet.sheet. Saved ideas use create_video_from_idea. delete(target):Delete the target via confirmation token. duplicate(target):Copy a Vidsheet, column, row or layer. duplicate_sheet():Copy an existing vidsheet_id; next: read the new vidsheet.sheet. export(target):Export targeted Vidsheet rows as CSV. generate(card,target):Run a creation card on the target. import_asset(vidsheet_id):Add owned media to an existing workspace; next: read vidsheet.rows. redo(target):Redo an edit on the targeted Vidsheet. refund_unused_output():Request credit recovery for unused generation output; next: read receipt. reorder(ids,target):Set order using every sibling target id. set_cell():Save authored cell values or a creation card with required row, column and value; next: read vidsheet.cell. stop_generation(generation_id):Stop the accepted generation_id; next: read vidsheet.generation. undo(target):Undo an edit on the targeted Vidsheet. update(target,values):Save target fields without generating. update_layer():Save fields on an existing layer_id; next: read vidsheet.layer.
| Parameter | Type | Description |
|---|---|---|
| op | string | one of ["add_column","add_layer","apply_storyboard","clone_template","continue_generation","create_engine","create_sheet","duplicate_sheet","generate","import_asset","refund_unused_output","set_cell","stop_g… |
| actions |
Only create/preview/manage voices/scripts. clone_voice(name):Clone from owned speech; next: read returned job. delete_voice(voice_id):Delete your saved voice; next: read voice.mine. design_voice(generation_id,name):Design voice from description; next: preview saved voice. generate_voice_description(gender):Describe a voice for the supplied content; next: design_voice. generate_voice_samples(text):Selectable speech samples; next: read voice.sample_status. Finish: gen_task_action wait/get. generate_voice_script():Narration from brief; next: preview_voice. preview_voice(text,voice_id):Preview text with voice ID; next: read voice.preview_status. Finish: gen_task_action wait/get.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_voice_action",
"title": "Clone, design, preview, and delete voices",
"description": "Only create/preview/manage voices/scripts.\nclone_voice(name):Clone from owned speech; next: read returned job.\ndelete_voice(voice_id):Delete your saved voice; next: read voice.mine.\ndesign_voice(generation_id,name):Design voice from description; next: preview saved voice.\ngenerate_voice_description(gender):Describe a voice for the supplied content; next: design_voice.\ngenerate_voice_samples(text):Selectable speech samples; next: read voice.sample_status. Finish: gen_task_action wait/get.\ngenerate_voice_script():Narration from brief; next: preview_voice.\npreview_voice(text,voice_id):Preview text with voice ID; next: read voice.preview_status. Finish: gen_task_action wait/get.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"clone_voice",
"delete_voice",
"design_voice",
"generate_voice_description",
"generate_voice_samples",
"generate_voice_script",
"preview_voice"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Clone, design, preview, and delete voices",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Only watch sources/query findings. add_watchlist_source(platform,target_type,target_value):Add a source to the named watchlist; next: read watchlist.detail. create_watchlist(name):Create a watchlist for supplied sources; next: read watchlist.detail. delete_watchlist():Delete the named source watchlist; next: read watchlist.list. pause_watchlist():Pause collection for the named watchlist; next: read watchlist.detail. query_watchlist(question):Query the named watchlist's findings; next: use returned evidence. remove_watchlist_source():Remove a source from the named watchlist; next: read watchlist.detail. resume_watchlist():Resume collection for the named watchlist; next: read watchlist.detail. update_watchlist():Change the named watchlist's configuration; next: read watchlist.detail.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id | any | |
| confirm_token | any |
{
"name": "gen_watchlist_action",
"title": "Manage monitoring watchlists and their sources",
"description": "Only watch sources/query findings.\nadd_watchlist_source(platform,target_type,target_value):Add a source to the named watchlist; next: read watchlist.detail.\ncreate_watchlist(name):Create a watchlist for supplied sources; next: read watchlist.detail.\ndelete_watchlist():Delete the named source watchlist; next: read watchlist.list.\npause_watchlist():Pause collection for the named watchlist; next: read watchlist.detail.\nquery_watchlist(question):Query the named watchlist's findings; next: use returned evidence.\nremove_watchlist_source():Remove a source from the named watchlist; next: read watchlist.detail.\nresume_watchlist():Resume collection for the named watchlist; next: read watchlist.detail.\nupdate_watchlist():Change the named watchlist's configuration; next: read watchlist.detail.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"add_watchlist_source",
"create_watchlist",
"delete_watchlist",
"pause_watchlist",
"query_watchlist",
"remove_watchlist_source",
"resume_watchlist",
"update_watchlist"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Manage monitoring watchlists and their sources",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Before an unfamiliar write, inspect with gen_discover view=action tool=<tool> action=<action>. Tools: gen_agent_action,gen_analyze,gen_ask,gen_asset_action,gen_billing_action,gen_characters,gen_content_action,gen_discover,gen_feedback,gen_generate,gen_generate_report_ideas,gen_platform_action,gen_publish_action,gen_sign_in_link,gen_task_action,gen_upload_asset,gen_vidsheet_action,gen_voice_action,gen_watchlist_action. For any paid operation, if the request is missing required content (for example, a source video link or upload for clipping, a video or audio file for captions or transcription, a song name or audio file for lyrics, or a source file to edit or swap), first ask the user once for that missing content in their language without giving a funding refusal. For a complete request, use the operation's funding decision and refuse a denied operation before any further model turn or work. Write the reply in the user's language from the funding facts. gen_agent_action Only agent profile/settings/appearance. Read current actions with gen_discover domain=agent view=actions. gen_analyze analytics(agent_id,view):Query workspace metrics; next: inspect rows. Finish: gen_task_action wait/get. analyze_account(agent_id,username):Analyze supplied social account; next: read job. analyze_socials(agent_id):Analyse own connected socials; next: read job. apify_scrape(actor_id,agent_id,idempotency_key,input):Run external data collector; next: read job. aura_user_stats(agent_id,emails,environment):Read user campaign metrics; next: inspect rows. chart(agent_id):Create chart from data; next: open artifact. clip_moments(agent_id,sources):Content run step; use gen_content_action find_clips. Finish: gen_task_action wait/get. collect(agent_id,targets):Collect typed targets and scope; next: gen_discover analyze.job. Finish: gen_task_action wait/get. collect_enrichment_status(agent_id,job_id):Read collect enrichment job; next: use analysis. comment_mining(agent_id,target):Find comment patterns; next: read analyze.job. Finish: gen_task_action wait/get. comments(agent_id):Read stored video comments; next: read returned job. Finish: gen_task_action wait/get. comments_online(agent_id,video_ids):Collect live video comments; next: read job. creators(agent_id,query):Creators for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. hooks(agent_id,query):Hooks for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. import_urls(agent_id,platform,videos_urls):Import source URLs for analysis; next: read returned job. layer_analysis(agent_id,cell_id,vidsheet_id):Analyze owned layer media; next: read vidsheet.layer_analysis. monitor_status(agent_id):Read comment monitoring state; never commenter text. report(agent_id,window):Topic report; next: gen_discover analyze.job. Finish: gen_task_action wait/get. research_scrape(agent_id,input,source):Collect sources for research; next: read job. research_web(agent_id):Web, news, Reddit, X search for query; save=true keeps it; next: gen_discover analyze.job. Finish: gen_task_action wait/get. search_posts(agent_id,keyword):Search social posts for query; next: read job. sounds(agent_id,view):Find music matching criteria; next: use sound refs. Finish: gen_task_action wait/get. transcribe(agent_id):Transcribe public social video; next: gen_discover job. transcribe_status(agent_id,video_ids):Read accepted transcription; next: use text. trends(agent_id,query):Trends for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get. upload_by_ids(agent_id,video_ids):Import provider media IDs; next: read resources. video_analysis(agent_id,video_url):Analyze source video; next: read analysis. Finish: gen_task_action wait/get. web_asset_scrape(agent_id,url):Find media assets on web page; next: use assets. Finish: gen_task_action wait/get. gen_ask ask(client_message_id,question):Start a durable/scheduled goal: question + client_message_id. Follow next_steps. New content: gen_con
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Parameter | Type | Description |
|---|---|---|
| actions * | array | |
| agent_id * | any | |
| acknowledgement * | string | Write your own receipt acknowledgement, relayed unchanged before admission. Acknowledge receipt only; do not claim that analysis or other work has started. |
{
"name": "gen_analyze",
"title": "Analyze social trends, comments, hooks, and creators",
"description": "Only collect sources/analyze videos/trends/research. start directly; write a short chat acknowledgement.\nanalytics(agent_id,view):Query workspace metrics; next: inspect rows. Finish: gen_task_action wait/get.\nanalyze_account(agent_id,username):Analyze supplied social account; next: read job.\nanalyze_socials(agent_id):Analyse own connected socials; next: read job.\napify_scrape(actor_id,agent_id,idempotency_key,input):Run external data collector; next: read job.\naura_user_stats(agent_id,emails,environment):Read user campaign metrics; next: inspect rows.\nchart(agent_id):Create chart from data; next: open artifact.\nclip_moments(agent_id,sources):Content run step; use gen_content_action find_clips. Finish: gen_task_action wait/get.\ncollect(agent_id,targets):Collect typed targets and scope; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\ncollect_enrichment_status(agent_id,job_id):Read collect enrichment job; next: use analysis.\ncomment_mining(agent_id,target):Find comment patterns; next: read analyze.job. Finish: gen_task_action wait/get.\ncomments(agent_id):Read stored video comments; next: read returned job. Finish: gen_task_action wait/get.\ncomments_online(agent_id,video_ids):Collect live video comments; next: read job.\ncreators(agent_id,query):Creators for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\nhooks(agent_id,query):Hooks for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\nimport_urls(agent_id,platform,videos_urls):Import source URLs for analysis; next: read returned job.\nlayer_analysis(agent_id,cell_id,vidsheet_id):Analyze owned layer media; next: read vidsheet.layer_analysis.\nmonitor_status(agent_id):Read comment monitoring state; never commenter text.\nreport(agent_id,window):Topic report; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\nresearch_scrape(agent_id,input,source):Collect sources for research; next: read job.\nresearch_web(agent_id):Web, news, Reddit, X search for query; save=true keeps it; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\nsearch_posts(agent_id,keyword):Search social posts for query; next: read job.\nsounds(agent_id,view):Find music matching criteria; next: use sound refs. Finish: gen_task_action wait/get.\ntranscribe(agent_id):Transcribe public social video; next: gen_discover job.\ntranscribe_status(agent_id,video_ids):Read accepted transcription; next: use text.\ntrends(agent_id,query):Trends for a topic; next: gen_discover analyze.job. Finish: gen_task_action wait/get.\nupload_by_ids(agent_id,video_ids):Import provider media IDs; next: read resources.\nvideo_analysis(agent_id,video_url):Analyze source video; next: read analysis. Finish: gen_task_action wait/get.\nweb_asset_scrape(agent_id,url):Find media assets on web page; next: use assets. Finish: gen_task_action wait/get.",
"inputSchema": {
"type": "object",
"required": [
"agent_id",
"actions",
"acknowledgement"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"days": {
"type": "integer"
},
"mode": {
"anyOf": [
{
"enum": [
"hashtag",
"keyword",
"niche",
"handle"
],
"type": "string"
},
{
"enum": [
"news",
"social",
"web",
"all",
"document",
"url"
],
"type": "string"
},
{
"enum": [
"keyword",
"handle"
],
"type": "string"
}
]
},
"sort": {
"enum": [
"recent",
"views",
"likes",
"engagement"
],
"type": "string"
},
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string",
"const": "all"
}
]
},
"limit": {
"anyOf": [
{
"type": "integer",
"maximum": 1000,
"minimum": 1
},
{
"type": "integer"
}
]
},
"query": {
"type": "string"
},
"action": {
"enum": [
"analytics",
"analyze_account",
"analyze_socials",
"apify_scrape",
"aura_user_stats",
"chart",
"clip_moments",
"collect",
"collect_enrichment_status",
"comment_mining",
"comments",
"comments_online",
"creators",
"hooks",
"import_urls",
"layer_analysis",
"monitor_status",
"report",
"research_scrape",
"research_web",
"search_posts",
"sounds",
"transcribe",
"transcribe_status",
"trends",
"upload_by_ids",
"video_analysis",
"web_asset_scrape"
],
"type": "string"
},
"enrich": {
"type": "string",
"const": "full"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"window": {
"type": "object",
"additionalProperties": true
},
"creator": {
"type": "string"
},
"filters": {
"type": "object",
"additionalProperties": true
},
"include": {
"type": "array",
"items": {
"enum": [
"transcript",
"hooks",
"visual_description",
"description",
"stats",
"hashtags",
"media_type",
"video_url"
],
"type": "string"
}
},
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope",
"target"
],
"properties": {
"scope": {
"enum": [
"user",
"hashtag",
"keyword",
"search",
"url",
"id",
"asset",
"account",
"creators",
"comments",
"sounds",
"ads"
],
"type": "string"
},
"target": {
"anyOf": [
{
"type": "string"
},
{
"type": "object"
}
]
},
"platform": {
"enum": [
"tiktok",
"instagram",
"youtube",
"pinterest",
"twitter",
"kick",
"twitch",
"meta_ads",
"tiktok_ads",
"x",
"asset",
"auto"
],
"type": "string"
}
}
}
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok",
"instagram",
"youtube",
"kick"
],
"type": "string"
},
{
"type": "string"
},
{
"enum": [
"tiktok",
"instagram",
"youtube"
],
"type": "string"
}
]
},
"freshness": {
"enum": [
"live",
"cache_then_live_deficit"
],
"type": "string"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"x",
"news",
"web",
"reddit"
],
"type": "string"
}
},
"video_url": {
"type": "string"
},
"idempotency_key": {
"type": "string"
},
"reddit_subreddits": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
}
},
"agent_id": {},
"acknowledgement": {
"type": "string",
"description": "Write your own receipt acknowledgement, relayed unchanged before admission. Acknowledge receipt only; do not claim that analysis or other work has started."
}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Analyze social trends, comments, hooks, and creators",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| any |
{
"name": "gen_characters",
"title": "Manage characters, looks, and talking characters",
"description": "Only standalone characters from owned image/video; video/series: gen_content_action.\ncopy_to_mine(agent_id,character_id):Copy shared character to mine; next: get copy.\ncreate(agent_id,content_resource_id):Standalone character/clone_voice from owned image/video; content intake: content-ideas-and-videos.\ncreate_talking_character(agent_id,character_id,clips,look_id):Standalone talking clips from look/voice; next: read generation; content intake: content-ideas-and-videos.\ndelete_character(agent_id,character_id):Delete character; next: confirm preview after user approval.\ndelete_look(agent_id,character_id,look_id):Delete look; next: confirm preview after user approval.\ndelete_talking_character(agent_id,character_id,talking_character_id):Delete talking clip; next: confirm preview after user approval.\nedit_talking_character(agent_id,character_id,clips,talking_character_id):Revise saved talking clips; next: read generation.\nget(agent_id,character_id):Read character; next: choose look/voice.\nget_talking_character(agent_id,character_id,talking_character_id):Read talking character; next: build with its media.\nlist(agent_id):Read pool; next: get a character.\nrename(agent_id,character_id,name):Rename character/look/clip; next: get character.\nset_primary_voice(agent_id,character_id,voice):Save selected voice; next: get character.\nset_profile(agent_id,character_id,profile):Save appearance fields; next: get character.\nshare_character(agent_id,character_id,organization_id):Grant workspace access; next: inspect grant.\nunshare_character(agent_id,character_id,organization_id):Revoke workspace access; next: inspect grant.\nupload_look(agent_id,character_id,content_resource_id):Add owned image; next: get character.\nupload_talking_character(agent_id,character_id,content_resource_id):Standalone owned video/clone_voice; content intake: content-ideas-and-videos.\nvalidate_cast(agent_id,build_inputs):Validate saved cast before build; next: repair missing media.",
"inputSchema": {
"type": "object",
"required": [
"agent_id"
],
"properties": {
"op": {
"enum": [
"copy_to_mine",
"create",
"create_talking_character",
"delete_character",
"delete_look",
"delete_talking_character",
"edit_talking_character",
"get",
"get_talking_character",
"list",
"rename",
"set_primary_voice",
"set_profile",
"share_character",
"unshare_character",
"upload_look",
"upload_talking_character",
"validate_cast"
],
"type": "string"
},
"agent_id": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "Character list",
"required": [
"characters"
],
"properties": {
"characters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"source": {
"enum": [
"my",
"library",
"shared"
],
"description": "my is the agent's own character, library the shared character library, shared a character another workspace granted this workspace for read and use."
},
"read_only": {
"type": [
"boolean",
"null"
],
"description": "shared rows only: true, the character cannot be changed."
},
"permissions": {
"type": "array",
"items": {
"type": "string"
},
"description": "shared rows only: the permitted actions (read, use)."
},
"character_id": {
"type": [
"integer",
"string",
"null"
]
},
"source_agent_id": {
"type": [
"integer",
"string",
"null"
],
"description": "shared rows only: the agent that owns the character."
},
"character_public_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "Character, look or talking character record, or generation receipt",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"look_id": {
"type": [
"integer",
"string",
"null"
]
},
"voice_id": {
"type": [
"string",
"null"
]
},
"aspect_ratio": {
"enum": [
"9:16",
"16:9",
"1:1",
null
]
},
"character_id": {
"type": [
"integer",
"string",
"null"
]
},
"user_job_ids": {
"type": "array",
"items": {
"type": "integer"
}
},
"generation_id": {
"type": [
"integer",
"string",
"null"
]
},
"voice_clone_status": {
"enum": [
"pending",
"skipped",
"not_requested",
"not_applicable",
null
]
},
"voice_clone_message": {
"type": [
"string",
"null"
]
},
"talking_character_id": {
"type": [
"integer",
"string",
"null"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "Character result"
},
"annotations": {
"title": "Manage characters, looks, and talking characters",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| any |
| agent_id | any |
| confirm_token | any |
| acknowledgement * | string | Write your own receipt acknowledgement, relayed unchanged before admission. Acknowledge receipt only; do not claim that analysis or other work has started. |
| spending_run_id | any |
| max_paid_operations | any |
{
"name": "gen_content_action",
"title": "Manage content resources and content ideas",
"description": "Only plan videos from a topic/goal/product/story/multi-scene script; specified media/file edits: other tools. Flow: generate_ideas>brief(confirm/change)>characters(approve/change)>ideas(expand_idea idea_id)>storyboard(create_video_from_idea draft)>Draft>Full. start directly; write a short chat acknowledgement.\napprove_characters(run_id):Approve cast; next: ideas. Finish: gen_task_action wait/get.\nback_to_ideas(run_id):Back to ideas; pick idea_id. Finish: gen_task_action wait/get.\nconfirm_brief(run_id):Confirm brief; next: characters. Finish: gen_task_action wait/get.\ncreate_content_resource(signed_id):Save a source/asset; read content.resource.\ncreate_video_from_idea():Build a saved idea (idea_id, idea_ids or idea_title) into a Draft or Full video (default paid full); read content.video_job. Finish: gen_task_action wait/get.\ndelete_content_resource(resource_id):Delete source; read content.list.\nexpand_idea():Storyboard a saved idea named by idea_id into a fuller plan; read its job. Finish: gen_task_action wait/get.\nfind_clips(brief):Clip ideas from a video; next: create_video_from_idea. Finish: gen_task_action wait/get.\ngenerate_ideas():New brief/uploads: brief>cast>ideas>Draft>Full. Never for an idea already saved (idea_id): create_video_from_idea or expand_idea. Waiting replies: gen_ask chat run_id. Finish: gen_task_action wait/get.\nrecreate_video():Recreate a source video's structure as saved ideas, also when the person asks for it as another length or format; next: create_video_from_idea. Finish: gen_task_action wait/get.\nreimagine_video(direction):Adapt a source video to a new concept or direction the person gives as ideas; next: create_video_from_idea. Finish: gen_task_action wait/get.\nremove_content_preference(preference):Delete saved rule by text; first read agent.settings to find it.\nsave_idea(brief,title,video_type_id):Save an authored idea's script and structure; next: create_video_from_idea.\nset_content_preference(preference):Save long_term (all future content) or session (conversation) rules, including 'never'; read agent.settings.\nset_idea_status(idea_id,status):Set idea status; read content.idea.\nupdate_content_resource(filename,resource_id):Update source; read content.resource.",
"inputSchema": {
"type": "object",
"required": [
"actions",
"acknowledgement"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"cast": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"role"
],
"properties": {
"look": {
"type": [
"object",
"null"
],
"required": [
"source"
],
"properties": {
"source": {
"enum": [
"agent_look",
"avatar",
"attachment",
"description",
"none"
],
"type": "string"
},
"avatar_id": {
"type": [
"integer",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"attachment_ref": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"role": {
"type": "string"
},
"needs": {
"type": [
"array",
"null"
],
"items": {
"enum": [
"character_sheet",
"look",
"voice"
],
"type": "string"
}
},
"voice": {
"type": [
"object",
"null"
],
"required": [
"source"
],
"properties": {
"source": {
"enum": [
"voice_file",
"shared",
"mine",
"primary",
"description",
"avatar_default"
],
"type": "string"
},
"provider": {
"type": [
"string",
"null"
]
},
"voice_id": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"attachment_ref": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"speaks": {
"type": [
"boolean",
"null"
]
},
"on_screen": {
"type": [
"boolean",
"null"
]
},
"is_new_character": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
"brief": {
"type": "string"
},
"count": {
"anyOf": [
{
"type": [
"integer",
"null"
],
"maximum": 50,
"minimum": 1
},
{
"type": [
"number",
"null"
]
}
]
},
"action": {
"enum": [
"approve_characters",
"back_to_ideas",
"confirm_brief",
"create_content_resource",
"create_video_from_idea",
"delete_content_resource",
"expand_idea",
"find_clips",
"generate_ideas",
"recreate_video",
"reimagine_video",
"remove_content_preference",
"save_idea",
"set_content_preference",
"set_idea_status",
"update_content_resource"
],
"type": "string"
},
"format": {
"type": [
"object",
"null"
],
"properties": {
"count": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"platform": {
"type": [
"string",
"null"
]
},
"aspect_ratio": {
"type": [
"string",
"null"
]
},
"duration_seconds": {
"type": [
"integer",
"null"
],
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"row_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
},
{
"type": [
"integer",
"null"
],
"minimum": 1
}
]
},
"idea_id": {
"type": [
"string",
"null"
]
},
"direction": {
"type": "string"
},
"video_url": {
"type": [
"string",
"null"
]
},
"row_number": {
"type": [
"integer",
"null"
],
"minimum": 1
},
"video_type": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
}
]
},
"attachments": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"kind",
"role"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"kind": {
"enum": [
"image",
"video",
"audio",
"document"
],
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"role": {
"enum": [
"reference_video",
"look",
"voice_sample",
"content",
"style",
"brand"
],
"type": "string"
},
"signed_id": {
"type": [
"string",
"null"
]
},
"resource_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
}
]
},
"content_resource_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"vidsheet_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
},
{
"type": [
"string",
"null"
]
}
]
},
"creation_mode": {
"enum": [
"draft",
"full"
],
"type": "string"
},
"conversation_id": {
"type": [
"string",
"null"
]
},
"idempotency_key": {
"type": [
"string",
"null"
]
},
"source_accounts": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"allOf": [
{
"if": {
"properties": {
"own": {
"const": true
}
}
},
"else": {
"required": [
"platform",
"username"
],
"properties": {
"platform": {
"type": "string"
},
"username": {
"type": "string"
}
}
},
"then": {
"not": {
"required": [
"username"
]
}
}
}
],
"required": [
"own"
],
"properties": {
"own": {
"type": "boolean"
},
"platform": {
"anyOf": [
{
"enum": [
"tiktok",
"instagram",
"youtube",
"pinterest",
"twitter",
"kick",
"twitch",
"x"
],
"type": "string"
},
{
"type": "null"
}
]
},
"username": {
"type": [
"string",
"null"
],
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 5,
"minItems": 1
},
"content_resource_id": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": true
}
},
"no_paid": {},
"agent_id": {},
"confirm_token": {},
"acknowledgement": {
"type": "string",
"description": "Write your own receipt acknowledgement, relayed unchanged before admission. Acknowledge receipt only; do not claim that analysis or other work has started."
},
"spending_run_id": {},
"max_paid_operations": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"required": [
"status",
"run_id",
"question",
"next_tool",
"next_args",
"typed_options"
],
"properties": {
"run_id": {
"type": "string"
},
"status": {
"const": "waiting_for_user"
},
"question": {
"type": "string"
},
"next_args": {
"type": "object",
"required": [
"run_id",
"message"
],
"properties": {
"run_id": {
"type": "string"
},
"message": {
"type": "string"
}
}
},
"next_tool": {
"const": "gen_ask"
},
"typed_options": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
]
},
"annotations": {
"title": "Manage content resources and content ideas",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "gen_generate_report_ideas",
"title": "Generate report ideas",
"description": "Only report ideas from supplied research.",
"inputSchema": {
"type": "object",
"required": [
"agent_id",
"sources",
"references",
"playbook_principles",
"playbook_text",
"count",
"report_key"
],
"properties": {
"count": {},
"sources": {},
"agent_id": {},
"period_end": {},
"references": {},
"report_key": {},
"excluded_keys": {},
"peer_evidence": {},
"playbook_text": {},
"playbook_principles": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN run result",
"required": [
"run_id",
"conversation_id",
"status",
"messages"
],
"properties": {
"run_id": {
"type": [
"string",
"null"
]
},
"status": {
"type": "string"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"markdown",
"card"
],
"properties": {
"card": {
"anyOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string"
},
"summary": {
"type": "object"
}
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"markdown": {
"type": "string"
}
},
"additionalProperties": true
}
},
"conversation_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "GEN queued message result",
"required": [
"queued",
"status"
],
"properties": {
"queued": {
"type": "boolean"
},
"status": {
"type": "string"
},
"position": {
"type": [
"integer",
"null"
]
},
"timed_out": {
"type": "boolean"
},
"pending_id": {
"type": [
"string",
"null"
]
},
"active_run_id": {
"type": [
"string",
"null"
]
},
"conversation_id": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"title": "Legacy family dispatch result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"required": [
"status",
"run_id",
"question",
"next_tool",
"next_args",
"typed_options"
],
"properties": {
"run_id": {
"type": "string"
},
"status": {
"const": "waiting_for_user"
},
"question": {
"type": "string"
},
"next_args": {
"type": "object",
"required": [
"run_id",
"message"
],
"properties": {
"run_id": {
"type": "string"
},
"message": {
"type": "string"
}
}
},
"next_tool": {
"const": "gen_ask"
},
"typed_options": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
]
},
"annotations": {
"title": "Generate report ideas",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| any |
| confirm_token | any |
{
"name": "gen_platform_action",
"title": "Manage workspaces, API keys, preferences, and backups",
"description": "Only workspace members/preferences/API access.\ncreate_api_key():Create a workspace API credential; next: give the person the returned download_url.\ncreate_organization(name):Create a workspace with the supplied name; next: read platform.organization.\ncreate_proof_of_genesis_backup(asset_url):Save an asset's proof-of-genesis backup; next: read platform.backups.\ndelete_organization(organization_id):Delete the named workspace; next: confirm only after user approval.\ninvite_member(organization_id,username_or_email):Invite the named person to a workspace role; next: read platform.members.\nleave_workspace(organization_id):Leave the named workspace; next: read platform.organizations.\nremove_member(organization_id,user_id):Remove the named workspace member; next: read platform.members.\nremove_proof_of_genesis_backup(backup_id):Delete the named backup; next: read platform.backups.\nrequest_email_link_code(email):Start email linking for the supplied address; next: verify_email_link_code.\nresend_email_link_code(request_id):Resend a requested email code; next: verify_email_link_code.\nrevoke_all_api_keys():Revoke every caller API key; next: sign in again.\nrevoke_api_key(token_id):Revoke the named API key; next: read platform.api_keys.\nset_member_role(organization_id,role,username_or_email):Change the named workspace member's role; next: read platform.members.\nstart_seat_checkout(organization_id,return_url):Open checkout to add workspace seats; next: follow returned URL.\ntransfer_workspace_ownership(organization_id,username_or_email):Transfer workspace ownership to its named member; next: confirm.\nupdate_api_key(name,token_id):Rename the named API credential; next: read platform.api_keys.\nupdate_organization(name,organization_id):Rename the named workspace; next: read platform.organization.\nupdate_session_preferences(conversation_id,preferences):Save conversation preferences; next: read platform.preferences.\nupgrade_workspace(credit_plan_id,organization_id,return_url):Open the workspace plan upgrade; next: follow returned checkout URL.\nverify_email_link_code(code,request_id):Verify the requested email code as text; next: read the link result.",
"inputSchema": {
"type": "object",
"required": [
"actions"
],
"properties": {
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"create_api_key",
"create_organization",
"create_proof_of_genesis_backup",
"delete_organization",
"invite_member",
"leave_workspace",
"remove_member",
"remove_proof_of_genesis_backup",
"request_email_link_code",
"resend_email_link_code",
"revoke_all_api_keys",
"revoke_api_key",
"set_member_role",
"start_seat_checkout",
"transfer_workspace_ownership",
"update_api_key",
"update_organization",
"update_session_preferences",
"upgrade_workspace",
"verify_email_link_code"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {},
"confirm_token": {}
},
"additionalProperties": true
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"title": "GEN action family result",
"required": [
"family_tool",
"results",
"is_error"
],
"properties": {
"error": {
"type": [
"object",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"error": {
"type": [
"object",
"null"
]
},
"index": {
"type": "integer"
},
"action": {
"type": "string"
},
"result": {},
"status": {
"type": "string"
}
},
"additionalProperties": true
}
},
"agent_id": {
"type": [
"string",
"null"
]
},
"is_error": {
"type": "boolean"
},
"family_tool": {
"type": "string"
}
},
"description": "One action batch: results has one entry per requested action, in order; a batch that stopped is is_error true and the failed entry carries its typed error. A refusal instead of a batch answers code + message.",
"additionalProperties": true
},
{
"type": "object",
"title": "GEN refusal",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"tool": {
"type": "string"
},
"error": {},
"detail": {},
"errors": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"array",
"null"
]
},
"schema": {
"type": [
"string",
"object",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"fragment": {
"type": [
"string",
"null"
]
},
"failed_attribute": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
]
}
},
{
"type": "object"
}
]
},
"message": {
"type": [
"string",
"null"
]
},
"recovery": {
"type": "string"
},
"trace_id": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"error_code": {
"type": [
"string",
"null"
]
},
"field_path": {
"type": [
"string",
"null"
]
},
"next_action": {
"type": [
"object",
"null"
]
},
"status_code": {
"type": [
"integer",
"null"
]
},
"catalog_revision": {
"type": "string"
},
"rails_error_code": {
"type": [
"string",
"null"
]
}
},
"description": "A typed refusal instead of a result: code names what was refused, message explains it, field_path points at the offending argument when one is named, and next_action says what to do next.",
"additionalProperties": true
}
],
"title": "GEN action result"
},
"annotations": {
"title": "Manage workspaces, API keys, preferences, and backups",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}| array |
| no_paid | any |
| agent_id | any |
| idempotency_key | any |
| spending_run_id | any |
| max_paid_operations | any |
{
"name": "gen_vidsheet_action",
"title": "Vidsheet action",
"description": "Only edit/generate Vidsheet rows.\nadd_column():Add a workspace column with required name and kind; fill rows only through set_cell; next: read vidsheet.columns.\nadd_layer():Add a timeline layer to the target row; next: read vidsheet.layers.\napply_storyboard():Apply an authored storyboard to an owned row; next: read the saved sheet.\nclone_template():Create a workspace from a template_slug; next: read vidsheet.sheet.\nclose_gap(target):Close the gap immediately before the target layer, shifting that layer and its later track siblings together; refuses when no gap exists.\ncontinue_generation(generation_id,idempotency_key):Resume the accepted generation_id; next: read vidsheet.generation.\ncreate(target,values):Add a Vidsheet, column, row, layer or variable.\ncreate_engine():Create the workspace engine for template_slug and idea_id; next: read vidsheet.engine.\ncreate_sheet():Create an editable workspace without a saved idea; next: read vidsheet.sheet. Saved ideas use create_video_from_idea.\ndelete(target):Delete the target via confirmation token.\nduplicate(target):Copy a Vidsheet, column, row or layer.\nduplicate_sheet():Copy an existing vidsheet_id; next: read the new vidsheet.sheet.\nexport(target):Export targeted Vidsheet rows as CSV.\ngenerate(card,target):Run a creation card on the target.\nimport_asset(vidsheet_id):Add owned media to an existing workspace; next: read vidsheet.rows.\nredo(target):Redo an edit on the targeted Vidsheet.\nrefund_unused_output():Request credit recovery for unused generation output; next: read receipt.\nreorder(ids,target):Set order using every sibling target id.\nset_cell():Save authored cell values or a creation card with required row, column and value; next: read vidsheet.cell.\nstop_generation(generation_id):Stop the accepted generation_id; next: read vidsheet.generation.\nundo(target):Undo an edit on the targeted Vidsheet.\nupdate(target,values):Save target fields without generating.\nupdate_layer():Save fields on an existing layer_id; next: read vidsheet.layer.",
"inputSchema": {
"type": "object",
"properties": {
"op": {
"enum": [
"add_column",
"add_layer",
"apply_storyboard",
"clone_template",
"continue_generation",
"create_engine",
"create_sheet",
"duplicate_sheet",
"generate",
"import_asset",
"refund_unused_output",
"set_cell",
"stop_generation",
"update_layer"
],
"type": "string"
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"close_gap",
"create",
"delete",
"duplicate",
"export",
"generate",
"redo",
"reorder",
"undo",
"update"
],
"type": "string"
}
},
"additionalProperties": true
}
},
"no_paid": {},
"agent_id": {},
"idempotency_key": {},
"spending_run_id": {},
"max_paid_operations": {}
},
"additionalProperties": true
},
"outputSchema": {
"truncated": true,
"chars": 40851
},
"annotations": {
"title": "Vidsheet action",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}