@mambalabsdev/mcp-pinterest-brand-presence-mapper 1.1.0 → 1.2.0

package/README.md

@@ -51,6 +51,7 @@ Tool: `map_pinterest_brand_presence`
 | `handle` | string | Optional. The Pinterest username from pinterest.com/<handle>. Supplying it skips discovery and, more importantly, skips the identity risk: Pinterest handles are rarely the domain stem. |
 | `includeFollowerCounts` | boolean | Default true: the profile page is fetched and the follower counts are extracted. Set false to resolve the profile URL only, which is cheaper and needs no proxy. |
 | `skipCache` | boolean | Default false: a successful lookup is cached for seven days and reused. Set true to force a fresh fetch. |
+| `max_charge_usd` | number | Optional spending cap for this call, in USD. The actor stops before any charge that would take the run past this amount and keeps every row already charged. |
 
 ## Reading the output
 
@@ -70,6 +71,19 @@ first. The vocabulary is the same across the whole Mamba Labs social family:
 answer is no. `null` means we could not look. If you filter for companies with no
 presence, filter on `false`, because `null` rows are unknown rather than absent.
 
+## Pricing
+
+You pay per event on Apify, billed to your own Apify account. Prices from the live pricing record, read 2026-10-16:
+
+| Event | Price per event (USD) | Fires when |
+| --- | --- | --- |
+| `apify-actor-start` | $0.00005 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
+| `company-checked` | $0.0035 on the Free plan, down to $0.00245 on higher Apify plans | Once per company for which the discovery cascade completed and a non degraded row was produced, whether or not a Pinterest profile was found. Does not fire on a degraded row, because on a degraded row no discovery was performed. |
+| `profile-resolved` | $0.003 on the Free plan, down to $0.0021 on higher Apify plans | Once per company whose candidate Pinterest URL passed the identity gate. Fires on the validation work, not on a populated count. A candidate dropped as an impersonator does not charge: the work was done and the honest answer is that there is no such profile. |
+| `follower-count-extracted` | $0.0025 on the Free plan, down to $0.00175 on higher Apify plans | Once per company where a numeric follower count was read off the public page. Does not fire on not_extractable, blocked, identity_mismatch or url only runs. |
+
+The [actor's Apify page](https://apify.com/mambalabs/pinterest-brand-presence-mapper) carries the current prices. Running this server consumes Apify credits.
+
 ## Full actor documentation
 
 [apify.com/mambalabs/pinterest-brand-presence-mapper](https://apify.com/mambalabs/pinterest-brand-presence-mapper)

package/build/index.js

@@ -5,6 +5,13 @@ import { dirname, join } from "node:path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+// Optional per call spending cap, passed through to the actor's own max_charge_usd
+// input. The actor enforces it; this wrapper only forwards it when set.
+const MAX_CHARGE_USD = z
+    .number()
+    .min(0)
+    .optional()
+    .describe("Optional spending cap for this call, in USD, passed to the actor as max_charge_usd. The run stops before any charge that would take it past this amount and keeps every row already charged. Leave empty to rely only on the maximum charge per run set on your Apify account.");
 const here = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
 // Distinctive UA so Apify run meta.userAgent marks MCP-originated runs.
@@ -42,7 +49,9 @@ function boolToString(v) {
 }
 // actorPath is the actor's IMMUTABLE Apify actor id, not its slug, so a Store
 // rename never breaks these calls.
-async function runActor(actorPath, actorLabel, input) {
+async function runActor(actorPath, actorLabel, input, maxChargeUsd) {
+    if (maxChargeUsd !== undefined)
+        input = { ...input, max_charge_usd: maxChargeUsd };
     if (!APIFY_TOKEN) {
         return { isError: true, content: [{ type: "text", text: "APIFY_TOKEN is not set. Create a token at https://console.apify.com/account/integrations and set it as the APIFY_TOKEN environment variable." }] };
     }
@@ -178,7 +187,7 @@ server.registerTool("map_pinterest_brand_presence", {
     description: "Resolve a company domain to its Pinterest business account and return EXACT follower, following, pin and board counts, plus the claimed website, verified merchant status and last pin date, as one flat Clay ready row. Pinterest serves real integers, so these counts can be summed across a list. Board count is a better activity signal than followers for a consumer brand, because boards are curation effort. Pinterest handles are rarely the domain stem, so a guessed account that fails the identity check is reported as identity_mismatch with no counts rather than returning a stranger's numbers. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.",
     annotations: {
         title: "Map Pinterest Brand Presence",
-        readOnlyHint: true,
+        readOnlyHint: false,
         destructiveHint: false,
         idempotentHint: true,
         openWorldHint: true,
@@ -199,15 +208,16 @@ server.registerTool("map_pinterest_brand_presence", {
         skipCache: z.boolean()
             .optional()
             .describe("Default false: a successful lookup is cached for seven days and reused. Set true to force a fresh fetch."),
+        max_charge_usd: MAX_CHARGE_USD,
     },
-}, async ({ company_domain, company_name, handle, includeFollowerCounts, skipCache }) => {
+}, async ({ company_domain, company_name, handle, includeFollowerCounts, skipCache, max_charge_usd }) => {
     return runActor("d1HvjZfKhgvWsoEwn", "Pinterest Brand Presence Mapper", compact({
         company_domain,
         company_name,
         handle,
         includeFollowerCounts: boolToString(includeFollowerCounts),
         skipCache: boolToString(skipCache),
-    }));
+    }), max_charge_usd);
 });
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mambalabsdev/mcp-pinterest-brand-presence-mapper",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for the Mamba Labs Pinterest Brand Presence Mapper actor on Apify. Resolve a company domain to its Pinterest business account with exact follower, pin and board counts.",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@modelcontextprotocol/sdk": "^1.32.0",
     "zod": "^4.5.4"
   },
   "devDependencies": {