@cesteral/tiktok-mcp 1.0.0

package/dist/auth/tiktok-auth-adapter.js

@@ -0,0 +1,126 @@
+import { extractHeader, fetchWithTimeout, fingerprintCredentials, JsonRpcErrorCode, McpError, OAuth2RefreshAdapterBase, } from "@cesteral/shared";
+async function fetchTikTokUserId(token, baseUrl, apiVersion) {
+    const response = await fetchWithTimeout(`${baseUrl}/open_api/${apiVersion}/user/info/`, 10_000, undefined, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!response.ok) {
+        const errorBody = await response.text().catch(() => "");
+        throw new McpError(JsonRpcErrorCode.Unauthorized, `TikTok token validation HTTP error: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
+    }
+    const data = (await response.json());
+    if (data.code !== 0) {
+        throw new McpError(JsonRpcErrorCode.Unauthorized, `TikTok token validation failed: code=${data.code} message=${data.message}`);
+    }
+    return data.data?.display_name ?? data.data?.email ?? "unknown";
+}
+export class TikTokAccessTokenAdapter {
+    accessToken;
+    _advertiserId;
+    baseUrl;
+    apiVersion;
+    validated = false;
+    _userId = "";
+    constructor(accessToken, _advertiserId, baseUrl = "https://business-api.tiktok.com", apiVersion = "v1.3") {
+        this.accessToken = accessToken;
+        this._advertiserId = _advertiserId;
+        this.baseUrl = baseUrl;
+        this.apiVersion = apiVersion;
+    }
+    get userId() {
+        return this._userId;
+    }
+    get advertiserId() {
+        return this._advertiserId;
+    }
+    async getAccessToken() {
+        return this.accessToken;
+    }
+    async validate() {
+        if (this.validated)
+            return;
+        this._userId = await fetchTikTokUserId(this.accessToken, this.baseUrl, this.apiVersion);
+        this.validated = true;
+    }
+}
+export class TikTokRefreshTokenAdapter extends OAuth2RefreshAdapterBase {
+    _advertiserId;
+    baseUrl;
+    apiVersion;
+    _userId = "";
+    constructor(credentials, _advertiserId, baseUrl = "https://business-api.tiktok.com", apiVersion = "v1.3") {
+        super({
+            platformName: "TikTok",
+            credentials,
+            requestToken: async (refreshToken) => {
+                const response = await fetchWithTimeout(`${baseUrl}/open_api/${apiVersion}/oauth2/access_token/`, 10_000, undefined, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        app_id: credentials.appId,
+                        secret: credentials.appSecret,
+                        grant_type: "refresh_token",
+                        refresh_token: refreshToken,
+                    }),
+                });
+                if (!response.ok) {
+                    const errorBody = await response.text().catch(() => "");
+                    throw new McpError(JsonRpcErrorCode.InternalError, `TikTok token refresh failed: ${response.status} ${response.statusText}. ${errorBody.substring(0, 200)}`);
+                }
+                const data = (await response.json());
+                if (data.code !== 0 || !data.data?.access_token) {
+                    throw new McpError(JsonRpcErrorCode.InternalError, `TikTok token refresh failed: code=${data.code} message=${data.message}`);
+                }
+                return {
+                    access_token: data.data.access_token,
+                    expires_in: data.data.expires_in,
+                    refresh_token: data.data.refresh_token,
+                };
+            },
+        });
+        this._advertiserId = _advertiserId;
+        this.baseUrl = baseUrl;
+        this.apiVersion = apiVersion;
+    }
+    get userId() {
+        return this._userId;
+    }
+    get advertiserId() {
+        return this._advertiserId;
+    }
+    async validate() {
+        const token = await this.getAccessToken();
+        this._userId = await fetchTikTokUserId(token, this.baseUrl, this.apiVersion);
+    }
+}
+export function parseTikTokRefreshCredentialsFromHeaders(headers) {
+    const appId = extractHeader(headers, "x-tiktok-app-id");
+    const appSecret = extractHeader(headers, "x-tiktok-app-secret");
+    const refreshToken = extractHeader(headers, "x-tiktok-refresh-token");
+    if (!appId || !appSecret || !refreshToken) {
+        return undefined;
+    }
+    return { appId, appSecret, refreshToken };
+}
+export function parseTikTokTokenFromHeaders(headers) {
+    const authHeader = extractHeader(headers, "authorization");
+    if (!authHeader) {
+        throw new Error("Missing required Authorization header");
+    }
+    const match = authHeader.match(/^Bearer\s+(.+)$/i);
+    if (!match || !match[1]) {
+        throw new Error("Authorization header must use Bearer scheme");
+    }
+    return match[1];
+}
+export function getTikTokAdvertiserIdFromHeaders(headers) {
+    const advertiserId = extractHeader(headers, "x-tiktok-advertiser-id");
+    if (!advertiserId) {
+        throw new Error("Missing required X-TikTok-Advertiser-Id header");
+    }
+    return advertiserId;
+}
+export function getTikTokCredentialFingerprint(accessToken, advertiserId) {
+    return fingerprintCredentials(accessToken, advertiserId);
+}
+//# sourceMappingURL=tiktok-auth-adapter.js.map

package/dist/auth/tiktok-auth-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok-auth-adapter.js","sourceRoot":"","sources":["../../src/auth/tiktok-auth-adapter.ts"],"names":[],"mappings":"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"}

package/dist/auth/tiktok-auth-strategy.d.ts

@@ -0,0 +1,14 @@
+import type { Logger } from "pino";
+import { BearerAuthStrategyBase, type BearerAdapterResult } from "@cesteral/shared";
+export declare class TikTokBearerAuthStrategy extends BearerAuthStrategyBase {
+    private readonly baseUrl;
+    private readonly apiVersion;
+    protected readonly authType = "tiktok-bearer";
+    protected readonly platformName = "TikTok";
+    constructor(baseUrl: string, logger?: Logger, apiVersion?: string);
+    protected resolveRefreshBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult | null>;
+    protected resolveAccessBranch(headers: Record<string, string | string[] | undefined>): Promise<BearerAdapterResult>;
+    protected getRefreshFingerprint(headers: Record<string, string | string[] | undefined>): string | undefined;
+    protected getTokenFingerprint(headers: Record<string, string | string[] | undefined>): string;
+}
+//# sourceMappingURL=tiktok-auth-strategy.d.ts.map

package/dist/auth/tiktok-auth-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok-auth-strategy.d.ts","sourceRoot":"","sources":["../../src/auth/tiktok-auth-strategy.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAUpF,qBAAa,wBAAyB,SAAQ,sBAAsB;IAKhE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,mBAAmB;IAC9C,SAAS,CAAC,QAAQ,CAAC,YAAY,YAAY;gBAGxB,OAAO,EAAE,MAAM,EAChC,MAAM,CAAC,EAAE,MAAM,EACE,UAAU,GAAE,MAAe;cAK9B,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;cAuBtB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,mBAAmB,CAAC;IAoB/B,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,GAAG,SAAS;IAOrB,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM;CAK9F"}

package/dist/auth/tiktok-auth-strategy.js

@@ -0,0 +1,54 @@
+import { BearerAuthStrategyBase } from "@cesteral/shared";
+import { TikTokAccessTokenAdapter, TikTokRefreshTokenAdapter, parseTikTokTokenFromHeaders, parseTikTokRefreshCredentialsFromHeaders, getTikTokAdvertiserIdFromHeaders, getTikTokCredentialFingerprint, } from "./tiktok-auth-adapter.js";
+export class TikTokBearerAuthStrategy extends BearerAuthStrategyBase {
+    baseUrl;
+    apiVersion;
+    authType = "tiktok-bearer";
+    platformName = "TikTok";
+    constructor(baseUrl, logger, apiVersion = "v1.3") {
+        super(logger);
+        this.baseUrl = baseUrl;
+        this.apiVersion = apiVersion;
+    }
+    async resolveRefreshBranch(headers) {
+        const refreshCreds = parseTikTokRefreshCredentialsFromHeaders(headers);
+        if (!refreshCreds)
+            return null;
+        const advertiserId = getTikTokAdvertiserIdFromHeaders(headers);
+        const adapter = new TikTokRefreshTokenAdapter(refreshCreds, advertiserId, this.baseUrl, this.apiVersion);
+        await adapter.validate();
+        return {
+            adapter,
+            fingerprint: getTikTokCredentialFingerprint(refreshCreds.appId, advertiserId),
+            userId: adapter.userId,
+            authFlow: "refresh-token",
+            logContext: { advertiserId },
+        };
+    }
+    async resolveAccessBranch(headers) {
+        const token = parseTikTokTokenFromHeaders(headers);
+        const advertiserId = getTikTokAdvertiserIdFromHeaders(headers);
+        const adapter = new TikTokAccessTokenAdapter(token, advertiserId, this.baseUrl, this.apiVersion);
+        await adapter.validate();
+        return {
+            adapter,
+            fingerprint: getTikTokCredentialFingerprint(token, advertiserId),
+            userId: adapter.userId,
+            authFlow: "static-token",
+            logContext: { advertiserId },
+        };
+    }
+    getRefreshFingerprint(headers) {
+        const refreshCreds = parseTikTokRefreshCredentialsFromHeaders(headers);
+        if (!refreshCreds)
+            return undefined;
+        const advertiserId = getTikTokAdvertiserIdFromHeaders(headers);
+        return getTikTokCredentialFingerprint(refreshCreds.appId, advertiserId);
+    }
+    getTokenFingerprint(headers) {
+        const token = parseTikTokTokenFromHeaders(headers);
+        const advertiserId = getTikTokAdvertiserIdFromHeaders(headers);
+        return getTikTokCredentialFingerprint(token, advertiserId);
+    }
+}
+//# sourceMappingURL=tiktok-auth-strategy.js.map

package/dist/auth/tiktok-auth-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktok-auth-strategy.js","sourceRoot":"","sources":["../../src/auth/tiktok-auth-strategy.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,sBAAsB,EAA4B,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,wCAAwC,EACxC,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAElC,MAAM,OAAO,wBAAyB,SAAQ,sBAAsB;IAK/C;IAEA;IANA,QAAQ,GAAG,eAAe,CAAC;IAC3B,YAAY,GAAG,QAAQ,CAAC;IAE3C,YACmB,OAAe,EAChC,MAAe,EACE,aAAqB,MAAM;QAE5C,KAAK,CAAC,MAAM,CAAC,CAAC;QAJG,YAAO,GAAP,OAAO,CAAQ;QAEf,eAAU,GAAV,UAAU,CAAiB;IAG9C,CAAC;IAES,KAAK,CAAC,oBAAoB,CAClC,OAAsD;QAEtD,MAAM,YAAY,GAAG,wCAAwC,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,YAAY,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAC3C,YAAY,EACZ,YAAY,EACZ,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YAEP,WAAW,EAAE,8BAA8B,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC;YAC7E,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,eAAe;YACzB,UAAU,EAAE,EAAE,YAAY,EAAE;SAC7B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,mBAAmB,CACjC,OAAsD;QAEtD,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAC1C,KAAK,EACL,YAAY,EACZ,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,UAAU,CAChB,CAAC;QACF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEzB,OAAO;YACL,OAAO;YACP,WAAW,EAAE,8BAA8B,CAAC,KAAK,EAAE,YAAY,CAAC;YAChE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,cAAc;YACxB,UAAU,EAAE,EAAE,YAAY,EAAE;SAC7B,CAAC;IACJ,CAAC;IAES,qBAAqB,CAC7B,OAAsD;QAEtD,MAAM,YAAY,GAAG,wCAAwC,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,YAAY;YAAE,OAAO,SAAS,CAAC;QACpC,MAAM,YAAY,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,8BAA8B,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC1E,CAAC;IAES,mBAAmB,CAAC,OAAsD;QAClF,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,8BAA8B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/config/index.d.ts

@@ -0,0 +1,120 @@
+import { z } from "zod";
+declare const ConfigSchema: z.ZodObject<{
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<["development", "production", "test"]>>;
+    mcpStatefulSessionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    mcpAuthSecretKey: z.ZodOptional<z.ZodString>;
+    mcpAllowedOrigins: z.ZodOptional<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    mcpLogLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "notice", "warning", "error"]>>;
+    otelEnabled: z.ZodDefault<z.ZodBoolean>;
+    otelExporterOtlpTracesEndpoint: z.ZodOptional<z.ZodString>;
+    otelExporterOtlpMetricsEndpoint: z.ZodOptional<z.ZodString>;
+    gcsBucketName: z.ZodOptional<z.ZodString>;
+} & {
+    serviceName: z.ZodDefault<z.ZodString>;
+    port: z.ZodDefault<z.ZodNumber>;
+    otelServiceName: z.ZodDefault<z.ZodString>;
+    mcpAuthMode: z.ZodDefault<z.ZodEnum<["tiktok-bearer", "jwt", "none"]>>;
+    tiktokApiBaseUrl: z.ZodDefault<z.ZodString>;
+    tiktokApiVersion: z.ZodDefault<z.ZodString>;
+    tiktokRateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    tiktokAccessToken: z.ZodOptional<z.ZodString>;
+    tiktokAdvertiserId: z.ZodOptional<z.ZodString>;
+    tiktokAppId: z.ZodOptional<z.ZodString>;
+    tiktokAppSecret: z.ZodOptional<z.ZodString>;
+    tiktokRefreshToken: z.ZodOptional<z.ZodString>;
+    tiktokReportPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    tiktokReportMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+    tiktokVideoUploadPollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    tiktokVideoUploadMaxPollAttempts: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "tiktok-bearer" | "jwt" | "none";
+    tiktokApiBaseUrl: string;
+    tiktokApiVersion: string;
+    tiktokRateLimitPerMinute: number;
+    tiktokReportPollIntervalMs: number;
+    tiktokReportMaxPollAttempts: number;
+    tiktokVideoUploadPollIntervalMs: number;
+    tiktokVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    tiktokAccessToken?: string | undefined;
+    tiktokAdvertiserId?: string | undefined;
+    tiktokAppId?: string | undefined;
+    tiktokAppSecret?: string | undefined;
+    tiktokRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}, {
+    serviceName?: string | undefined;
+    port?: number | undefined;
+    otelServiceName?: string | undefined;
+    mcpAuthMode?: "tiktok-bearer" | "jwt" | "none" | undefined;
+    tiktokApiBaseUrl?: string | undefined;
+    tiktokApiVersion?: string | undefined;
+    tiktokRateLimitPerMinute?: number | undefined;
+    tiktokAccessToken?: string | undefined;
+    tiktokAdvertiserId?: string | undefined;
+    tiktokAppId?: string | undefined;
+    tiktokAppSecret?: string | undefined;
+    tiktokRefreshToken?: string | undefined;
+    tiktokReportPollIntervalMs?: number | undefined;
+    tiktokReportMaxPollAttempts?: number | undefined;
+    tiktokVideoUploadPollIntervalMs?: number | undefined;
+    tiktokVideoUploadMaxPollAttempts?: number | undefined;
+    host?: string | undefined;
+    nodeEnv?: "development" | "production" | "test" | undefined;
+    mcpStatefulSessionTimeoutMs?: number | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    logLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    mcpLogLevel?: "debug" | "info" | "notice" | "warning" | "error" | undefined;
+    otelEnabled?: boolean | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+}>;
+export type AppConfig = z.infer<typeof ConfigSchema>;
+export declare function parseConfig(): AppConfig;
+export declare const mcpConfig: {
+    serviceName: string;
+    port: number;
+    otelServiceName: string;
+    mcpAuthMode: "tiktok-bearer" | "jwt" | "none";
+    tiktokApiBaseUrl: string;
+    tiktokApiVersion: string;
+    tiktokRateLimitPerMinute: number;
+    tiktokReportPollIntervalMs: number;
+    tiktokReportMaxPollAttempts: number;
+    tiktokVideoUploadPollIntervalMs: number;
+    tiktokVideoUploadMaxPollAttempts: number;
+    host: string;
+    nodeEnv: "development" | "production" | "test";
+    mcpStatefulSessionTimeoutMs: number;
+    logLevel: "debug" | "info" | "notice" | "warning" | "error";
+    mcpLogLevel: "debug" | "info" | "notice" | "warning" | "error";
+    otelEnabled: boolean;
+    tiktokAccessToken?: string | undefined;
+    tiktokAdvertiserId?: string | undefined;
+    tiktokAppId?: string | undefined;
+    tiktokAppSecret?: string | undefined;
+    tiktokRefreshToken?: string | undefined;
+    mcpAuthSecretKey?: string | undefined;
+    mcpAllowedOrigins?: string | undefined;
+    otelExporterOtlpTracesEndpoint?: string | undefined;
+    otelExporterOtlpMetricsEndpoint?: string | undefined;
+    gcsBucketName?: string | undefined;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiChB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAErD,wBAAgB,WAAW,IAAI,SAAS,CA6CvC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { loadDotEnv, BaseConfigSchema, getBaseEnvConfig, parseConfigWithSchema, getDefaultHost, } from "@cesteral/shared";
+loadDotEnv();
+const ConfigSchema = BaseConfigSchema.extend({
+    serviceName: z.string().default("tiktok-mcp"),
+    port: z.number().int().min(1).max(65535).default(3007),
+    otelServiceName: z.string().default("tiktok-mcp"),
+    mcpAuthMode: z.enum(["tiktok-bearer", "jwt", "none"]).default("tiktok-bearer"),
+    tiktokApiBaseUrl: z.string().url().default("https://business-api.tiktok.com"),
+    tiktokApiVersion: z.string().default("v1.3"),
+    tiktokRateLimitPerMinute: z.number().default(10),
+    tiktokAccessToken: z.string().optional(),
+    tiktokAdvertiserId: z.string().optional(),
+    tiktokAppId: z.string().optional(),
+    tiktokAppSecret: z.string().optional(),
+    tiktokRefreshToken: z.string().optional(),
+    tiktokReportPollIntervalMs: z.number().default(2_000),
+    tiktokReportMaxPollAttempts: z.number().default(30),
+    tiktokVideoUploadPollIntervalMs: z.number().default(20_000),
+    tiktokVideoUploadMaxPollAttempts: z.number().default(30),
+});
+export function parseConfig() {
+    const defaultHost = getDefaultHost();
+    const rawConfig = {
+        ...getBaseEnvConfig(defaultHost),
+        serviceName: process.env.SERVICE_NAME,
+        ...(process.env.TIKTOK_MCP_PORT ? { port: Number(process.env.TIKTOK_MCP_PORT) } : {}),
+        host: process.env.TIKTOK_MCP_HOST || defaultHost,
+        tiktokApiBaseUrl: process.env.TIKTOK_API_BASE_URL,
+        tiktokApiVersion: process.env.TIKTOK_API_VERSION,
+        tiktokRateLimitPerMinute: process.env.TIKTOK_RATE_LIMIT_PER_MINUTE
+            ? Number(process.env.TIKTOK_RATE_LIMIT_PER_MINUTE)
+            : undefined,
+        tiktokAccessToken: process.env.TIKTOK_ACCESS_TOKEN,
+        tiktokAdvertiserId: process.env.TIKTOK_ADVERTISER_ID,
+        tiktokAppId: process.env.TIKTOK_APP_ID,
+        tiktokAppSecret: process.env.TIKTOK_APP_SECRET,
+        tiktokRefreshToken: process.env.TIKTOK_REFRESH_TOKEN,
+        tiktokReportPollIntervalMs: process.env.TIKTOK_REPORT_POLL_INTERVAL_MS
+            ? Number(process.env.TIKTOK_REPORT_POLL_INTERVAL_MS)
+            : undefined,
+        tiktokReportMaxPollAttempts: process.env.TIKTOK_REPORT_MAX_POLL_ATTEMPTS
+            ? Number(process.env.TIKTOK_REPORT_MAX_POLL_ATTEMPTS)
+            : undefined,
+        tiktokVideoUploadPollIntervalMs: process.env.TIKTOK_VIDEO_UPLOAD_POLL_INTERVAL_MS
+            ? Number(process.env.TIKTOK_VIDEO_UPLOAD_POLL_INTERVAL_MS)
+            : undefined,
+        tiktokVideoUploadMaxPollAttempts: process.env.TIKTOK_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS
+            ? Number(process.env.TIKTOK_VIDEO_UPLOAD_MAX_POLL_ATTEMPTS)
+            : undefined,
+    };
+    return parseConfigWithSchema(ConfigSchema, rawConfig);
+}
+export const mcpConfig = parseConfig();
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { mcpConfig } from "./config/index.js";
+import { createMcpServer, runStdioServer } from "./mcp-server/server.js";
+import { startHttpServer } from "./mcp-server/transports/streamable-http-transport.js";
+import { initializeOpenTelemetry, otelLogMixin } from "@cesteral/shared";
+import { TikTokAccessTokenAdapter } from "./auth/tiktok-auth-adapter.js";
+import { detectTransportMode, createServerLogger, bootstrapMcpServer } from "@cesteral/shared";
+import { createSessionServices, sessionServiceStore } from "./services/session-services.js";
+import { rateLimiter } from "./utils/platform.js";
+const transportMode = detectTransportMode();
+const logger = createServerLogger("tiktok-mcp", transportMode, otelLogMixin());
+async function setupStdioCredentials(sessionId) {
+    const accessToken = mcpConfig.tiktokAccessToken;
+    const advertiserId = mcpConfig.tiktokAdvertiserId;
+    if (!accessToken || !advertiserId) {
+        logger.warn("No TikTok credentials found in env vars. " +
+            "Set TIKTOK_ACCESS_TOKEN and TIKTOK_ADVERTISER_ID for stdio mode.");
+        return false;
+    }
+    const authAdapter = new TikTokAccessTokenAdapter(accessToken, advertiserId, mcpConfig.tiktokApiBaseUrl, mcpConfig.tiktokApiVersion);
+    await authAdapter.validate();
+    const services = createSessionServices(authAdapter, {
+        baseUrl: mcpConfig.tiktokApiBaseUrl,
+        reportPollIntervalMs: mcpConfig.tiktokReportPollIntervalMs,
+        reportMaxPollAttempts: mcpConfig.tiktokReportMaxPollAttempts,
+        apiVersion: mcpConfig.tiktokApiVersion,
+    }, logger, rateLimiter);
+    sessionServiceStore.set(sessionId, services);
+    logger.info("Stdio session services created successfully");
+    return true;
+}
+bootstrapMcpServer({
+    serviceName: "tiktok-mcp",
+    config: mcpConfig,
+    logger,
+    transportMode,
+    initOtel: initializeOpenTelemetry,
+    setupStdioSession: setupStdioCredentials,
+    createMcpServer,
+    runStdio: runStdioServer,
+    startHttp: startHttpServer,
+    onShutdown: () => rateLimiter.destroy(),
+}).catch((err) => {
+    logger.fatal({ err }, "Failed to start tiktok-mcp");
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;AAC5C,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAM/E,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC,iBAAiB,CAAC;IAChD,MAAM,YAAY,GAAG,SAAS,CAAC,kBAAkB,CAAC;IAElD,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CACT,2CAA2C;YACzC,kEAAkE,CACrE,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,wBAAwB,CAC9C,WAAW,EACX,YAAY,EACZ,SAAS,CAAC,gBAAgB,EAC1B,SAAS,CAAC,gBAAgB,CAC3B,CAAC;IAGF,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CACpC,WAAW,EACX;QACE,OAAO,EAAE,SAAS,CAAC,gBAAgB;QACnC,oBAAoB,EAAE,SAAS,CAAC,0BAA0B;QAC1D,qBAAqB,EAAE,SAAS,CAAC,2BAA2B;QAC5D,UAAU,EAAE,SAAS,CAAC,gBAAgB;KACvC,EACD,MAAM,EACN,WAAW,CACZ,CAAC;IAEF,mBAAmB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kBAAkB,CAAC;IACjB,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,SAAS;IACjB,MAAM;IACN,aAAa;IACb,QAAQ,EAAE,uBAAuB;IACjC,iBAAiB,EAAE,qBAAqB;IACxC,eAAe;IACf,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE;CACxC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACf,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,4BAA4B,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const bulkOperationsWorkflowPrompt: Prompt;
+export declare function getBulkOperationsWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=bulk-operations-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,4BAA4B,EAAE,MAgB1C,CAAC;AAEF,wBAAgB,gCAAgC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8GtF"}

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js

@@ -0,0 +1,127 @@
+export const bulkOperationsWorkflowPrompt = {
+    name: "tiktok_bulk_operations_workflow",
+    description: "Guide for performing bulk create, update, and status operations on TikTok Ads entities",
+    arguments: [
+        {
+            name: "advertiserId",
+            description: "TikTok Advertiser ID",
+            required: true,
+        },
+        {
+            name: "entityType",
+            description: "Entity type to operate on (campaign, adGroup, ad)",
+            required: false,
+        },
+    ],
+};
+export function getBulkOperationsWorkflowMessage(args) {
+    const advertiserId = args?.advertiserId || "{advertiserId}";
+    const entityType = args?.entityType || "campaign";
+    return `# TikTok Bulk Operations Workflow
+
+## Advertiser ID: \`${advertiserId}\`
+## Entity Type: \`${entityType}\`
+
+---
+
+## Option 1: Bulk Status Update (most common)
+
+Pause, enable, or delete multiple entities in one call:
+
+\`\`\`json
+tiktok_bulk_update_status({
+  "entityType": "${entityType}",
+  "advertiserId": "${advertiserId}",
+  "entityIds": ["ID_1", "ID_2", "ID_3"],
+  "operationStatus": "DISABLE"
+})
+\`\`\`
+
+**Operation status values:**
+- \`ENABLE\` — Activate entities
+- \`DISABLE\` — Pause entities
+- \`DELETE\` — Permanently delete (irreversible!)
+
+---
+
+## Option 2: Bulk Create Entities (up to 50)
+
+Create multiple entities of the same type in one call:
+
+\`\`\`json
+tiktok_bulk_create_entities({
+  "entityType": "${entityType}",
+  "advertiserId": "${advertiserId}",
+  "items": [
+    {
+      "campaign_name": "Campaign A",
+      "objective_type": "TRAFFIC",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 100
+    },
+    {
+      "campaign_name": "Campaign B",
+      "objective_type": "CONVERSIONS",
+      "budget_mode": "BUDGET_MODE_DAY",
+      "budget": 200
+    }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 3: Bulk Update Entities (up to 50)
+
+Update specific fields on multiple entities:
+
+\`\`\`json
+tiktok_bulk_update_entities({
+  "entityType": "${entityType}",
+  "advertiserId": "${advertiserId}",
+  "items": [
+    { "entityId": "ID_1", "data": { "budget": 150 } },
+    { "entityId": "ID_2", "data": { "budget": 250 } }
+  ]
+})
+\`\`\`
+
+---
+
+## Option 4: Bulk Bid Adjustment (ad groups only)
+
+Safe read-modify-write bid adjustment:
+
+\`\`\`json
+tiktok_adjust_bids({
+  "advertiserId": "${advertiserId}",
+  "adjustments": [
+    { "adGroupId": "ADGROUP_ID_1", "bidPrice": 1.5 },
+    { "adGroupId": "ADGROUP_ID_2", "bidPrice": 2.0 }
+  ],
+  "reason": "Increase bids to improve delivery"
+})
+\`\`\`
+
+---
+
+## Tips for Bulk Operations
+
+1. **List first**: Use \`tiktok_list_entities\` to get entity IDs before bulk operations
+2. **Validate first**: Use \`tiktok_validate_entity\` to check payloads before bulk create
+3. **Status update is batched**: TikTok accepts IDs array in one API call
+4. **Create/Update is sequential**: Processed concurrently (5 at a time) by the MCP tool
+5. **Max 50 items**: Per bulk create/update call (more = multiple calls)
+6. **Error handling**: Partial failures are reported — some may succeed while others fail
+
+## Workflow: Pause all campaigns → Adjust → Re-enable
+
+\`\`\`
+1. tiktok_list_entities (get campaign IDs)
+2. tiktok_bulk_update_status (DISABLE all)
+3. tiktok_bulk_update_entities (adjust budgets/settings)
+4. tiktok_bulk_update_status (ENABLE selected)
+\`\`\`
+`;
+}
+//# sourceMappingURL=bulk-operations-workflow.prompt.js.map

package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-operations-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,4BAA4B,GAAW;IAClD,IAAI,EAAE,iCAAiC;IACvC,WAAW,EACT,wFAAwF;IAC1F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAAC,IAA6B;IAC5E,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,UAAU,CAAC;IAElD,OAAO;;sBAEa,YAAY;oBACd,UAAU;;;;;;;;;;mBAUX,UAAU;qBACR,YAAY;;;;;;;;;;;;;;;;;;;mBAmBd,UAAU;qBACR,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0Bd,UAAU;qBACR,YAAY;;;;;;;;;;;;;;;;qBAgBZ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BhC,CAAC;AACF,CAAC"}

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts

@@ -0,0 +1,4 @@
+import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
+export declare const campaignSetupWorkflowPrompt: Prompt;
+export declare function getCampaignSetupWorkflowMessage(args?: Record<string, string>): string;
+//# sourceMappingURL=campaign-setup-workflow.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-setup-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,2BAA2B,EAAE,MAgBzC,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuFrF"}