# MCP tool reference > Inspect every Console MCP tool, delegated authority rule, required input, and generated input and output schema. Canonical: https://entirefeed.com/docs/reference/mcp This reference mirrors the current public MCP catalog. Clients should load the live server's tool list when connecting and use this page for review, indexing, and agent-readable schema detail. ## Authority and connection Endpoint: `https://api.entirefeed.com/mcp/` Credential: `efmcp_live_...`; delegated current-user authority. Current membership, role, and capabilities on every request. Server operating guidance: Call get_console_agent_best_practices with the topic closest to your next action before workflow edits, paid runs, output review, or publishing actions. Estimate generation requests before creating them. Stable caller-generated idempotency keys are required for generation create and retry. Use compact task/model lists, then get one task for full schemas. For local media, prepare a one-time upload and send raw multipart bytes to the returned handoff before using its HTTPS URL. Use workflow list/search tools for compact discovery. Call get_console_workflow before editing or running a workflow, then pass the returned definition_hash as expected_definition_hash. Do not compute workflow hashes yourself. For publishing, list compact summaries first, call get_console_publishing_post before edits, schedule with explicit scheduled_for and IANA timezone, and use scheduled_post_id for reschedule or cancel. publish-now is intentionally unavailable. | Action | Required capability | | --- | --- | | Discover and inspect generation | `generations:read` | | Estimate, create, or retry generation | `playground:run` | | Prepare a local media upload | `workflows:run` | | Cancel generation | `generations:cancel` | | Read, edit, or run workflows | `workflows:read, workflows:manage, workflows:run` | | Read or edit publishing drafts | `publishing:read, publishing:manage` | | Schedule, reschedule, or cancel | `publishing:schedule` | | Read publishing analytics | `publishing:analytics:read` | ## Generated tool contracts Current catalog: 52 tools across 5 guide categories. ### Guidance #### `get_console_agent_best_practices` Return concise, topic-specific best-practice guidance for Console agents. Use when the agent needs output-quality, workflow-construction, format-analysis, prompting, asset, or publishing-quality, or billing guidance. Topics: workflow_construction, prompting, reference_video_analysis, workflow_validation, billing, video_generation, output_review, assets_personas_voices, publishing_approval, anti_overfitting. Required inputs: none. Input schema: ```json { "properties": { "topic": { "default": "workflow_construction", "title": "Topic", "type": "string" } }, "title": "get_console_agent_best_practicesArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_agent_best_practicesDictOutput", "type": "object" } ``` ### Media uploads #### `prepare_console_media_upload` Prepare a short-lived, one-time multipart upload for a local image, video, or audio file. Send the raw file bytes directly to the returned URL using its method, headers, and form field; do not encode the file as base64. The upload response URL can be used in generation and workflow inputs. Required inputs: `filename`, `content_type`, `size_bytes`. Input schema: ```json { "properties": { "content_type": { "maxLength": 100, "minLength": 1, "title": "Content Type", "type": "string" }, "filename": { "maxLength": 255, "minLength": 1, "title": "Filename", "type": "string" }, "sha256": { "anyOf": [ { "maxLength": 64, "minLength": 64, "type": "string" }, { "type": "null" } ], "default": null, "title": "Sha256" }, "size_bytes": { "exclusiveMinimum": 0, "title": "Size Bytes", "type": "integer" } }, "required": [ "filename", "content_type", "size_bytes" ], "title": "prepare_console_media_uploadArguments", "type": "object" } ``` Output schema: ```json { "$defs": { "MediaUploadHandoffResponse": { "properties": { "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "form_field": { "const": "file", "default": "file", "title": "Form Field", "type": "string" }, "headers": { "additionalProperties": { "type": "string" }, "title": "Headers", "type": "object" }, "max_size_bytes": { "exclusiveMinimum": 0, "title": "Max Size Bytes", "type": "integer" }, "method": { "const": "POST", "default": "POST", "title": "Method", "type": "string" }, "url": { "title": "Url", "type": "string" } }, "required": [ "url", "headers", "expires_at", "max_size_bytes" ], "title": "MediaUploadHandoffResponse", "type": "object" } }, "properties": { "next": { "title": "Next", "type": "string" }, "upload": { "$ref": "#/$defs/MediaUploadHandoffResponse" } }, "required": [ "upload", "next" ], "title": "MediaUploadHandoffToolResponse", "type": "object" } ``` ### Generation #### `cancel_console_generation` Cancel one queued or running generation by gen_... id. Required inputs: `generation_id`. Input schema: ```json { "properties": { "generation_id": { "title": "Generation Id", "type": "string" } }, "required": [ "generation_id" ], "title": "cancel_console_generationArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "cancel_console_generationDictOutput", "type": "object" } ``` #### `create_console_generation` Create one generation. Supply a stable caller-generated idempotency key to deduplicate retries. Model-less tasks must omit model. Required inputs: `task`, `input`, `idempotency_key`. Input schema: ```json { "properties": { "idempotency_key": { "maxLength": 255, "minLength": 1, "title": "Idempotency Key", "type": "string" }, "input": { "additionalProperties": true, "title": "Input", "type": "object" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Metadata" }, "model": { "default": null, "title": "Model", "type": "string" }, "task": { "title": "Task", "type": "string" } }, "required": [ "task", "input", "idempotency_key" ], "title": "create_console_generationArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "create_console_generationDictOutput", "type": "object" } ``` #### `estimate_console_generation` Estimate one generation request without creating it. Model-less tasks must omit model. Required inputs: `task`, `input`. Input schema: ```json { "properties": { "input": { "additionalProperties": true, "title": "Input", "type": "object" }, "model": { "default": null, "title": "Model", "type": "string" }, "task": { "title": "Task", "type": "string" } }, "required": [ "task", "input" ], "title": "estimate_console_generationArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "estimate_console_generationDictOutput", "type": "object" } ``` #### `get_console_generation` Get one generation with its output, usage, error, and metadata. Required inputs: `generation_id`. Input schema: ```json { "properties": { "generation_id": { "title": "Generation Id", "type": "string" } }, "required": [ "generation_id" ], "title": "get_console_generationArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_generationDictOutput", "type": "object" } ``` #### `get_console_generation_task` Get one generation task with its available models, schemas, defaults, and output schema. Required inputs: `task_id`. Input schema: ```json { "properties": { "task_id": { "title": "Task Id", "type": "string" } }, "required": [ "task_id" ], "title": "get_console_generation_taskArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_generation_taskDictOutput", "type": "object" } ``` #### `list_console_generation_models` List generation models as compact summaries. Schemas and defaults are intentionally omitted; inspect the relevant task with get_console_generation_task. Required inputs: none. Input schema: ```json { "properties": {}, "title": "list_console_generation_modelsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_generation_modelsDictOutput", "type": "object" } ``` #### `list_console_generation_tasks` List generation tasks as compact summaries, including available and coming-soon tasks. Call get_console_generation_task for schemas and defaults. Required inputs: none. Input schema: ```json { "properties": {}, "title": "list_console_generation_tasksArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_generation_tasksDictOutput", "type": "object" } ``` #### `list_console_generations` List generations as compact summaries without API-key or input details. Required inputs: none. Input schema: ```json { "properties": { "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Cursor" }, "limit": { "default": 50, "title": "Limit", "type": "integer" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Model" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Task" } }, "title": "list_console_generationsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_generationsDictOutput", "type": "object" } ``` #### `retry_console_generation` Retry a failed or cancelled generation as a new billed request. Requires a caller-supplied idempotency key. Required inputs: `generation_id`, `idempotency_key`. Input schema: ```json { "properties": { "generation_id": { "title": "Generation Id", "type": "string" }, "idempotency_key": { "maxLength": 255, "minLength": 1, "title": "Idempotency Key", "type": "string" } }, "required": [ "generation_id", "idempotency_key" ], "title": "retry_console_generationArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "retry_console_generationDictOutput", "type": "object" } ``` ### Workflows #### `cancel_console_workflow_run` Cancel an active Console workflow run. Required inputs: `run_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "run_id": { "title": "Run Id", "type": "string" }, "run_tab_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Run Tab Id" } }, "required": [ "run_id" ], "title": "cancel_console_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "cancel_console_workflow_runDictOutput", "type": "object" } ``` #### `cancel_public_workflow_run` Cancel a queued or active public workflow starter run by wrun_... id. Required inputs: `workflow_run_id`. Input schema: ```json { "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Reason" }, "workflow_run_id": { "title": "Workflow Run Id", "type": "string" } }, "required": [ "workflow_run_id" ], "title": "cancel_public_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "cancel_public_workflow_runDictOutput", "type": "object" } ``` #### `create_console_workflow` Create a Console workflow from a full workflow definition. Required inputs: `name`, `definition`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "definition": { "additionalProperties": true, "title": "Definition", "type": "object" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Description" }, "name": { "title": "Name", "type": "string" } }, "required": [ "name", "definition" ], "title": "create_console_workflowArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "create_console_workflowDictOutput", "type": "object" } ``` #### `create_console_workflow_from_starter` Create a Console workflow from a supported workflow starter template. Required inputs: `starter_slug`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Description" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "starter_slug": { "title": "Starter Slug", "type": "string" } }, "required": [ "starter_slug" ], "title": "create_console_workflow_from_starterArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "create_console_workflow_from_starterDictOutput", "type": "object" } ``` #### `delete_console_workflow` Soft-delete a Console workflow from active workflow lists. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "delete_console_workflowArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": { "type": "string" }, "title": "delete_console_workflowDictOutput", "type": "object" } ``` #### `estimate_console_workflow_run` Estimate a Console workflow run and return cost plus estimate_version for run_console_workflow. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "definition_override": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Definition Override" }, "expected_definition_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Expected Definition Hash" }, "inputs": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Inputs" }, "source_execution_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Source Execution Id" }, "target_node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Target Node Id" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "estimate_console_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "estimate_console_workflow_runDictOutput", "type": "object" } ``` #### `estimate_public_workflow_starter_run` Estimate a public workflow starter run and return estimate_version for run_public_workflow_starter. Required inputs: `starter_slug`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "inputs": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Inputs" }, "starter_slug": { "title": "Starter Slug", "type": "string" }, "starter_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Starter Version" } }, "required": [ "starter_slug" ], "title": "estimate_public_workflow_starter_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "estimate_public_workflow_starter_runDictOutput", "type": "object" } ``` #### `get_console_workflow` Get one Console workflow including its full definition and revision hashes. Use definition_hash as expected_definition_hash for edits and runs. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "get_console_workflowArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_workflowDictOutput", "type": "object" } ``` #### `get_console_workflow_node_schema` Fetch the full schema for one workflow node type. Required inputs: `node_type`. Input schema: ```json { "properties": { "node_type": { "title": "Node Type", "type": "string" } }, "required": [ "node_type" ], "title": "get_console_workflow_node_schemaArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_workflow_node_schemaDictOutput", "type": "object" } ``` #### `get_console_workflow_run` Get one Console workflow run with compact jobs, outputs, and error information. Required inputs: `run_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "jobs", "title": "Include" }, "run_id": { "title": "Run Id", "type": "string" } }, "required": [ "run_id" ], "title": "get_console_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_workflow_runDictOutput", "type": "object" } ``` #### `get_public_workflow_run` Get one public workflow starter run by wrun_... id. Required inputs: `workflow_run_id`. Input schema: ```json { "properties": { "workflow_run_id": { "title": "Workflow Run Id", "type": "string" } }, "required": [ "workflow_run_id" ], "title": "get_public_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_public_workflow_runDictOutput", "type": "object" } ``` #### `get_public_workflow_starter` Get one public workflow starter with its public input/output schemas and example payloads. Required inputs: `starter_slug`. Input schema: ```json { "properties": { "starter_slug": { "title": "Starter Slug", "type": "string" } }, "required": [ "starter_slug" ], "title": "get_public_workflow_starterArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_public_workflow_starterDictOutput", "type": "object" } ``` #### `list_active_console_workflow_runs` List active Console workflow runs with compact status details. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "include": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Include" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "list_active_console_workflow_runsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_active_console_workflow_runsDictOutput", "type": "object" } ``` #### `list_console_workflow_nodes` List workflow node types as compact summaries. Use get_console_workflow_node_schema for one full schema. Required inputs: none. Input schema: ```json { "properties": { "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Category" }, "limit": { "default": 80, "title": "Limit", "type": "integer" } }, "title": "list_console_workflow_nodesArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_workflow_nodesDictOutput", "type": "object" } ``` #### `list_console_workflow_runs` List compact historical runs for a Console workflow. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "list_console_workflow_runsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_workflow_runsDictOutput", "type": "object" } ``` #### `list_console_workflow_starters` List Console workflow starters that can create starter workflows. Required inputs: none. Input schema: ```json { "properties": {}, "title": "list_console_workflow_startersArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_workflow_startersDictOutput", "type": "object" } ``` #### `list_console_workflows` List Console workflows as compact summaries. Does not return workflow definitions. Use get_console_workflow when you need the full graph and definition_hash. Required inputs: none. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "limit": { "default": 50, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "search": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Search" } }, "title": "list_console_workflowsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_workflowsDictOutput", "type": "object" } ``` #### `list_public_workflow_runs` List public workflow starter runs with optional status and starter filters. Required inputs: none. Input schema: ```json { "properties": { "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Cursor" }, "limit": { "default": 50, "title": "Limit", "type": "integer" }, "starter_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Starter Slug" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "list_public_workflow_runsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_public_workflow_runsDictOutput", "type": "object" } ``` #### `list_public_workflow_starters` List public workflow starters that can be estimated and run without exposing the workflow builder. Required inputs: none. Input schema: ```json { "properties": {}, "title": "list_public_workflow_startersArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_public_workflow_startersDictOutput", "type": "object" } ``` #### `pin_console_workflow_node` Pin a Console workflow node from an existing completed workflow run/job. Only use when the user explicitly asks to pin or reuse a node output; pinning mutates workflow state and changes workflow hashes. source_execution_id must be the workflow run id returned by get_console_workflow_run, not the operation_id returned by run_console_workflow. Requires the current definition_hash as expected_definition_hash. Required inputs: `workflow_id`, `node_id`, `source_execution_id`, `expected_definition_hash`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "expected_definition_hash": { "title": "Expected Definition Hash", "type": "string" }, "node_id": { "title": "Node Id", "type": "string" }, "source_execution_id": { "title": "Source Execution Id", "type": "string" }, "source_job_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Source Job Ids" }, "upstream_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Upstream Hash" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "node_id", "source_execution_id", "expected_definition_hash" ], "title": "pin_console_workflow_nodeArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "pin_console_workflow_nodeDictOutput", "type": "object" } ``` #### `retry_console_workflow_run` Retry a failed or cancelled Console workflow run. Requires an idempotency_key. Required inputs: `run_id`, `idempotency_key`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "idempotency_key": { "title": "Idempotency Key", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" } }, "required": [ "run_id", "idempotency_key" ], "title": "retry_console_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "retry_console_workflow_runDictOutput", "type": "object" } ``` #### `retry_public_workflow_run` Retry a failed or cancelled public workflow starter run. Requires an idempotency_key. Required inputs: `workflow_run_id`, `idempotency_key`. Input schema: ```json { "properties": { "idempotency_key": { "title": "Idempotency Key", "type": "string" }, "workflow_run_id": { "title": "Workflow Run Id", "type": "string" } }, "required": [ "workflow_run_id", "idempotency_key" ], "title": "retry_public_workflow_runArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "retry_public_workflow_runDictOutput", "type": "object" } ``` #### `run_console_workflow` Run a Console workflow after estimating it. Requires an idempotency_key for billable safety. Required inputs: `workflow_id`, `estimate_version`, `expected_definition_hash`, `idempotency_key`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "definition_override": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Definition Override" }, "estimate_version": { "title": "Estimate Version", "type": "string" }, "expected_definition_hash": { "title": "Expected Definition Hash", "type": "string" }, "idempotency_key": { "title": "Idempotency Key", "type": "string" }, "inputs": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Inputs" }, "source_execution_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Source Execution Id" }, "target_node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Target Node Id" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "estimate_version", "expected_definition_hash", "idempotency_key" ], "title": "run_console_workflowArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "run_console_workflowDictOutput", "type": "object" } ``` #### `run_public_workflow_starter` Run a public workflow starter after estimating it. Requires an idempotency_key for billable safety. Required inputs: `starter_slug`, `estimate_version`, `idempotency_key`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "estimate_version": { "title": "Estimate Version", "type": "string" }, "idempotency_key": { "title": "Idempotency Key", "type": "string" }, "inputs": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Inputs" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Metadata" }, "starter_slug": { "title": "Starter Slug", "type": "string" }, "starter_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Starter Version" } }, "required": [ "starter_slug", "estimate_version", "idempotency_key" ], "title": "run_public_workflow_starterArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "run_public_workflow_starterDictOutput", "type": "object" } ``` #### `search_console_workflow_nodes` Search workflow node types by node type, label, description, category, inputs, and outputs. Required inputs: `query`. Input schema: ```json { "properties": { "limit": { "default": 20, "title": "Limit", "type": "integer" }, "query": { "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "search_console_workflow_nodesArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "search_console_workflow_nodesDictOutput", "type": "object" } ``` #### `unpin_console_workflow_node` Unpin a Console workflow node, restoring normal execution for that node. Requires the current definition_hash as expected_definition_hash. Required inputs: `workflow_id`, `node_id`, `expected_definition_hash`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "expected_definition_hash": { "title": "Expected Definition Hash", "type": "string" }, "node_id": { "title": "Node Id", "type": "string" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "node_id", "expected_definition_hash" ], "title": "unpin_console_workflow_nodeArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "unpin_console_workflow_nodeDictOutput", "type": "object" } ``` #### `update_console_workflow_definition` Replace a Console workflow definition. expected_definition_hash must be the definition_hash returned by get_console_workflow or the previous write result. Required inputs: `workflow_id`, `definition`, `expected_definition_hash`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "definition": { "additionalProperties": true, "title": "Definition", "type": "object" }, "expected_definition_hash": { "title": "Expected Definition Hash", "type": "string" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "definition", "expected_definition_hash" ], "title": "update_console_workflow_definitionArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "update_console_workflow_definitionDictOutput", "type": "object" } ``` #### `update_console_workflow_metadata` Update Console workflow metadata without changing the graph definition. Required inputs: `workflow_id`. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Description" }, "expected_definition_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Expected Definition Hash" }, "is_active": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "title": "Is Active" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Name" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id" ], "title": "update_console_workflow_metadataArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "update_console_workflow_metadataDictOutput", "type": "object" } ``` ### Publishing #### `cancel_console_publishing_scheduled_post` Cancel an existing scheduled publishing action by explicit scheduled_post_id. This does not delete the draft post. PENDING, QUEUED, CLAIMED, and FAILED scheduled actions can be cancelled. Required inputs: `scheduled_post_id`. Input schema: ```json { "properties": { "scheduled_post_id": { "title": "Scheduled Post Id", "type": "string" } }, "required": [ "scheduled_post_id" ], "title": "cancel_console_publishing_scheduled_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "cancel_console_publishing_scheduled_postDictOutput", "type": "object" } ``` #### `create_console_publishing_post` Create a TikTok publishing draft from HTTPS media references. Supported content types are VIDEO, IMAGE, and CAROUSEL. This does not schedule or publish the post; call schedule_console_publishing_post separately with the returned post id. Required inputs: `account_id`, `platform`, `content_type`, `media_urls`. Input schema: ```json { "properties": { "account_id": { "title": "Account Id", "type": "string" }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Caption" }, "caption_plain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Caption Plain" }, "content": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Content" }, "content_type": { "enum": [ "VIDEO", "IMAGE", "CAROUSEL" ], "title": "Content Type", "type": "string" }, "generation_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Generation Metadata" }, "generation_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Generation Prompt" }, "hashtags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Hashtags" }, "media_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Media Count" }, "media_urls": { "items": { "type": "string" }, "title": "Media Urls", "type": "array" }, "mentions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Mentions" }, "platform": { "const": "TIKTOK", "title": "Platform", "type": "string" }, "platform_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Platform Metadata" }, "render_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Render Metadata" }, "source_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Source Metadata" }, "source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Source Url" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Thumbnail Url" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" } }, "required": [ "account_id", "platform", "content_type", "media_urls" ], "title": "create_console_publishing_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "create_console_publishing_postDictOutput", "type": "object" } ``` #### `get_console_publishing_analytics_breakdown` Get compact publishing analytics grouped by account, platform, status, or content_type. Required inputs: `group_by`. Input schema: ```json { "properties": { "from_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "From Time" }, "group_by": { "enum": [ "account", "platform", "status", "content_type" ], "title": "Group By", "type": "string" }, "to_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "To Time" } }, "required": [ "group_by" ], "title": "get_console_publishing_analytics_breakdownArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_publishing_analytics_breakdownDictOutput", "type": "object" } ``` #### `get_console_publishing_analytics_summary` Get a compact publishing analytics summary for an optional date, account, or post filter. Required inputs: none. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "from_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "From Time" }, "post_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Post Ids" }, "to_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "To Time" } }, "title": "get_console_publishing_analytics_summaryArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_publishing_analytics_summaryDictOutput", "type": "object" } ``` #### `get_console_publishing_analytics_timeseries` Get compact daily publishing analytics points. Only day interval is supported. Required inputs: none. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "from_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "From Time" }, "interval": { "const": "day", "default": "day", "title": "Interval", "type": "string" }, "to_time": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "To Time" } }, "title": "get_console_publishing_analytics_timeseriesArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_publishing_analytics_timeseriesDictOutput", "type": "object" } ``` #### `get_console_publishing_post` Get one Console publishing post with full edit context, including captions, media URLs, sanitized metadata, schedules, and analytics snapshots. Required inputs: `post_id`. Input schema: ```json { "properties": { "post_id": { "title": "Post Id", "type": "string" } }, "required": [ "post_id" ], "title": "get_console_publishing_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_publishing_postDictOutput", "type": "object" } ``` #### `get_console_publishing_schedule_board` Get a compact publishing schedule board across active schedules and recent publish activity. Required inputs: none. Input schema: ```json { "properties": { "activity_since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Activity Since" }, "limit": { "default": 250, "title": "Limit", "type": "integer" } }, "title": "get_console_publishing_schedule_boardArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "get_console_publishing_schedule_boardDictOutput", "type": "object" } ``` #### `list_console_publishing_accounts` List Console publishing accounts with compact capability and integration status. Required inputs: none. Input schema: ```json { "properties": {}, "title": "list_console_publishing_accountsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_publishing_accountsDictOutput", "type": "object" } ``` #### `list_console_publishing_posts` List Console publishing posts as compact summaries. Does not include full captions, metadata blobs, source metadata, generation metadata, analytics snapshots, or media URLs. Use get_console_publishing_post for full edit context. Required inputs: none. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "created_after": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Created After" }, "created_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Created Before" }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Cursor" }, "limit": { "default": 50, "title": "Limit", "type": "integer" }, "platform": { "anyOf": [ { "const": "TIKTOK", "type": "string" }, { "type": "null" } ], "default": null, "title": "Platform" }, "published_after": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Published After" }, "published_before": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Published Before" }, "search": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Search" }, "sort": { "default": "created_desc", "enum": [ "created_desc", "updated_desc", "published_desc", "views_desc" ], "title": "Sort", "type": "string" }, "status": { "anyOf": [ { "enum": [ "DRAFT", "PENDING_REVIEW", "APPROVED", "SCHEDULED", "QUEUED", "PUBLISHING", "PUBLISHED", "FAILED", "ARCHIVED" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" } }, "title": "list_console_publishing_postsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_publishing_postsDictOutput", "type": "object" } ``` #### `list_console_publishing_scheduled_posts` List compact Console scheduled publishing actions. Use explicit scheduled_post_id for changes. Required inputs: none. Input schema: ```json { "properties": { "account_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Account Id" }, "completed_since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Completed Since" }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Cursor" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "status": { "anyOf": [ { "enum": [ "PENDING", "QUEUED", "CLAIMED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED", "SKIPPED" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Status" }, "statuses": { "anyOf": [ { "items": { "enum": [ "PENDING", "QUEUED", "CLAIMED", "RUNNING", "COMPLETED", "FAILED", "CANCELLED", "SKIPPED" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Statuses" } }, "title": "list_console_publishing_scheduled_postsArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "list_console_publishing_scheduled_postsDictOutput", "type": "object" } ``` #### `reschedule_console_publishing_scheduled_post` Reschedule an existing scheduled publishing action. Requires explicit scheduled_post_id, scheduled_for, and IANA timezone; do not infer the schedule from a post id. PENDING, QUEUED, CLAIMED, and FAILED scheduled actions can be rescheduled. Required inputs: `scheduled_post_id`, `scheduled_for`, `timezone`. Input schema: ```json { "properties": { "scheduled_for": { "title": "Scheduled For", "type": "string" }, "scheduled_post_id": { "title": "Scheduled Post Id", "type": "string" }, "timezone": { "title": "Timezone", "type": "string" } }, "required": [ "scheduled_post_id", "scheduled_for", "timezone" ], "title": "reschedule_console_publishing_scheduled_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "reschedule_console_publishing_scheduled_postDictOutput", "type": "object" } ``` #### `schedule_console_publishing_post` Schedule an existing Console publishing post. Requires explicit scheduled_for and IANA timezone; do not parse fuzzy natural-language times or guess ambiguous user intent. Required inputs: `post_id`, `scheduled_for`, `timezone`. Input schema: ```json { "properties": { "post_id": { "title": "Post Id", "type": "string" }, "scheduled_for": { "title": "Scheduled For", "type": "string" }, "timezone": { "title": "Timezone", "type": "string" } }, "required": [ "post_id", "scheduled_for", "timezone" ], "title": "schedule_console_publishing_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "schedule_console_publishing_postDictOutput", "type": "object" } ``` #### `update_console_publishing_post` Partially update a Console publishing post. Pass a patch object using ConsolePublishingPostUpdateRequest fields; omitted fields stay unchanged, and explicit null clears nullable fields. This does not schedule or publish the post. Required inputs: `post_id`, `patch`. Input schema: ```json { "properties": { "patch": { "additionalProperties": true, "title": "Patch", "type": "object" }, "post_id": { "title": "Post Id", "type": "string" } }, "required": [ "post_id", "patch" ], "title": "update_console_publishing_postArguments", "type": "object" } ``` Output schema: ```json { "additionalProperties": true, "title": "update_console_publishing_postDictOutput", "type": "object" } ``` ## Guide coverage - `cancel_console_generation`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `cancel_console_publishing_scheduled_post`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `cancel_console_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `cancel_public_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `create_console_generation`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `create_console_publishing_post`: [guide](/docs/publishing/accounts-and-posts); [reference](/docs/reference/mcp) - `create_console_workflow`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `create_console_workflow_from_starter`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `delete_console_workflow`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `estimate_console_generation`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `estimate_console_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `estimate_public_workflow_starter_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_console_agent_best_practices`: [guide](/docs/agents/paid-actions-and-review); [reference](/docs/reference/mcp) - `get_console_generation`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_console_generation_task`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_console_publishing_analytics_breakdown`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `get_console_publishing_analytics_summary`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `get_console_publishing_analytics_timeseries`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `get_console_publishing_post`: [guide](/docs/publishing/accounts-and-posts); [reference](/docs/reference/mcp) - `get_console_publishing_schedule_board`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `get_console_workflow`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_console_workflow_node_schema`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_console_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_public_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `get_public_workflow_starter`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_active_console_workflow_runs`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_generation_models`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_generation_tasks`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_generations`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_publishing_accounts`: [guide](/docs/publishing/accounts-and-posts); [reference](/docs/reference/mcp) - `list_console_publishing_posts`: [guide](/docs/publishing/accounts-and-posts); [reference](/docs/reference/mcp) - `list_console_publishing_scheduled_posts`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `list_console_workflow_nodes`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_workflow_runs`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_workflow_starters`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_console_workflows`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_public_workflow_runs`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `list_public_workflow_starters`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `pin_console_workflow_node`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `prepare_console_media_upload`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `reschedule_console_publishing_scheduled_post`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `retry_console_generation`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `retry_console_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `retry_public_workflow_run`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `run_console_workflow`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `run_public_workflow_starter`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `schedule_console_publishing_post`: [guide](/docs/publishing/schedules); [reference](/docs/reference/mcp) - `search_console_workflow_nodes`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `unpin_console_workflow_node`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `update_console_publishing_post`: [guide](/docs/publishing/accounts-and-posts); [reference](/docs/reference/mcp) - `update_console_workflow_definition`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp) - `update_console_workflow_metadata`: [guide](/docs/agents/tasks-and-workflows); [reference](/docs/reference/mcp)