@praise25/meta-mcp-server 0.1.0

package/dist/tools/token/inspect.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { ToolContext } from "../../context.js";
+import { ResponseFormat } from "../../helpers/format.js";
+export declare const inputSchema: z.ZodObject<{
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: ResponseFormat;
+}, {
+    response_format?: ResponseFormat | undefined;
+}>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const definition: {
+    readonly name: "meta_token_inspect";
+    readonly title: "Inspect Meta access token";
+    readonly description: "Decodes the configured META_ACCESS_TOKEN via Graph API /debug_token.\n\nReturns:\n- app_id + application name\n- token type (system-user / user / page)\n- is_valid\n- expires_at + data_access_expires_at (unix seconds; 0 = never expires)\n- scopes + granular_scopes (per-asset targeting)\n\nUse this first when troubleshooting — almost every other tool failure traces back to a missing scope or an asset not assigned to the token.\n\nNever logs the token itself.";
+    readonly inputSchema: {
+        response_format: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare function handler(input: Input, ctx: ToolContext): Promise<import("../../helpers/format.js").ToolTextResult>;

package/dist/tools/token/inspect.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { MetaError } from "../../errors.js";
+import { jsonBlock, ResponseFormat, toolError, toolResult } from "../../helpers/format.js";
+import { responseFormatShape } from "../../helpers/schema.js";
+export const inputSchema = z
+    .object({
+    ...responseFormatShape,
+})
+    .strict();
+export const definition = {
+    name: "meta_token_inspect",
+    title: "Inspect Meta access token",
+    description: `Decodes the configured META_ACCESS_TOKEN via Graph API /debug_token.
+
+Returns:
+- app_id + application name
+- token type (system-user / user / page)
+- is_valid
+- expires_at + data_access_expires_at (unix seconds; 0 = never expires)
+- scopes + granular_scopes (per-asset targeting)
+
+Use this first when troubleshooting — almost every other tool failure traces back to a missing scope or an asset not assigned to the token.
+
+Never logs the token itself.`,
+    inputSchema: inputSchema.shape,
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+};
+export async function handler(input, ctx) {
+    try {
+        const data = await ctx.graph.get({
+            path: "debug_token",
+            params: { input_token: ctx.config.accessToken },
+            noCache: true,
+        });
+        const debug = data.data ?? {};
+        const now = Math.floor(Date.now() / 1000);
+        const expiresIn = debug.expires_at && debug.expires_at > 0 ? debug.expires_at - now : null;
+        const dataAccessExpiresIn = debug.data_access_expires_at && debug.data_access_expires_at > 0
+            ? debug.data_access_expires_at - now
+            : null;
+        const structured = {
+            ...debug,
+            expires_in_seconds: expiresIn,
+            data_access_expires_in_seconds: dataAccessExpiresIn,
+            never_expires: debug.expires_at === 0,
+            app_secret_proof_enabled: Boolean(ctx.config.appSecret),
+        };
+        const text = input.response_format === ResponseFormat.MARKDOWN
+            ? renderMarkdown(structured)
+            : jsonBlock(structured);
+        return toolResult(structured, text);
+    }
+    catch (err) {
+        const e = err instanceof MetaError ? err : new MetaError(err.message);
+        return toolError(e.message, e.hint, {
+            code: e.code,
+            subcode: e.subcode,
+            fbtrace_id: e.fbtraceId,
+            http_status: e.httpStatus,
+        });
+    }
+}
+function renderMarkdown(d) {
+    const lines = ["# Meta Token Inspection", ""];
+    lines.push(`- **Valid**: ${d.is_valid ?? "unknown"}`);
+    lines.push(`- **App**: ${d.application ?? "?"} (${d.app_id ?? "?"})`);
+    if (d.type)
+        lines.push(`- **Type**: ${d.type}`);
+    if (d.user_id)
+        lines.push(`- **User / System User ID**: ${d.user_id}`);
+    lines.push(`- **Expires**: ${d.never_expires ? "never" : d.expires_in_seconds != null ? `in ${d.expires_in_seconds}s` : "unknown"}`);
+    lines.push(`- **appsecret_proof**: ${d.app_secret_proof_enabled ? "enabled" : "disabled (recommend enabling)"}`);
+    if (d.scopes?.length) {
+        lines.push("", "## Scopes", ...d.scopes.map((s) => `- ${s}`));
+    }
+    if (d.granular_scopes?.length) {
+        lines.push("", "## Granular scopes");
+        for (const g of d.granular_scopes) {
+            lines.push(`- **${g.scope}** → ${g.target_ids?.length ? g.target_ids.join(", ") : "all"}`);
+        }
+    }
+    return lines.join("\n");
+}

package/dist/tools/whatsapp/get-analytics.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import type { ToolContext } from "../../context.js";
+export declare const inputSchema: z.ZodObject<{
+    waba_id: z.ZodString;
+    flavor: z.ZodDefault<z.ZodEnum<["analytics", "conversation_analytics"]>>;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    granularity: z.ZodDefault<z.ZodEnum<["HALF_HOUR", "DAY", "MONTH"]>>;
+    phone_numbers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    conversation_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dimensions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    waba_id: string;
+    flavor: "analytics" | "conversation_analytics";
+    start: number;
+    end: number;
+    granularity: "HALF_HOUR" | "DAY" | "MONTH";
+    dimensions: string[];
+    phone_numbers?: string[] | undefined;
+    country_codes?: string[] | undefined;
+    conversation_categories?: string[] | undefined;
+}, {
+    waba_id: string;
+    start: number;
+    end: number;
+    flavor?: "analytics" | "conversation_analytics" | undefined;
+    granularity?: "HALF_HOUR" | "DAY" | "MONTH" | undefined;
+    phone_numbers?: string[] | undefined;
+    country_codes?: string[] | undefined;
+    conversation_categories?: string[] | undefined;
+    dimensions?: string[] | undefined;
+}>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const definition: {
+    readonly name: "meta_whatsapp_get_analytics";
+    readonly title: "Get WhatsApp Business analytics";
+    readonly description: "Fetches WABA analytics — either the legacy 'analytics' field (message counts) or the richer 'conversation_analytics' (per-conversation pricing, categories: AUTHENTICATION/MARKETING/SERVICE/UTILITY).\n\nPass start + end as Unix seconds. Use granularity DAY for most reports. Filter by phone_numbers, country_codes, or conversation_categories to narrow.";
+    readonly inputSchema: {
+        waba_id: z.ZodString;
+        flavor: z.ZodDefault<z.ZodEnum<["analytics", "conversation_analytics"]>>;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        granularity: z.ZodDefault<z.ZodEnum<["HALF_HOUR", "DAY", "MONTH"]>>;
+        phone_numbers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        country_codes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        conversation_categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        dimensions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare function handler(input: Input, ctx: ToolContext): Promise<import("../../helpers/format.js").ToolTextResult>;

package/dist/tools/whatsapp/get-analytics.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { metaIdSchema } from "../../helpers/schema.js";
+import { runGet } from "../shared.js";
+const GRANULARITY = z.enum(["HALF_HOUR", "DAY", "MONTH"]);
+export const inputSchema = z
+    .object({
+    waba_id: metaIdSchema,
+    flavor: z
+        .enum(["analytics", "conversation_analytics"])
+        .default("conversation_analytics")
+        .describe("'analytics' = legacy message-count metric. 'conversation_analytics' = per-conversation pricing + category metrics (preferred)."),
+    start: z.number().int().describe("Unix timestamp (seconds) — window start."),
+    end: z.number().int().describe("Unix timestamp (seconds) — window end."),
+    granularity: GRANULARITY.default("DAY"),
+    phone_numbers: z
+        .array(z.string())
+        .optional()
+        .describe("Optional filter: list of display phone numbers ('+15551234567' form)."),
+    country_codes: z.array(z.string()).optional().describe("Optional filter: ISO country codes."),
+    conversation_categories: z
+        .array(z.string())
+        .optional()
+        .describe("AUTHENTICATION, MARKETING, SERVICE, UTILITY."),
+    dimensions: z
+        .array(z.string())
+        .default(["CONVERSATION_CATEGORY", "COUNTRY", "PHONE"])
+        .describe("Breakdown dimensions."),
+})
+    .strict();
+export const definition = {
+    name: "meta_whatsapp_get_analytics",
+    title: "Get WhatsApp Business analytics",
+    description: `Fetches WABA analytics — either the legacy 'analytics' field (message counts) or the richer 'conversation_analytics' (per-conversation pricing, categories: AUTHENTICATION/MARKETING/SERVICE/UTILITY).
+
+Pass start + end as Unix seconds. Use granularity DAY for most reports. Filter by phone_numbers, country_codes, or conversation_categories to narrow.`,
+    inputSchema: inputSchema.shape,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+};
+export async function handler(input, ctx) {
+    const dims = input.dimensions.join(",");
+    let inner;
+    if (input.flavor === "conversation_analytics") {
+        const parts = [
+            `start(${input.start})`,
+            `end(${input.end})`,
+            `granularity(${input.granularity})`,
+            `dimensions([${dims}])`,
+        ];
+        if (input.phone_numbers?.length)
+            parts.push(`phone_numbers([${input.phone_numbers.join(",")}])`);
+        if (input.country_codes?.length)
+            parts.push(`country_codes([${input.country_codes.join(",")}])`);
+        if (input.conversation_categories?.length)
+            parts.push(`conversation_categories([${input.conversation_categories.join(",")}])`);
+        inner = `conversation_analytics.${parts.join(".")}`;
+    }
+    else {
+        const parts = [`start(${input.start})`, `end(${input.end})`, `granularity(${input.granularity})`];
+        if (input.phone_numbers?.length)
+            parts.push(`phone_numbers([${input.phone_numbers.join(",")}])`);
+        if (input.country_codes?.length)
+            parts.push(`country_codes([${input.country_codes.join(",")}])`);
+        inner = `analytics.${parts.join(".")}`;
+    }
+    return runGet(ctx, { path: input.waba_id, params: { fields: inner } }, { waba_id: input.waba_id, flavor: input.flavor });
+}

package/dist/tools/whatsapp/list-phone-numbers.d.ts

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import type { ToolContext } from "../../context.js";
+export declare const inputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+    auto_paginate: z.ZodDefault<z.ZodBoolean>;
+    waba_id: z.ZodString;
+    fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    fields: string[];
+    limit: number;
+    auto_paginate: boolean;
+    waba_id: string;
+    after?: string | undefined;
+}, {
+    waba_id: string;
+    fields?: string[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    auto_paginate?: boolean | undefined;
+}>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const definition: {
+    readonly name: "meta_whatsapp_list_phone_numbers";
+    readonly title: "List phone numbers under a WABA";
+    readonly description: "Lists the phone numbers attached to a WABA — display number, verified name, quality rating (GREEN/YELLOW/RED), messaging tier (throughput limits).";
+    readonly inputSchema: {
+        limit: z.ZodDefault<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+        auto_paginate: z.ZodDefault<z.ZodBoolean>;
+        waba_id: z.ZodString;
+        fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare function handler(input: Input, ctx: ToolContext): Promise<import("../../helpers/format.js").ToolTextResult>;

package/dist/tools/whatsapp/list-phone-numbers.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { metaIdSchema, paginationShape } from "../../helpers/schema.js";
+import { runList } from "../shared.js";
+export const inputSchema = z
+    .object({
+    waba_id: metaIdSchema,
+    fields: z
+        .array(z.string())
+        .default([
+        "id",
+        "display_phone_number",
+        "verified_name",
+        "code_verification_status",
+        "quality_rating",
+        "platform_type",
+        "throughput",
+        "messaging_limit_tier",
+    ])
+        .describe("Phone number fields."),
+    ...paginationShape,
+})
+    .strict();
+export const definition = {
+    name: "meta_whatsapp_list_phone_numbers",
+    title: "List phone numbers under a WABA",
+    description: `Lists the phone numbers attached to a WABA — display number, verified name, quality rating (GREEN/YELLOW/RED), messaging tier (throughput limits).`,
+    inputSchema: inputSchema.shape,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+};
+export async function handler(input, ctx) {
+    return runList(ctx, {
+        path: `${input.waba_id}/phone_numbers`,
+        params: { fields: input.fields.join(","), limit: input.limit, after: input.after },
+    }, { auto_paginate: input.auto_paginate, after: input.after, limit: input.limit }, { waba_id: input.waba_id });
+}

package/dist/tools/whatsapp/list-templates.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import type { ToolContext } from "../../context.js";
+export declare const inputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+    auto_paginate: z.ZodDefault<z.ZodBoolean>;
+    waba_id: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<["APPROVED", "PENDING", "REJECTED", "DISABLED", "IN_APPEAL", "DELETED", "PAUSED"]>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    fields: string[];
+    limit: number;
+    auto_paginate: boolean;
+    waba_id: string;
+    status?: "PAUSED" | "DELETED" | "APPROVED" | "PENDING" | "REJECTED" | "DISABLED" | "IN_APPEAL" | undefined;
+    after?: string | undefined;
+}, {
+    waba_id: string;
+    status?: "PAUSED" | "DELETED" | "APPROVED" | "PENDING" | "REJECTED" | "DISABLED" | "IN_APPEAL" | undefined;
+    fields?: string[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    auto_paginate?: boolean | undefined;
+}>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const definition: {
+    readonly name: "meta_whatsapp_list_templates";
+    readonly title: "List WhatsApp message templates";
+    readonly description: "Lists approved/pending/rejected message templates for a WABA. Read-only — does not send messages. Useful for spotting rejected templates and pre-flight checks.";
+    readonly inputSchema: {
+        limit: z.ZodDefault<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+        auto_paginate: z.ZodDefault<z.ZodBoolean>;
+        waba_id: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<["APPROVED", "PENDING", "REJECTED", "DISABLED", "IN_APPEAL", "DELETED", "PAUSED"]>>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare function handler(input: Input, ctx: ToolContext): Promise<import("../../helpers/format.js").ToolTextResult>;

package/dist/tools/whatsapp/list-templates.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { metaIdSchema, paginationShape } from "../../helpers/schema.js";
+import { runList } from "../shared.js";
+export const inputSchema = z
+    .object({
+    waba_id: metaIdSchema,
+    status: z
+        .enum(["APPROVED", "PENDING", "REJECTED", "DISABLED", "IN_APPEAL", "DELETED", "PAUSED"])
+        .optional()
+        .describe("Filter by template status."),
+    fields: z
+        .array(z.string())
+        .default([
+        "id",
+        "name",
+        "status",
+        "category",
+        "language",
+        "components",
+        "quality_score",
+        "rejected_reason",
+    ])
+        .describe("Template fields."),
+    ...paginationShape,
+})
+    .strict();
+export const definition = {
+    name: "meta_whatsapp_list_templates",
+    title: "List WhatsApp message templates",
+    description: `Lists approved/pending/rejected message templates for a WABA. Read-only — does not send messages. Useful for spotting rejected templates and pre-flight checks.`,
+    inputSchema: inputSchema.shape,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+};
+export async function handler(input, ctx) {
+    return runList(ctx, {
+        path: `${input.waba_id}/message_templates`,
+        params: {
+            fields: input.fields.join(","),
+            limit: input.limit,
+            after: input.after,
+            status: input.status,
+        },
+    }, { auto_paginate: input.auto_paginate, after: input.after, limit: input.limit }, { waba_id: input.waba_id });
+}

package/dist/tools/whatsapp/list-wabas.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import type { ToolContext } from "../../context.js";
+export declare const inputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+    auto_paginate: z.ZodDefault<z.ZodBoolean>;
+    business_id: z.ZodString;
+    scope: z.ZodDefault<z.ZodEnum<["owned", "client", "both"]>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    fields: string[];
+    limit: number;
+    auto_paginate: boolean;
+    business_id: string;
+    scope: "owned" | "client" | "both";
+    after?: string | undefined;
+}, {
+    business_id: string;
+    fields?: string[] | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    auto_paginate?: boolean | undefined;
+    scope?: "owned" | "client" | "both" | undefined;
+}>;
+export type Input = z.infer<typeof inputSchema>;
+export declare const definition: {
+    readonly name: "meta_whatsapp_list_wabas";
+    readonly title: "List WhatsApp Business Accounts under a business";
+    readonly description: "Lists WhatsApp Business Accounts (WABAs). Needs WhatsApp Business Platform product on the app and 'whatsapp_business_management' token scope.";
+    readonly inputSchema: {
+        limit: z.ZodDefault<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodString>;
+        auto_paginate: z.ZodDefault<z.ZodBoolean>;
+        business_id: z.ZodString;
+        scope: z.ZodDefault<z.ZodEnum<["owned", "client", "both"]>>;
+        fields: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+};
+export declare function handler(input: Input, ctx: ToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        business_id: string;
+        sections: Record<string, unknown>[];
+    };
+}>;

package/dist/tools/whatsapp/list-wabas.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { assertAllowed } from "../../config.js";
+import { metaIdSchema, paginationShape } from "../../helpers/schema.js";
+import { runList } from "../shared.js";
+export const inputSchema = z
+    .object({
+    business_id: metaIdSchema,
+    scope: z.enum(["owned", "client", "both"]).default("both"),
+    fields: z
+        .array(z.string())
+        .default([
+        "id",
+        "name",
+        "currency",
+        "timezone_id",
+        "business_verification_status",
+        "message_template_namespace",
+        "status",
+    ])
+        .describe("WABA fields."),
+    ...paginationShape,
+})
+    .strict();
+export const definition = {
+    name: "meta_whatsapp_list_wabas",
+    title: "List WhatsApp Business Accounts under a business",
+    description: `Lists WhatsApp Business Accounts (WABAs). Needs WhatsApp Business Platform product on the app and 'whatsapp_business_management' token scope.`,
+    inputSchema: inputSchema.shape,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+};
+export async function handler(input, ctx) {
+    assertAllowed("business", input.business_id, ctx.config);
+    const edges = input.scope === "both"
+        ? ["owned_whatsapp_business_accounts", "client_whatsapp_business_accounts"]
+        : [`${input.scope}_whatsapp_business_accounts`];
+    const sections = [];
+    for (const edge of edges) {
+        const r = await runList(ctx, {
+            path: `${input.business_id}/${edge}`,
+            params: { fields: input.fields.join(","), limit: input.limit, after: input.after },
+        }, { auto_paginate: input.auto_paginate, after: input.after, limit: input.limit }, { edge });
+        sections.push(r.structuredContent ?? { edge, error: "no data" });
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ business_id: input.business_id, sections }, null, 2) }],
+        structuredContent: { business_id: input.business_id, sections },
+    };
+}

package/dist/types/meta.d.ts

@@ -0,0 +1,46 @@
+/** Shape of a Business owned/client asset edge. */
+export interface BusinessAsset {
+    id: string;
+    name?: string;
+    category?: string;
+    /** Only present for ad accounts. */
+    account_id?: string;
+    currency?: string;
+    timezone_name?: string;
+    username?: string;
+}
+export interface Business {
+    id: string;
+    name: string;
+    verification_status?: string;
+    primary_page?: {
+        id: string;
+        name?: string;
+    };
+    created_time?: string;
+    updated_time?: string;
+    timezone_id?: number;
+}
+export interface SystemUser {
+    id: string;
+    name: string;
+    role?: string;
+    finance_role?: string;
+    ip_role?: string;
+}
+export interface TokenDebug {
+    app_id?: string;
+    type?: string;
+    application?: string;
+    data_access_expires_at?: number;
+    expires_at?: number;
+    is_valid?: boolean;
+    issued_at?: number;
+    scopes?: string[];
+    granular_scopes?: {
+        scope: string;
+        target_ids?: string[];
+    }[];
+    user_id?: string;
+    profile_id?: string;
+}

package/dist/types/meta.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@praise25/meta-mcp-server",
+  "description": "Read-only Model Context Protocol server for Meta Business Manager — Pages, Instagram, Ads insights, Pixels, Catalog, WhatsApp.",
+  "version": "0.1.0",
+  "author": "Stephen A.",
+  "license": "MIT",
+  "homepage": "https://github.com/feladeveloper/meta-mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/feladeveloper/meta-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/feladeveloper/meta-mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "meta",
+    "facebook",
+    "instagram",
+    "marketing-api",
+    "ads",
+    "ads-insights",
+    "pixels",
+    "catalog",
+    "whatsapp",
+    "business-manager",
+    "read-only",
+    "ai-tools",
+    "claude"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "meta-business-manager-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.10.0"
+  },
+  "scripts": {
+    "build:clean": "rm -rf dist",
+    "build:compile": "tsc --project tsconfig.build.json",
+    "build:chmod": "chmod +x dist/index.js || true",
+    "build": "npm run build:clean && npm run build:compile && npm run build:chmod",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "inspect": "npm run build && npx @modelcontextprotocol/inspector dist/index.js",
+    "check:types": "tsc --noEmit --project tsconfig.json",
+    "test:readonly": "npm run build && node tests/read-only-guard.mjs",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm run check:types && npm run test:readonly"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "axios": "^1.7.7",
+    "lru-cache": "^11.1.0",
+    "pino": "^9.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.0.0",
+    "jest": "^30.0.0",
+    "ts-jest": "^29.2.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}