Skip to main content
Glama

AdsAgent — TikTok Ads MCP

campaigns_recreate_from_task

Prepare a recreation of one caller-owned, fully completed TikTok create/copy task using its opaque task_ref. The original payload is loaded server-side, internal receipt/route fields are removed, and current advertiser ownership and parent bindings are revalidated. Failed, partial, uncertain, or foreign tasks are not recreatable. Use execution.start_time/end_time for an explicitly rescheduled launch. Source end times are never extended automatically.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
task_refYes
executionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for behavioral disclosure. It reveals server-side payload loading, removal of internal receipt/route fields, revalidation of ownership and bindings, and the non-extension of source end times. These are meaningful behavioral traits beyond what the schema shows. It does not mention return values or side effects, but covers the core action thoroughly.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but not wasteful; every sentence adds unique information. The main purpose is front-loaded, followed by behavioral details and usage guidance. It is a bit long but appropriate for the complexity of the tool. No redundant or tautological phrasing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the action, conditions, and parameter usage well, but it does not mention what the tool returns or what the agent should do with the prepared recreation (e.g., follow with campaigns_recreate_confirm). Since there is no output schema and no annotations, the absence of any indication of return value or next-step linkage leaves a gap for an agent that needs to chain tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It does for execution by explaining its purpose ('explicitly rescheduled launch'), and for task_ref by calling it 'opaque' and implying it is a task identifier. It does not explicitly state that execution is optional or default null, but the schema already shows that. The description adds value beyond the schema for both parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb ('prepare a recreation') and resource ('fully completed TikTok create/copy task'), and adds crucial constraints (caller-owned, opaque task_ref). It distinguishes the tool from siblings by specifying it is for fully completed tasks only, and later excludes failed, partial, uncertain, or foreign tasks, which clarifies its niche.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit when-to-use conditions (fully completed tasks) and when-not-to-use (failed, partial, uncertain, foreign tasks). It also gives guidance on using the execution parameter for rescheduled launches. It does not explicitly name alternative tools (e.g., campaigns_recreate_confirm), but the conditions are clear enough for an agent to select it correctly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources