update_creative

Instructions

Implementation Reference

• src/tools/creatives.ts:72-92 (registration)

  Registration of the 'update_creative' MCP tool via server.tool(), including its schema (creative_id required, name and url_tags optional) and handler function.

  // ─── update_creative ───────────────────────────────────────
  server.tool(
    "update_creative",
    "Update an existing ad creative. Only name and url_tags can be modified after creation.",
    {
      creative_id: z.string().describe("Creative ID to update"),
      name: z.string().optional().describe("New creative name"),
      url_tags: z.string().optional().describe("New URL tags"),
    },
    async ({ creative_id, name, url_tags }) => {
      try {
        const params: Record<string, unknown> = {};
        if (name) params.name = name;
        if (url_tags) params.url_tags = url_tags;
        const { data, rateLimit } = await client.post(`/${creative_id}`, params);
        return { content: [{ type: "text" as const, text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] };
      } catch (error) {
        return { content: [{ type: "text" as const, text: `Failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
      }
    }
  );

• src/tools/creatives.ts:81-91 (handler)

  Handler function for update_creative. Takes creative_id, name, url_tags; builds params and sends POST request to /{creative_id} via the AdsClient. Returns JSON result or error.

  async ({ creative_id, name, url_tags }) => {
    try {
      const params: Record<string, unknown> = {};
      if (name) params.name = name;
      if (url_tags) params.url_tags = url_tags;
      const { data, rateLimit } = await client.post(`/${creative_id}`, params);
      return { content: [{ type: "text" as const, text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] };
    } catch (error) {
      return { content: [{ type: "text" as const, text: `Failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
    }
  }

• src/tools/creatives.ts:76-80 (schema)

  Input schema for update_creative using Zod: creative_id (string, required), name (string, optional), url_tags (string, optional). Description states only name and url_tags can be modified after creation.

  {
    creative_id: z.string().describe("Creative ID to update"),
    name: z.string().optional().describe("New creative name"),
    url_tags: z.string().optional().describe("New URL tags"),
  },

• src/services/ads-client.ts:187-191 (helper)

  The AdsClient.post() helper method used by the update_creative handler to send the POST request.

  async post(
    path: string,
    params?: Record<string, unknown>
  ): Promise<ClientResponse> {
    return this.request("POST", path, params);

• src/index.ts:53-53 (registration)

  Registration call in index.ts that wires up registerCreativeTools (which includes update_creative) during server initialization.

  registerCreativeTools(server, client);