@ulinkly/mcp-server 0.1.14 → 0.1.16

package/dist/tools/__tests__/links.test.js

@@ -70,6 +70,32 @@ describe("Link tools", () => {
             expect(result.isError).toBe(true);
             expect(result.content[0].text).toContain("Quota exceeded");
         });
+        it("forwards externalId to the API body when provided", async () => {
+            mockedApiRequest.mockResolvedValue({ id: "link-1", slug: "abc" });
+            const handler = getHandler("create_link");
+            await handler({
+                projectId: "00000000-0000-0000-0000-000000000001",
+                domainId: "00000000-0000-0000-0000-000000000002",
+                type: "unified",
+                iosUrl: "https://apps.apple.com/app/123",
+                androidUrl: "https://play.google.com/store/apps/details?id=com.example",
+                externalId: "share:user:123:post:456",
+            });
+            expect(mockedApiRequest).toHaveBeenCalledWith("POST", expect.stringContaining("/api/v1/projects/"), expect.objectContaining({ externalId: "share:user:123:post:456" }));
+        });
+        it("omits externalId from the API body when not provided (backward compat)", async () => {
+            mockedApiRequest.mockResolvedValue({ id: "link-1" });
+            const handler = getHandler("create_link");
+            await handler({
+                projectId: "00000000-0000-0000-0000-000000000001",
+                domainId: "00000000-0000-0000-0000-000000000002",
+                type: "unified",
+                iosUrl: "https://apps.apple.com/app/123",
+                androidUrl: "https://play.google.com/store/apps/details?id=com.example",
+            });
+            const [, , body] = mockedApiRequest.mock.calls[0];
+            expect(body).not.toHaveProperty("externalId");
+        });
     });
     // ---------------------------------------------------------------------------
     // list_links

package/dist/tools/links.js

@@ -6,7 +6,7 @@ export function registerLinkTools(server) {
     // -----------------------------------------------------------------------
     server.registerTool("create_link", {
         title: "Create Link",
-        description: "Create a new smart link in a ULink project. Supports unified links (single URL that routes by platform) and dynamic links (parameterised deep links). You must specify the project, domain, and link type. Optionally set platform-specific URLs, fallback URLs, custom slug, metadata, and parameters.",
+        description: "Create a new smart link in a ULink project. Supports unified links (single URL that routes by platform) and dynamic links (parameterised deep links). You must specify the project, domain, and link type. Optionally set platform-specific URLs, fallback URLs, custom slug, metadata, and parameters. Pass externalId (any stable string from your system) to make creation idempotent on (project, externalId).",
         inputSchema: {
             projectId: z.string().uuid().describe("The project to create the link in"),
             domainId: z.string().uuid().describe("The domain to host the link on"),
@@ -15,6 +15,7 @@ export function registerLinkTools(server) {
                 .describe("Link type: 'unified' for smart routing or 'dynamic' for parameterised deep links"),
             slug: z.string().optional().describe("Custom slug for the short URL (auto-generated if omitted)"),
             name: z.string().optional().describe("Human-readable name for the link"),
+            externalId: z.string().min(1).max(255).regex(/^\S+$/, "externalId must not contain whitespace").optional().describe("Optional stable identifier from your system (e.g. 'share:user-123:post-456'). Repeated calls with the same (project, externalId) return the existing link instead of creating a duplicate. Idempotent."),
             iosUrl: z.string().url().startsWith("https://", { message: "URL must use HTTPS" }).optional().describe("URL to open on iOS devices"),
             androidUrl: z.string().url().startsWith("https://", { message: "URL must use HTTPS" }).optional().describe("URL to open on Android devices"),
             fallbackUrl: z.string().url().startsWith("https://", { message: "URL must use HTTPS" }).optional().describe("Fallback URL for unsupported platforms"),
@@ -35,13 +36,15 @@ export function registerLinkTools(server) {
                 .optional()
                 .describe("Arbitrary metadata attached to the link"),
         },
-    }, async ({ projectId, domainId, type, slug, name, iosUrl, androidUrl, fallbackUrl, iosFallbackUrl, androidFallbackUrl, parameters, metadata }) => {
+    }, async ({ projectId, domainId, type, slug, name, externalId, iosUrl, androidUrl, fallbackUrl, iosFallbackUrl, androidFallbackUrl, parameters, metadata }) => {
         try {
             const body = { type };
             if (slug !== undefined)
                 body.slug = slug;
             if (name !== undefined)
                 body.name = name;
+            if (externalId !== undefined)
+                body.externalId = externalId;
             if (iosUrl !== undefined)
                 body.iosUrl = iosUrl;
             if (androidUrl !== undefined)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ulinkly/mcp-server",
-  "version": "0.1.14",
-  "mcpName": "io.github.flywheelstudio/ulink",
+  "version": "0.1.16",
+  "mcpName": "io.github.FlywheelStudio/ulink",
   "description": "ULink MCP Server — Model Context Protocol server for the ULink REST API",
   "type": "module",
   "bin": {