@buygolinks/mcp 0.1.0 → 0.2.0

package/README.md

@@ -66,6 +66,10 @@ Most MCP clients use the same shape. Point them at the `npx -y @buygolinks/mcp`
 | `list_links` | List your links with click counts. |
 | `get_link_stats` | Per-link analytics (by day, country, device, browser, hour, weekday). |
 | `get_overview_stats` | Account-wide analytics. |
+| `list_domains` | List your branded custom short-link domains with provisioning + SSL status. |
+| `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. |
 
 ## Example prompts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buygolinks/mcp",
-  "version": "0.1.0",
+  "version": "0.2.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

@@ -115,10 +115,55 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: 'list_domains',
+    description:
+      'List the user\'s branded custom short-link domains (e.g. go.acme.com). Returns each domain with its provisioning status (pending DNS / active / failed), SSL status, and the CNAME target the user needs to point their hostname at. Also returns the plan tier and the number of domains the plan allows.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'create_domain',
+    description:
+      'Register a new branded custom domain so short links can resolve at the user\'s own hostname instead of buygolinks.com. After creation, the user must add a CNAME record at their DNS provider pointing the hostname at the returned cname_target. SSL is auto-issued by Cloudflare once DNS resolves. Free plan does not allow custom domains.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        hostname: {
+          type: 'string',
+          description: 'The hostname to register, e.g. "go.acme.com". Must be a valid public hostname; the buygolinks.com apex and its subdomains are reserved.',
+        },
+      },
+      required: ['hostname'],
+    },
+  },
+  {
+    name: 'verify_domain',
+    description:
+      'Force a re-check of a custom domain\'s status against Cloudflare. Use after the user has added the CNAME record to advance the domain from "pending" to "active". Returns the refreshed domain row.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domain_id: { type: 'number', description: 'The numeric id of the domain (from list_domains / create_domain).' },
+      },
+      required: ['domain_id'],
+    },
+  },
+  {
+    name: 'delete_domain',
+    description:
+      'Remove a custom domain. Deletes the Cloudflare hostname binding and the local record. Short links served via this domain stop resolving immediately.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        domain_id: { type: 'number', description: 'The numeric id of the domain to remove.' },
+      },
+      required: ['domain_id'],
+    },
+  },
 ];
 
 const server = new Server(
-  { name: 'buygolinks', version: '0.1.0' },
+  { name: 'buygolinks', version: '0.2.0' },
   { capabilities: { tools: {} } },
 );
 
@@ -155,6 +200,25 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         result = await api(`/api/stats/overview${days}`);
         break;
       }
+      case 'list_domains': {
+        result = await api('/api/domains');
+        break;
+      }
+      case 'create_domain': {
+        result = await api('/api/domains', {
+          method: 'POST',
+          body: JSON.stringify({ hostname: args.hostname }),
+        });
+        break;
+      }
+      case 'verify_domain': {
+        result = await api(`/api/domains/${Number(args.domain_id)}/verify`, { method: 'POST' });
+        break;
+      }
+      case 'delete_domain': {
+        result = await api(`/api/domains/${Number(args.domain_id)}`, { method: 'DELETE' });
+        break;
+      }
       default:
         throw new Error(`unknown tool: ${name}`);
     }