@buygolinks/mcp 0.24.0 → 0.25.0

package/README.md

@@ -72,6 +72,7 @@ Most MCP clients use the same shape. Point them at the `npx -y @buygolinks/mcp`
 | `create_domain` | Register a new branded domain (e.g. `go.acme.com`). Returns the CNAME target. |
 | `verify_domain` | Force a fresh Cloudflare status check after DNS is added. |
 | `delete_domain` | Remove a branded domain. |
+| `get_universal_postback_url` | Get the account's **universal postback URL** (Voluum-style, `/postback/u/{token}`): ONE URL that works for every campaign and every network. It matches the click by `clickid` (alias `cid`) and credits whichever campaign the click belongs to — paste it once into any network's S2S settings or your own webhook (n8n, Zapier, store order webhooks) and never update it again. Optional `payout`, `currency`, `txid` params. Prefer this over per-campaign/per-network postbacks unless you want campaign-scoped validation. |
 | `list_affiliate_networks` / `create_affiliate_network` / `update_affiliate_network` / `delete_affiliate_network` | Manage affiliate networks. Each network exposes a per-network postback URL (`/postback/n/{token}`) the user pastes into the network's S2S settings. Set `amazon_tag` (e.g. `yourtagid-20`) on an Amazon network to auto-tag every Amazon link with `?tag=…` at click time. |
 | `list_offers` / `create_offer` / `update_offer` / `delete_offer` | Manage destination URLs ("offers"). Optionally tied to an affiliate network so the right conversion-param name is propagated on outbound clicks. |
 | `list_landers` / `create_lander` / `update_lander` / `delete_lander` | Manage landing pages. Lander URLs may contain `{clickid}` tokens which the resolver expands. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buygolinks/mcp",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "MCP server for buygolinks.com — create and manage branded short links with Amazon affiliate geo-routing from any MCP-compatible AI agent (Claude Desktop, Cursor, Cline, Continue, Hermes).",
   "type": "module",
   "bin": {

package/src/index.js

@@ -197,6 +197,12 @@ const TOOLS = [
   },
 
   // ─── Tracker: affiliate networks ────────────────────────────────────────
+  {
+    name: 'get_universal_postback_url',
+    description:
+      'Get the account\'s UNIVERSAL postback URL (Voluum-style): ONE URL that works for every campaign and every affiliate network. It matches the click by click_id alone and credits whichever campaign the click belongs to, so the user pastes it once into any network\'s S2S settings or their own webhook (n8n, Zapier, a store\'s order webhook) and never updates it again. Format: https://buygolinks.com/postback/u/{token}?clickid={clickid}&payout={payout}&currency={currency}&txid={txid} — payout/currency/txid optional; `cid` is accepted as an alias for `clickid`. Prefer this over per-campaign or per-network postback URLs unless the user explicitly wants campaign-scoped validation (the per-campaign URL rejects clicks from other campaigns with a 400).',
+    inputSchema: { type: 'object', properties: {} },
+  },
   {
     name: 'list_affiliate_networks',
     description:
@@ -832,6 +838,16 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       }
 
       // ── Tracker: networks ──
+      case 'get_universal_postback_url': {
+        const me = await api('/api/me');
+        const base = me.user && me.user.postback_url;
+        result = {
+          postback_url: base,
+          template: base ? `${base}?clickid=REPLACE&payout=OPTIONAL&currency=OPTIONAL&txid=OPTIONAL` : null,
+          note: 'Universal: works for every campaign and every network. payout/currency/txid are optional; cid is accepted as an alias for clickid.',
+        };
+        break;
+      }
       case 'list_affiliate_networks': {
         result = await api('/api/affiliate-networks');
         break;