update_ad_account

Instructions

Implementation Reference

• src/tools/account.ts:57-69 (handler)

  The async handler function that executes the update_ad_account tool logic. It collects optional parameters (name, timezone_name, spend_cap) and sends a POST request to the Meta Ads API using client.accountPath.

    async ({ name, timezone_name, spend_cap }) => {
      try {
        const params: Record<string, unknown> = {};
        if (name) params.name = name;
        if (timezone_name) params.timezone_name = timezone_name;
        if (spend_cap) params.spend_cap = spend_cap;
        const { data, rateLimit } = await client.post(`${client.accountPath}`, 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/account.ts:52-56 (schema)

  Input schema for update_ad_account using Zod: name (optional string), timezone_name (optional string), spend_cap (optional string).

  {
    name: z.string().optional().describe("New account name"),
    timezone_name: z.string().optional().describe("New timezone (e.g. 'America/New_York')"),
    spend_cap: z.string().optional().describe("Account spend cap in currency cents (e.g. '100000' = $1000.00)"),
  },

• src/tools/account.ts:49-69 (registration)

  Registration of the 'update_ad_account' tool on the MCP server via server.tool(), including its description and schema.

  server.tool(
    "update_ad_account",
    "Update the configured ad account settings. Only provided fields will be modified.",
    {
      name: z.string().optional().describe("New account name"),
      timezone_name: z.string().optional().describe("New timezone (e.g. 'America/New_York')"),
      spend_cap: z.string().optional().describe("Account spend cap in currency cents (e.g. '100000' = $1000.00)"),
    },
    async ({ name, timezone_name, spend_cap }) => {
      try {
        const params: Record<string, unknown> = {};
        if (name) params.name = name;
        if (timezone_name) params.timezone_name = timezone_name;
        if (spend_cap) params.spend_cap = spend_cap;
        const { data, rateLimit } = await client.post(`${client.accountPath}`, 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/services/ads-client.ts:187-192 (helper)

  The AdsClient.post() method used by the handler to send the POST request to the Meta API.

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

• src/services/ads-client.ts:213-215 (helper)

  The accountPath getter that constructs the API path as /act_{accountId}, used by the handler for the POST request.

  get accountPath(): string {
    return `/act_${this.accountId}`;
  }