@praise25/meta-mcp-server 0.1.7 → 0.1.8

package/dist/constants.d.ts

@@ -4,7 +4,7 @@ export declare const CHARACTER_LIMIT = 25000;
 export declare const DEFAULT_PAGE_LIMIT = 25;
 export declare const MAX_PAGE_LIMIT = 500;
 export declare const SERVER_NAME = "meta-business-manager-mcp-server";
-export declare const SERVER_VERSION = "0.1.7";
+export declare const SERVER_VERSION = "0.1.8";
 export declare const META_ERROR_CODES: {
     readonly UNKNOWN: 1;
     readonly SERVICE_TEMPORARILY_UNAVAILABLE: 2;

package/dist/constants.js

@@ -4,7 +4,7 @@ export const CHARACTER_LIMIT = 25_000;
 export const DEFAULT_PAGE_LIMIT = 25;
 export const MAX_PAGE_LIMIT = 500;
 export const SERVER_NAME = "meta-business-manager-mcp-server";
-export const SERVER_VERSION = "0.1.7";
+export const SERVER_VERSION = "0.1.8";
 export const META_ERROR_CODES = {
     UNKNOWN: 1,
     SERVICE_TEMPORARILY_UNAVAILABLE: 2,

package/dist/tools/overview/business-overview.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { ToolContext } from "../../context.js";
 export declare const inputSchema: z.ZodObject<{
-    business_id: z.ZodString;
+    business_id: z.ZodOptional<z.ZodString>;
     date_preset: z.ZodDefault<z.ZodEnum<["today", "yesterday", "this_month", "last_month", "this_quarter", "maximum", "last_3d", "last_7d", "last_14d", "last_28d", "last_30d", "last_90d", "last_week_mon_sun", "last_week_sun_sat", "last_quarter", "last_year", "this_week_mon_today", "this_week_sun_today", "this_year"]>>;
     include_pixels: z.ZodDefault<z.ZodBoolean>;
     include_catalogs: z.ZodDefault<z.ZodBoolean>;
@@ -9,15 +9,15 @@ export declare const inputSchema: z.ZodObject<{
     max_ad_accounts: z.ZodDefault<z.ZodNumber>;
     max_pages: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
-    business_id: string;
     date_preset: "today" | "yesterday" | "this_month" | "last_month" | "this_quarter" | "maximum" | "last_3d" | "last_7d" | "last_14d" | "last_28d" | "last_30d" | "last_90d" | "last_week_mon_sun" | "last_week_sun_sat" | "last_quarter" | "last_year" | "this_week_mon_today" | "this_week_sun_today" | "this_year";
     include_pixels: boolean;
     include_catalogs: boolean;
     include_whatsapp: boolean;
     max_ad_accounts: number;
     max_pages: number;
+    business_id?: string | undefined;
 }, {
-    business_id: string;
+    business_id?: string | undefined;
     date_preset?: "today" | "yesterday" | "this_month" | "last_month" | "this_quarter" | "maximum" | "last_3d" | "last_7d" | "last_14d" | "last_28d" | "last_30d" | "last_90d" | "last_week_mon_sun" | "last_week_sun_sat" | "last_quarter" | "last_year" | "this_week_mon_today" | "this_week_sun_today" | "this_year" | undefined;
     include_pixels?: boolean | undefined;
     include_catalogs?: boolean | undefined;
@@ -31,7 +31,7 @@ export declare const definition: {
     readonly title: "Eagle's-eye snapshot of a business";
     readonly description: "One-call consolidated read across the whole Meta surface for a business:\n\n- Identity (system user + token app)\n- Assigned Pages + each Page's high-level insights (impressions, engagement, fans) for the requested window\n- Instagram Business accounts linked to those Pages (followers, media_count)\n- Owned + client ad accounts with balance, spend cap, amount spent, and last-window insights (spend, impressions, clicks, CTR, CPC, reach)\n- Pixels with last_fired_time (if include_pixels)\n- Catalogs with product counts (if include_catalogs)\n- WhatsApp Business Accounts + phone numbers (if include_whatsapp)\n\nEach section has its own error isolation — one failing asset does not kill the report. Ideal as the opening call for any AI-driven marketing insights conversation.";
     readonly inputSchema: {
-        business_id: z.ZodString;
+        business_id: z.ZodOptional<z.ZodString>;
         date_preset: z.ZodDefault<z.ZodEnum<["today", "yesterday", "this_month", "last_month", "this_quarter", "maximum", "last_3d", "last_7d", "last_14d", "last_28d", "last_30d", "last_90d", "last_week_mon_sun", "last_week_sun_sat", "last_quarter", "last_year", "this_week_mon_today", "this_week_sun_today", "this_year"]>>;
         include_pixels: z.ZodDefault<z.ZodBoolean>;
         include_catalogs: z.ZodDefault<z.ZodBoolean>;

package/dist/tools/overview/business-overview.js

@@ -5,7 +5,9 @@ import { jsonBlock, toolResult } from "../../helpers/format.js";
 import { datePresetSchema, metaIdSchema } from "../../helpers/schema.js";
 export const inputSchema = z
     .object({
-    business_id: metaIdSchema.describe("Business Manager ID."),
+    business_id: metaIdSchema
+        .optional()
+        .describe("Business Manager ID. **Optional** — if omitted, the server auto-discovers via `META_ALLOWED_BUSINESS_IDS[0]` (if configured) or the first business returned by `/me/businesses`. Always prefer omitting this if you don't have the exact ID — do not guess a placeholder integer."),
     date_preset: datePresetSchema
         .default("last_30d")
         .describe("Date window used for ad account and page insights snapshots."),
@@ -41,8 +43,43 @@ function fail(err) {
     return { ok: false, error: e.message, hint: e.hint };
 }
 export async function handler(input, ctx) {
-    assertAllowed("business", input.business_id, ctx.config);
     const started = Date.now();
+    // Auto-discover business_id if not provided. Prefer the configured allowlist
+    // (deployment intent), fall back to /me/businesses. This makes the tool
+    // safe to call with no args — defeats AI-hallucinated-id failure modes.
+    let businessId = input.business_id;
+    let businessIdSource = "input";
+    if (!businessId) {
+        const allowed = ctx.config.allowedBusinessIds;
+        if (allowed && allowed.size > 0) {
+            businessId = allowed.values().next().value;
+            businessIdSource = "allowlist";
+        }
+        else {
+            try {
+                const list = await ctx.graph.get({
+                    path: "me/businesses",
+                    params: { fields: "id,name", limit: 1 },
+                });
+                const first = list.data?.[0];
+                if (first?.id) {
+                    businessId = first.id;
+                    businessIdSource = "discovered";
+                }
+            }
+            catch {
+                /* fall through — businessId remains undefined and structured response will surface the gap */
+            }
+        }
+    }
+    if (!businessId) {
+        return toolResult({
+            error: "no_business_id",
+            hint: "Could not determine business_id. Configure META_ALLOWED_BUSINESS_IDS in the server's environment, or pass business_id explicitly. /me/businesses returned no results for the configured token (this is normal for system-user tokens — they don't list businesses via that edge).",
+            suggestion: "Pass business_id directly. To discover it, an operator should run `meta_business_list_assets business_id=<known>` once with a known ID, or look up the business in Business Settings → Business Info.",
+        }, "{}");
+    }
+    assertAllowed("business", businessId, ctx.config);
     const token = ctx.graph.get({
         path: "debug_token",
         params: { input_token: ctx.config.accessToken },
@@ -60,14 +97,14 @@ export async function handler(input, ctx) {
         .catch(fail);
     const ownedAds = ctx.graph
         .get({
-        path: `${input.business_id}/owned_ad_accounts`,
+        path: `${businessId}/owned_ad_accounts`,
         params: { fields: "id,account_id,name,currency,account_status,amount_spent,balance,spend_cap", limit: input.max_ad_accounts },
     })
         .then(ok)
         .catch(fail);
     const clientAds = ctx.graph
         .get({
-        path: `${input.business_id}/client_ad_accounts`,
+        path: `${businessId}/client_ad_accounts`,
         params: { fields: "id,account_id,name,currency,account_status", limit: input.max_ad_accounts },
     })
         .then(ok)
@@ -75,7 +112,7 @@ export async function handler(input, ctx) {
     const pixels = input.include_pixels
         ? ctx.graph
             .get({
-            path: `${input.business_id}/owned_pixels`,
+            path: `${businessId}/owned_pixels`,
             params: { fields: "id,name,last_fired_time,is_unavailable", limit: 25 },
         })
             .then(ok)
@@ -84,7 +121,7 @@ export async function handler(input, ctx) {
     const catalogs = input.include_catalogs
         ? ctx.graph
             .get({
-            path: `${input.business_id}/owned_product_catalogs`,
+            path: `${businessId}/owned_product_catalogs`,
             params: { fields: "id,name,vertical,product_count", limit: 25 },
         })
             .then(ok)
@@ -93,7 +130,7 @@ export async function handler(input, ctx) {
     const wabas = input.include_whatsapp
         ? ctx.graph
             .get({
-            path: `${input.business_id}/owned_whatsapp_business_accounts`,
+            path: `${businessId}/owned_whatsapp_business_accounts`,
             params: { fields: "id,name,currency,status,business_verification_status", limit: 25 },
         })
             .then(ok)
@@ -180,7 +217,8 @@ export async function handler(input, ctx) {
         };
     }));
     const structured = {
-        business_id: input.business_id,
+        business_id: businessId,
+        business_id_source: businessIdSource,
         date_preset: input.date_preset,
         generated_at: new Date().toISOString(),
         latency_ms: Date.now() - started,

package/package.json

@@ -1,7 +1,7 @@
 {
   "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.7",
+  "version": "0.1.8",
   "author": "Stephen A.",
   "license": "MIT",
   "homepage": "https://github.com/feladeveloper/meta-mcp-server#readme",