@vettly/mcp 0.1.9 → 0.1.10

package/dist/bin/vettly-mcp.cjs

@@ -15,7 +15,7 @@ var ModerateInputSchema = import_zod.z.object({
   policyId: import_zod.z.string().min(1).describe("The policy ID to use for moderation"),
   contentType: import_zod.z.enum(["text", "image", "video"]).default("text").describe("Type of content being moderated")
 });
-function registerModerateTool(server, client) {
+function registerModerateTool(server, client, demoMode = false) {
   server.tool(
     "moderate_content",
     "Check text, image, or video content against a Vettly moderation policy. Returns safety assessment with category scores.",
@@ -39,24 +39,25 @@ function registerModerateTool(server, client) {
           policyId: input.policyId,
           contentType: input.contentType
         });
+        const text = JSON.stringify(
+          {
+            decisionId: result.decisionId,
+            safe: result.safe,
+            flagged: result.flagged,
+            action: result.action,
+            categories: result.categories,
+            provider: result.provider,
+            latency: result.latency,
+            cost: result.cost
+          },
+          null,
+          2
+        );
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(
-                {
-                  decisionId: result.decisionId,
-                  safe: result.safe,
-                  flagged: result.flagged,
-                  action: result.action,
-                  categories: result.categories,
-                  provider: result.provider,
-                  latency: result.latency,
-                  cost: result.cost
-                },
-                null,
-                2
-              )
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -80,7 +81,7 @@ var import_zod2 = require("zod");
 var ValidateInputSchema = import_zod2.z.object({
   yamlContent: import_zod2.z.string().min(1).describe("The YAML policy content to validate")
 });
-function registerValidateTool(server, client) {
+function registerValidateTool(server, client, demoMode = false) {
   server.tool(
     "validate_policy",
     "Validate a Vettly policy YAML without saving it. Returns validation results with any syntax or configuration errors.",
@@ -98,11 +99,12 @@ function registerValidateTool(server, client) {
       const input = ValidateInputSchema.parse(args);
       try {
         const result = await client.validatePolicy(input.yamlContent);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -122,11 +124,14 @@ function registerValidateTool(server, client) {
 }
 
 // src/tools/list-policies.ts
-function registerListPoliciesTool(server, client) {
+var import_zod3 = require("zod");
+function registerListPoliciesTool(server, client, demoMode = false) {
   server.tool(
     "list_policies",
     "List all moderation policies available in your Vettly account.",
-    {},
+    {
+      status: import_zod3.z.enum(["active", "all"]).default("active").describe("Filter by policy status: active only or all policies")
+    },
     {
       title: "List Policies",
       readOnlyHint: true,
@@ -134,14 +139,19 @@ function registerListPoliciesTool(server, client) {
       idempotentHint: true,
       openWorldHint: true
     },
-    async () => {
+    async (args) => {
       try {
         const result = await client.listPolicies();
+        let policies = result;
+        if (args.status === "active" && Array.isArray(policies)) {
+          policies = policies.filter((p) => p.status !== "archived");
+        }
+        const text = JSON.stringify(policies, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -161,11 +171,11 @@ function registerListPoliciesTool(server, client) {
 }
 
 // src/tools/usage-stats.ts
-var import_zod3 = require("zod");
-var UsageStatsInputSchema = import_zod3.z.object({
-  days: import_zod3.z.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
+var import_zod4 = require("zod");
+var UsageStatsInputSchema = import_zod4.z.object({
+  days: import_zod4.z.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
 });
-function registerUsageStatsTool(server, client) {
+function registerUsageStatsTool(server, client, demoMode = false) {
   server.tool(
     "get_usage_stats",
     "Get usage statistics for your Vettly account including request counts, costs, and moderation outcomes.",
@@ -183,11 +193,12 @@ function registerUsageStatsTool(server, client) {
       const input = UsageStatsInputSchema.parse(args);
       try {
         const result = await client.getUsageStats(input.days);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -207,14 +218,14 @@ function registerUsageStatsTool(server, client) {
 }
 
 // src/tools/decisions.ts
-var import_zod4 = require("zod");
-var DecisionsInputSchema = import_zod4.z.object({
-  limit: import_zod4.z.number().min(1).max(50).default(10).describe("Number of decisions to return"),
-  flagged: import_zod4.z.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
-  policyId: import_zod4.z.string().optional().describe("Filter by specific policy ID"),
-  contentType: import_zod4.z.enum(["text", "image", "video"]).optional().describe("Filter by content type")
+var import_zod5 = require("zod");
+var DecisionsInputSchema = import_zod5.z.object({
+  limit: import_zod5.z.number().min(1).max(50).default(10).describe("Number of decisions to return"),
+  flagged: import_zod5.z.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
+  policyId: import_zod5.z.string().optional().describe("Filter by specific policy ID"),
+  contentType: import_zod5.z.enum(["text", "image", "video"]).optional().describe("Filter by content type")
 });
-function registerDecisionsTool(server, client) {
+function registerDecisionsTool(server, client, demoMode = false) {
   server.tool(
     "get_recent_decisions",
     "Get recent moderation decisions with optional filtering by outcome, content type, or policy.",
@@ -245,11 +256,12 @@ function registerDecisionsTool(server, client) {
         if (input.contentType) {
           decisions = decisions.filter((d) => d.contentType === input.contentType);
         }
+        const text = JSON.stringify({ decisions }, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify({ decisions }, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -269,12 +281,13 @@ function registerDecisionsTool(server, client) {
 }
 
 // src/tools/index.ts
-function registerTools(server, client) {
-  registerModerateTool(server, client);
-  registerValidateTool(server, client);
-  registerListPoliciesTool(server, client);
-  registerUsageStatsTool(server, client);
-  registerDecisionsTool(server, client);
+var DEMO_FOOTER = "\n\n---\n\u{1F511} Demo mode (10 requests/day). Get your free API key at https://vettly.dev";
+function registerTools(server, client, demoMode = false) {
+  registerModerateTool(server, client, demoMode);
+  registerValidateTool(server, client, demoMode);
+  registerListPoliciesTool(server, client, demoMode);
+  registerUsageStatsTool(server, client, demoMode);
+  registerDecisionsTool(server, client, demoMode);
 }
 
 // src/resources/policies.ts
@@ -394,12 +407,12 @@ The response includes:
 }
 
 // src/prompts/write-policy.ts
-var import_zod5 = require("zod");
+var import_zod6 = require("zod");
 function registerWritePolicy(server) {
   server.prompt(
     "write-policy",
     "Guide for writing a Vettly moderation policy in YAML. Optionally tailored to a specific platform type.",
-    { platform: import_zod5.z.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
+    { platform: import_zod6.z.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
     async (args) => {
       const platformContext = args.platform ? `
 
@@ -469,12 +482,12 @@ Common categories: \`hate_speech\`, \`violence\`, \`sexual_content\`, \`self_har
 }
 
 // src/prompts/review-flagged-content.ts
-var import_zod6 = require("zod");
+var import_zod7 = require("zod");
 function registerReviewFlaggedContent(server) {
   server.prompt(
     "review-flagged-content",
     "Template for reviewing flagged moderation decisions. Optionally filtered to a specific policy.",
-    { policyId: import_zod6.z.string().optional().describe("Filter flagged decisions to a specific policy ID") },
+    { policyId: import_zod7.z.string().optional().describe("Filter flagged decisions to a specific policy ID") },
     async (args) => {
       const policyFilter = args.policyId ? `
 
@@ -528,16 +541,19 @@ function registerPrompts(server) {
 }
 
 // src/server.ts
+var DEMO_API_KEY = "vettly_test_demo_mcp_readonly";
 function createVettlyMcpServer(config) {
+  const demoMode = !config.apiKey;
+  const apiKey = config.apiKey || DEMO_API_KEY;
   const client = new import_sdk.ModerationClient({
-    apiKey: config.apiKey,
+    apiKey,
     apiUrl: config.apiUrl
   });
   const server = new import_mcp2.McpServer({
     name: "vettly",
     version: "0.1.0"
   });
-  registerTools(server, client);
+  registerTools(server, client, demoMode);
   registerResources(server, client);
   registerPrompts(server);
   return server;
@@ -547,22 +563,8 @@ function createVettlyMcpServer(config) {
 async function main() {
   const apiKey = process.env.VETTLY_API_KEY;
   if (!apiKey) {
-    console.error("Error: VETTLY_API_KEY environment variable is required");
-    console.error("");
-    console.error("Usage:");
-    console.error("  VETTLY_API_KEY=vettly_live_xxx npx @vettly/mcp");
-    console.error("");
-    console.error("Or configure in Claude Desktop:");
-    console.error("  {");
-    console.error('    "mcpServers": {');
-    console.error('      "vettly": {');
-    console.error('        "command": "npx",');
-    console.error('        "args": ["-y", "@vettly/mcp"],');
-    console.error('        "env": { "VETTLY_API_KEY": "vettly_live_xxx" }');
-    console.error("      }");
-    console.error("    }");
-    console.error("  }");
-    process.exit(1);
+    console.error("No VETTLY_API_KEY set \u2014 starting in demo mode (limited to 10 requests/day).");
+    console.error("Get your free API key at https://vettly.dev");
   }
   const server = createVettlyMcpServer({
     apiKey,

package/dist/bin/vettly-mcp.js

@@ -1,29 +1,15 @@
 #!/usr/bin/env node
 import {
   createVettlyMcpServer
-} from "../chunk-L5ZHIGXM.js";
+} from "../chunk-PMBQ22Z2.js";
 
 // src/bin/vettly-mcp.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 async function main() {
   const apiKey = process.env.VETTLY_API_KEY;
   if (!apiKey) {
-    console.error("Error: VETTLY_API_KEY environment variable is required");
-    console.error("");
-    console.error("Usage:");
-    console.error("  VETTLY_API_KEY=vettly_live_xxx npx @vettly/mcp");
-    console.error("");
-    console.error("Or configure in Claude Desktop:");
-    console.error("  {");
-    console.error('    "mcpServers": {');
-    console.error('      "vettly": {');
-    console.error('        "command": "npx",');
-    console.error('        "args": ["-y", "@vettly/mcp"],');
-    console.error('        "env": { "VETTLY_API_KEY": "vettly_live_xxx" }');
-    console.error("      }");
-    console.error("    }");
-    console.error("  }");
-    process.exit(1);
+    console.error("No VETTLY_API_KEY set \u2014 starting in demo mode (limited to 10 requests/day).");
+    console.error("Get your free API key at https://vettly.dev");
   }
   const server = createVettlyMcpServer({
     apiKey,

package/dist/{chunk-L5ZHIGXM.js → chunk-PMBQ22Z2.js}

@@ -9,7 +9,7 @@ var ModerateInputSchema = z.object({
   policyId: z.string().min(1).describe("The policy ID to use for moderation"),
   contentType: z.enum(["text", "image", "video"]).default("text").describe("Type of content being moderated")
 });
-function registerModerateTool(server, client) {
+function registerModerateTool(server, client, demoMode = false) {
   server.tool(
     "moderate_content",
     "Check text, image, or video content against a Vettly moderation policy. Returns safety assessment with category scores.",
@@ -33,24 +33,25 @@ function registerModerateTool(server, client) {
           policyId: input.policyId,
           contentType: input.contentType
         });
+        const text = JSON.stringify(
+          {
+            decisionId: result.decisionId,
+            safe: result.safe,
+            flagged: result.flagged,
+            action: result.action,
+            categories: result.categories,
+            provider: result.provider,
+            latency: result.latency,
+            cost: result.cost
+          },
+          null,
+          2
+        );
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(
-                {
-                  decisionId: result.decisionId,
-                  safe: result.safe,
-                  flagged: result.flagged,
-                  action: result.action,
-                  categories: result.categories,
-                  provider: result.provider,
-                  latency: result.latency,
-                  cost: result.cost
-                },
-                null,
-                2
-              )
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -74,7 +75,7 @@ import { z as z2 } from "zod";
 var ValidateInputSchema = z2.object({
   yamlContent: z2.string().min(1).describe("The YAML policy content to validate")
 });
-function registerValidateTool(server, client) {
+function registerValidateTool(server, client, demoMode = false) {
   server.tool(
     "validate_policy",
     "Validate a Vettly policy YAML without saving it. Returns validation results with any syntax or configuration errors.",
@@ -92,11 +93,12 @@ function registerValidateTool(server, client) {
       const input = ValidateInputSchema.parse(args);
       try {
         const result = await client.validatePolicy(input.yamlContent);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -116,11 +118,14 @@ function registerValidateTool(server, client) {
 }
 
 // src/tools/list-policies.ts
-function registerListPoliciesTool(server, client) {
+import { z as z3 } from "zod";
+function registerListPoliciesTool(server, client, demoMode = false) {
   server.tool(
     "list_policies",
     "List all moderation policies available in your Vettly account.",
-    {},
+    {
+      status: z3.enum(["active", "all"]).default("active").describe("Filter by policy status: active only or all policies")
+    },
     {
       title: "List Policies",
       readOnlyHint: true,
@@ -128,14 +133,19 @@ function registerListPoliciesTool(server, client) {
       idempotentHint: true,
       openWorldHint: true
     },
-    async () => {
+    async (args) => {
       try {
         const result = await client.listPolicies();
+        let policies = result;
+        if (args.status === "active" && Array.isArray(policies)) {
+          policies = policies.filter((p) => p.status !== "archived");
+        }
+        const text = JSON.stringify(policies, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -155,11 +165,11 @@ function registerListPoliciesTool(server, client) {
 }
 
 // src/tools/usage-stats.ts
-import { z as z3 } from "zod";
-var UsageStatsInputSchema = z3.object({
-  days: z3.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
+import { z as z4 } from "zod";
+var UsageStatsInputSchema = z4.object({
+  days: z4.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
 });
-function registerUsageStatsTool(server, client) {
+function registerUsageStatsTool(server, client, demoMode = false) {
   server.tool(
     "get_usage_stats",
     "Get usage statistics for your Vettly account including request counts, costs, and moderation outcomes.",
@@ -177,11 +187,12 @@ function registerUsageStatsTool(server, client) {
       const input = UsageStatsInputSchema.parse(args);
       try {
         const result = await client.getUsageStats(input.days);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -201,14 +212,14 @@ function registerUsageStatsTool(server, client) {
 }
 
 // src/tools/decisions.ts
-import { z as z4 } from "zod";
-var DecisionsInputSchema = z4.object({
-  limit: z4.number().min(1).max(50).default(10).describe("Number of decisions to return"),
-  flagged: z4.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
-  policyId: z4.string().optional().describe("Filter by specific policy ID"),
-  contentType: z4.enum(["text", "image", "video"]).optional().describe("Filter by content type")
+import { z as z5 } from "zod";
+var DecisionsInputSchema = z5.object({
+  limit: z5.number().min(1).max(50).default(10).describe("Number of decisions to return"),
+  flagged: z5.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
+  policyId: z5.string().optional().describe("Filter by specific policy ID"),
+  contentType: z5.enum(["text", "image", "video"]).optional().describe("Filter by content type")
 });
-function registerDecisionsTool(server, client) {
+function registerDecisionsTool(server, client, demoMode = false) {
   server.tool(
     "get_recent_decisions",
     "Get recent moderation decisions with optional filtering by outcome, content type, or policy.",
@@ -239,11 +250,12 @@ function registerDecisionsTool(server, client) {
         if (input.contentType) {
           decisions = decisions.filter((d) => d.contentType === input.contentType);
         }
+        const text = JSON.stringify({ decisions }, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify({ decisions }, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -263,12 +275,13 @@ function registerDecisionsTool(server, client) {
 }
 
 // src/tools/index.ts
-function registerTools(server, client) {
-  registerModerateTool(server, client);
-  registerValidateTool(server, client);
-  registerListPoliciesTool(server, client);
-  registerUsageStatsTool(server, client);
-  registerDecisionsTool(server, client);
+var DEMO_FOOTER = "\n\n---\n\u{1F511} Demo mode (10 requests/day). Get your free API key at https://vettly.dev";
+function registerTools(server, client, demoMode = false) {
+  registerModerateTool(server, client, demoMode);
+  registerValidateTool(server, client, demoMode);
+  registerListPoliciesTool(server, client, demoMode);
+  registerUsageStatsTool(server, client, demoMode);
+  registerDecisionsTool(server, client, demoMode);
 }
 
 // src/resources/policies.ts
@@ -388,12 +401,12 @@ The response includes:
 }
 
 // src/prompts/write-policy.ts
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 function registerWritePolicy(server) {
   server.prompt(
     "write-policy",
     "Guide for writing a Vettly moderation policy in YAML. Optionally tailored to a specific platform type.",
-    { platform: z5.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
+    { platform: z6.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
     async (args) => {
       const platformContext = args.platform ? `
 
@@ -463,12 +476,12 @@ Common categories: \`hate_speech\`, \`violence\`, \`sexual_content\`, \`self_har
 }
 
 // src/prompts/review-flagged-content.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerReviewFlaggedContent(server) {
   server.prompt(
     "review-flagged-content",
     "Template for reviewing flagged moderation decisions. Optionally filtered to a specific policy.",
-    { policyId: z6.string().optional().describe("Filter flagged decisions to a specific policy ID") },
+    { policyId: z7.string().optional().describe("Filter flagged decisions to a specific policy ID") },
     async (args) => {
       const policyFilter = args.policyId ? `
 
@@ -522,16 +535,19 @@ function registerPrompts(server) {
 }
 
 // src/server.ts
+var DEMO_API_KEY = "vettly_test_demo_mcp_readonly";
 function createVettlyMcpServer(config) {
+  const demoMode = !config.apiKey;
+  const apiKey = config.apiKey || DEMO_API_KEY;
   const client = new ModerationClient({
-    apiKey: config.apiKey,
+    apiKey,
     apiUrl: config.apiUrl
   });
   const server = new McpServer({
     name: "vettly",
     version: "0.1.0"
   });
-  registerTools(server, client);
+  registerTools(server, client, demoMode);
   registerResources(server, client);
   registerPrompts(server);
   return server;

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   createVettlyMcpServer: () => createVettlyMcpServer
 });
 module.exports = __toCommonJS(index_exports);
-var import_zod7 = require("zod");
+var import_zod8 = require("zod");
 
 // src/server.ts
 var import_mcp2 = require("@modelcontextprotocol/sdk/server/mcp.js");
@@ -37,7 +37,7 @@ var ModerateInputSchema = import_zod.z.object({
   policyId: import_zod.z.string().min(1).describe("The policy ID to use for moderation"),
   contentType: import_zod.z.enum(["text", "image", "video"]).default("text").describe("Type of content being moderated")
 });
-function registerModerateTool(server, client) {
+function registerModerateTool(server, client, demoMode = false) {
   server.tool(
     "moderate_content",
     "Check text, image, or video content against a Vettly moderation policy. Returns safety assessment with category scores.",
@@ -61,24 +61,25 @@ function registerModerateTool(server, client) {
           policyId: input.policyId,
           contentType: input.contentType
         });
+        const text = JSON.stringify(
+          {
+            decisionId: result.decisionId,
+            safe: result.safe,
+            flagged: result.flagged,
+            action: result.action,
+            categories: result.categories,
+            provider: result.provider,
+            latency: result.latency,
+            cost: result.cost
+          },
+          null,
+          2
+        );
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(
-                {
-                  decisionId: result.decisionId,
-                  safe: result.safe,
-                  flagged: result.flagged,
-                  action: result.action,
-                  categories: result.categories,
-                  provider: result.provider,
-                  latency: result.latency,
-                  cost: result.cost
-                },
-                null,
-                2
-              )
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -102,7 +103,7 @@ var import_zod2 = require("zod");
 var ValidateInputSchema = import_zod2.z.object({
   yamlContent: import_zod2.z.string().min(1).describe("The YAML policy content to validate")
 });
-function registerValidateTool(server, client) {
+function registerValidateTool(server, client, demoMode = false) {
   server.tool(
     "validate_policy",
     "Validate a Vettly policy YAML without saving it. Returns validation results with any syntax or configuration errors.",
@@ -120,11 +121,12 @@ function registerValidateTool(server, client) {
       const input = ValidateInputSchema.parse(args);
       try {
         const result = await client.validatePolicy(input.yamlContent);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -144,11 +146,14 @@ function registerValidateTool(server, client) {
 }
 
 // src/tools/list-policies.ts
-function registerListPoliciesTool(server, client) {
+var import_zod3 = require("zod");
+function registerListPoliciesTool(server, client, demoMode = false) {
   server.tool(
     "list_policies",
     "List all moderation policies available in your Vettly account.",
-    {},
+    {
+      status: import_zod3.z.enum(["active", "all"]).default("active").describe("Filter by policy status: active only or all policies")
+    },
     {
       title: "List Policies",
       readOnlyHint: true,
@@ -156,14 +161,19 @@ function registerListPoliciesTool(server, client) {
       idempotentHint: true,
       openWorldHint: true
     },
-    async () => {
+    async (args) => {
       try {
         const result = await client.listPolicies();
+        let policies = result;
+        if (args.status === "active" && Array.isArray(policies)) {
+          policies = policies.filter((p) => p.status !== "archived");
+        }
+        const text = JSON.stringify(policies, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -183,11 +193,11 @@ function registerListPoliciesTool(server, client) {
 }
 
 // src/tools/usage-stats.ts
-var import_zod3 = require("zod");
-var UsageStatsInputSchema = import_zod3.z.object({
-  days: import_zod3.z.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
+var import_zod4 = require("zod");
+var UsageStatsInputSchema = import_zod4.z.object({
+  days: import_zod4.z.number().min(1).max(365).default(30).describe("Number of days to include in statistics")
 });
-function registerUsageStatsTool(server, client) {
+function registerUsageStatsTool(server, client, demoMode = false) {
   server.tool(
     "get_usage_stats",
     "Get usage statistics for your Vettly account including request counts, costs, and moderation outcomes.",
@@ -205,11 +215,12 @@ function registerUsageStatsTool(server, client) {
       const input = UsageStatsInputSchema.parse(args);
       try {
         const result = await client.getUsageStats(input.days);
+        const text = JSON.stringify(result, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(result, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -229,14 +240,14 @@ function registerUsageStatsTool(server, client) {
 }
 
 // src/tools/decisions.ts
-var import_zod4 = require("zod");
-var DecisionsInputSchema = import_zod4.z.object({
-  limit: import_zod4.z.number().min(1).max(50).default(10).describe("Number of decisions to return"),
-  flagged: import_zod4.z.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
-  policyId: import_zod4.z.string().optional().describe("Filter by specific policy ID"),
-  contentType: import_zod4.z.enum(["text", "image", "video"]).optional().describe("Filter by content type")
+var import_zod5 = require("zod");
+var DecisionsInputSchema = import_zod5.z.object({
+  limit: import_zod5.z.number().min(1).max(50).default(10).describe("Number of decisions to return"),
+  flagged: import_zod5.z.boolean().optional().describe("Filter to only flagged content (true) or safe content (false)"),
+  policyId: import_zod5.z.string().optional().describe("Filter by specific policy ID"),
+  contentType: import_zod5.z.enum(["text", "image", "video"]).optional().describe("Filter by content type")
 });
-function registerDecisionsTool(server, client) {
+function registerDecisionsTool(server, client, demoMode = false) {
   server.tool(
     "get_recent_decisions",
     "Get recent moderation decisions with optional filtering by outcome, content type, or policy.",
@@ -267,11 +278,12 @@ function registerDecisionsTool(server, client) {
         if (input.contentType) {
           decisions = decisions.filter((d) => d.contentType === input.contentType);
         }
+        const text = JSON.stringify({ decisions }, null, 2);
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify({ decisions }, null, 2)
+              text: text + (demoMode ? DEMO_FOOTER : "")
             }
           ]
         };
@@ -291,12 +303,13 @@ function registerDecisionsTool(server, client) {
 }
 
 // src/tools/index.ts
-function registerTools(server, client) {
-  registerModerateTool(server, client);
-  registerValidateTool(server, client);
-  registerListPoliciesTool(server, client);
-  registerUsageStatsTool(server, client);
-  registerDecisionsTool(server, client);
+var DEMO_FOOTER = "\n\n---\n\u{1F511} Demo mode (10 requests/day). Get your free API key at https://vettly.dev";
+function registerTools(server, client, demoMode = false) {
+  registerModerateTool(server, client, demoMode);
+  registerValidateTool(server, client, demoMode);
+  registerListPoliciesTool(server, client, demoMode);
+  registerUsageStatsTool(server, client, demoMode);
+  registerDecisionsTool(server, client, demoMode);
 }
 
 // src/resources/policies.ts
@@ -416,12 +429,12 @@ The response includes:
 }
 
 // src/prompts/write-policy.ts
-var import_zod5 = require("zod");
+var import_zod6 = require("zod");
 function registerWritePolicy(server) {
   server.prompt(
     "write-policy",
     "Guide for writing a Vettly moderation policy in YAML. Optionally tailored to a specific platform type.",
-    { platform: import_zod5.z.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
+    { platform: import_zod6.z.string().optional().describe('The type of platform (e.g. "kids app", "marketplace", "social media", "dating app")') },
     async (args) => {
       const platformContext = args.platform ? `
 
@@ -491,12 +504,12 @@ Common categories: \`hate_speech\`, \`violence\`, \`sexual_content\`, \`self_har
 }
 
 // src/prompts/review-flagged-content.ts
-var import_zod6 = require("zod");
+var import_zod7 = require("zod");
 function registerReviewFlaggedContent(server) {
   server.prompt(
     "review-flagged-content",
     "Template for reviewing flagged moderation decisions. Optionally filtered to a specific policy.",
-    { policyId: import_zod6.z.string().optional().describe("Filter flagged decisions to a specific policy ID") },
+    { policyId: import_zod7.z.string().optional().describe("Filter flagged decisions to a specific policy ID") },
     async (args) => {
       const policyFilter = args.policyId ? `
 
@@ -550,27 +563,30 @@ function registerPrompts(server) {
 }
 
 // src/server.ts
+var DEMO_API_KEY = "vettly_test_demo_mcp_readonly";
 function createVettlyMcpServer(config) {
+  const demoMode = !config.apiKey;
+  const apiKey = config.apiKey || DEMO_API_KEY;
   const client = new import_sdk.ModerationClient({
-    apiKey: config.apiKey,
+    apiKey,
     apiUrl: config.apiUrl
   });
   const server = new import_mcp2.McpServer({
     name: "vettly",
     version: "0.1.0"
   });
-  registerTools(server, client);
+  registerTools(server, client, demoMode);
   registerResources(server, client);
   registerPrompts(server);
   return server;
 }
 
 // src/index.ts
-var configSchema = import_zod7.z.object({
-  vettlyApiKey: import_zod7.z.string().describe(
-    "Your Vettly API key (starts with vettly_live_ or vettly_test_). Get one free at https://vettly.dev"
+var configSchema = import_zod8.z.object({
+  vettlyApiKey: import_zod8.z.string().optional().describe(
+    "Your Vettly API key (starts with vettly_live_ or vettly_test_). Leave empty for demo mode (10 requests/day). Get one free at https://vettly.dev"
   ),
-  apiUrl: import_zod7.z.string().url().default("https://api.vettly.dev").describe("Custom API base URL. Only change this for self-hosted Vettly instances.")
+  apiUrl: import_zod8.z.string().url().default("https://api.vettly.dev").describe("Custom API base URL. Only change this for self-hosted Vettly instances.")
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.js

@@ -1,12 +1,12 @@
 import {
   createVettlyMcpServer
-} from "./chunk-L5ZHIGXM.js";
+} from "./chunk-PMBQ22Z2.js";
 
 // src/index.ts
 import { z } from "zod";
 var configSchema = z.object({
-  vettlyApiKey: z.string().describe(
-    "Your Vettly API key (starts with vettly_live_ or vettly_test_). Get one free at https://vettly.dev"
+  vettlyApiKey: z.string().optional().describe(
+    "Your Vettly API key (starts with vettly_live_ or vettly_test_). Leave empty for demo mode (10 requests/day). Get one free at https://vettly.dev"
   ),
   apiUrl: z.string().url().default("https://api.vettly.dev").describe("Custom API base URL. Only change this for self-hosted Vettly instances.")
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vettly/mcp",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "mcpName": "io.github.code-with-brian/vettly",
   "description": "MCP server for content moderation with Claude and Cursor. Content moderation policy testing.",
   "type": "module",

package/smithery.yaml

@@ -5,12 +5,10 @@ startCommand:
 
 configSchema:
   type: object
-  required:
-    - vettlyApiKey
   properties:
     vettlyApiKey:
       type: string
-      description: Your Vettly API key (starts with vettly_live_ or vettly_test_). Get one free at https://vettly.dev
+      description: Your Vettly API key (starts with vettly_live_ or vettly_test_). Leave empty for demo mode (10 requests/day). Get one free at https://vettly.dev
     apiUrl:
       type: string
       default: https://api.vettly.dev
@@ -18,4 +16,4 @@ configSchema:
 
 commandFunction:
   |-
-  (config) => ({ command: 'npx', args: ['-y', '@vettly/mcp'], env: { VETTLY_API_KEY: config.vettlyApiKey, ...(config.apiUrl && config.apiUrl !== 'https://api.vettly.dev' ? { VETTLY_API_URL: config.apiUrl } : {}) } })
+  (config) => ({ command: 'npx', args: ['-y', '@vettly/mcp'], env: { ...(config.vettlyApiKey ? { VETTLY_API_KEY: config.vettlyApiKey } : {}), ...(config.apiUrl && config.apiUrl !== 'https://api.vettly.dev' ? { VETTLY_API_URL: config.apiUrl } : {}) } })