@ziggs-ai/ziggs-mcp 0.1.11 → 0.1.12

package/dist/config.d.ts

@@ -3,6 +3,8 @@ import { z } from 'zod';
 declare const envSchema: z.ZodObject<{
     ZIGGS_API_URL: z.ZodOptional<z.ZodString>;
     HTTP_URL: z.ZodOptional<z.ZodString>;
+    /** Web app base URL for constructing shareable links. Defaults to https://ziggsai.com. */
+    ZIGGS_WEB_URL: z.ZodOptional<z.ZodString>;
     ZIGGS_OPERATOR_KEY: z.ZodString;
     /** Optional when the operator key is agent-scoped (ZIG-279). */
     ZIGGS_AGENT_ID: z.ZodOptional<z.ZodString>;
@@ -12,12 +14,14 @@ declare const envSchema: z.ZodObject<{
     ZIGGS_OPERATOR_KEY: string;
     ZIGGS_API_URL?: string | undefined;
     HTTP_URL?: string | undefined;
+    ZIGGS_WEB_URL?: string | undefined;
     ZIGGS_AGENT_ID?: string | undefined;
     ZIGGS_OWNER_USER_ID?: string | undefined;
 }, {
     ZIGGS_OPERATOR_KEY: string;
     ZIGGS_API_URL?: string | undefined;
     HTTP_URL?: string | undefined;
+    ZIGGS_WEB_URL?: string | undefined;
     ZIGGS_AGENT_ID?: string | undefined;
     ZIGGS_OWNER_USER_ID?: string | undefined;
 }>;

package/dist/config.js

@@ -4,6 +4,8 @@ import { MINT_KEY_HELP, resolveDelegateAgentId } from './operatorKey.js';
 const envSchema = z.object({
     ZIGGS_API_URL: z.string().optional(),
     HTTP_URL: z.string().optional(),
+    /** Web app base URL for constructing shareable links. Defaults to https://ziggsai.com. */
+    ZIGGS_WEB_URL: z.string().optional(),
     ZIGGS_OPERATOR_KEY: z.string().min(1, 'ZIGGS_OPERATOR_KEY is required'),
     /** Optional when the operator key is agent-scoped (ZIG-279). */
     ZIGGS_AGENT_ID: z.string().optional(),
@@ -15,6 +17,7 @@ export function loadConfig() {
     const raw = {
         ZIGGS_API_URL: process.env.ZIGGS_API_URL,
         HTTP_URL: process.env.HTTP_URL ?? process.env.ZIGGS_API_URL,
+        ZIGGS_WEB_URL: process.env.ZIGGS_WEB_URL,
         ZIGGS_OPERATOR_KEY: process.env.ZIGGS_OPERATOR_KEY,
         ZIGGS_AGENT_ID: process.env.ZIGGS_AGENT_ID,
         ZIGGS_OWNER_USER_ID: process.env.ZIGGS_OWNER_USER_ID,

package/dist/tools.js

@@ -166,7 +166,10 @@ export function registerZiggsTools(server, creds, cfg) {
     });
     server.tool('ziggs_send_message', 'Send a chat message as the delegate agent (requires chat membership). Cross-org first contact requires an ACTIVE link first (ziggs_request_link / ziggs_create_link_invite, then approve/claim); without it, messaging an agent outside your org fails with AGENT_NOT_PUBLISHED.', {
         chatId: z.string(),
-        receiverId: z.string().describe('User or agent id receiving the message'),
+        receiverId: z
+            .string()
+            .optional()
+            .describe('User or agent id receiving the message. Optional when the chat has exactly one other member (the recipient is inferred server-side); required when multiple members could receive it.'),
         text: z.string(),
         entryType: z
             .string()
@@ -348,5 +351,5 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e.message);
         }
     });
-    registerTrustTools(server, creds);
+    registerTrustTools(server, creds, cfg);
 }

package/dist/trustTools.d.ts

@@ -1,4 +1,5 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type Creds } from '@ziggs-ai/api-client';
+import type { ZiggsMcpConfig } from './config.js';
 /** ZIG-433 — agent search + context grant management through MCP. */
-export declare function registerTrustTools(server: McpServer, creds: Creds): void;
+export declare function registerTrustTools(server: McpServer, creds: Creds, cfg?: ZiggsMcpConfig): void;

package/dist/trustTools.js

@@ -13,8 +13,10 @@ function toolError(message) {
 }
 const grantScopeKindSchema = z.enum(['chat', 'agreement', 'org']);
 const contextTemporalSchema = z.enum(['from-now', 'from-start']);
+const DEFAULT_WEB_URL = 'https://ziggsai.com';
 /** ZIG-433 — agent search + context grant management through MCP. */
-export function registerTrustTools(server, creds) {
+export function registerTrustTools(server, creds, cfg) {
+    const webUrl = cfg?.ZIGGS_WEB_URL?.replace(/\/$/, '') ?? DEFAULT_WEB_URL;
     server.tool('ziggs_search_agents', 'Find agents (AgentSearchClient). A keyword/natural-language query searches PUBLISHED agents only. Passing an EXACT agent id resolves that one agent even if it is unpublished/private — use this to look up a delegate someone shared their id for, then ziggs_request_link against it (ZIG-480). Use returned agentId in grant/issue tools — do not guess ids.', {
         query: z.string().describe('Keyword/natural-language search (published agents) OR an exact agent id (resolves that agent even if unpublished)'),
         limit: z.number().optional().describe('Max results (default server-side)'),
@@ -183,7 +185,8 @@ export function registerTrustTools(server, creds) {
             return textResult({
                 status: 'open',
                 inviteId: agreement.agreementId,
-                message: 'Open link invite created. Share inviteId (agreementId) with the counterparty; they claim it via ziggs_claim_link_invite. No agent id needed on either side.',
+                claimUrl: `${webUrl}/app/link-invites/${agreement.agreementId}`,
+                message: 'Open link invite created. Share claimUrl with the counterparty — they open it in the Ziggs web app to claim and activate the link. No agent id needed on either side.',
                 agreement,
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts — act as your Ziggs delegate agent",
   "type": "module",
   "bin": {