@tuteliq/mcp 3.3.4 → 3.3.5

package/README.md

@@ -26,7 +26,7 @@
 
 Tuteliq MCP Server brings AI-powered child safety tools directly into Claude, Cursor, and other MCP-compatible AI assistants. Ask Claude to check messages for bullying, detect grooming patterns, or generate safety action plans.
 
-## Available Tools (35)
+## Available Tools (41 MCP + 2 API-only)
 
 ### Safety Detection
 
@@ -36,16 +36,31 @@ Tuteliq MCP Server brings AI-powered child safety tools directly into Claude, Cu
 | `detect_grooming` | Detect grooming patterns and predatory behavior in conversations |
 | `detect_unsafe` | Identify unsafe content (self-harm, violence, explicit material) |
 | `analyze` | Quick comprehensive safety check (bullying + unsafe) |
+| `analyse_multi` | Run multiple detection endpoints on a single piece of text in one call |
 | `analyze_emotions` | Analyze emotional content and mental state indicators |
 | `get_action_plan` | Generate age-appropriate guidance for safety situations |
 | `generate_report` | Create incident reports from conversations |
 
-### Voice & Image Analysis
+### Fraud & Harm Detection
+
+| Tool | Description |
+|------|-------------|
+| `detect_social_engineering` | Detect social engineering tactics (pretexting, urgency fabrication, authority impersonation) |
+| `detect_app_fraud` | Detect app-based fraud (fake investment platforms, phishing apps, subscription traps) |
+| `detect_romance_scam` | Detect romance scam patterns (love-bombing, financial requests, identity deception) |
+| `detect_mule_recruitment` | Detect money mule recruitment tactics (easy-money offers, bank account sharing) |
+| `detect_gambling_harm` | Detect gambling-related harm indicators (chasing losses, concealment, distress) |
+| `detect_coercive_control` | Detect coercive control patterns (isolation, financial control, monitoring, threats) |
+| `detect_vulnerability_exploitation` | Detect exploitation of vulnerable individuals (elderly, disabled, financially distressed) |
+| `detect_radicalisation` | Detect radicalisation indicators (extremist rhetoric, us-vs-them framing, ideological grooming) |
+
+### Voice, Image & Video Analysis
 
 | Tool | Description |
 |------|-------------|
 | `analyze_voice` | Transcribe audio and run safety analysis on the transcript |
 | `analyze_image` | Analyze images for visual safety + OCR text extraction |
+| `analyze_video` | Analyze video files for safety concerns via key frame extraction (supports mp4, mov, avi, webm, mkv) |
 
 ### Webhook Management
 
@@ -94,7 +109,9 @@ Tuteliq MCP Server brings AI-powered child safety tools directly into Claude, Cu
 | `get_breach` | Get details of a specific data breach |
 | `update_breach_status` | Update breach status and notification progress |
 
-### Verification
+### Verification (API & SDK only)
+
+These tools are available via the [REST API](https://docs.tuteliq.ai) and the [@tuteliq/sdk](https://www.npmjs.com/package/@tuteliq/sdk) Node SDK — not yet exposed as MCP tools.
 
 | Tool | Description |
 |------|-------------|
@@ -105,27 +122,38 @@ Tuteliq MCP Server brings AI-powered child safety tools directly into Claude, Cu
 
 ## Installation
 
-### Claude Desktop
+### Claude Desktop (Recommended)
+
+1. Open Claude Desktop and go to **Settings > Connectors**
+2. Click **Add custom connector**
+3. Set the name to **Tuteliq** and the URL to:
+   ```
+   https://api.tuteliq.ai/mcp
+   ```
+4. When prompted, enter your Tuteliq API key
+
+That's it — Tuteliq tools will be available in your next conversation.
+
+### Cursor
 
-Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
+Add to your Cursor MCP settings:
 
 ```json
 {
   "mcpServers": {
     "tuteliq": {
-      "command": "npx",
-      "args": ["-y", "@tuteliq/mcp"],
-      "env": {
-        "TUTELIQ_API_KEY": "your-api-key"
+      "url": "https://api.tuteliq.ai/mcp",
+      "headers": {
+        "Authorization": "Bearer your-api-key"
       }
     }
   }
 }
 ```
 
-### Cursor
+### Other MCP clients (npx)
 
-Add to your Cursor MCP settings:
+For clients that support stdio transport:
 
 ```json
 {
@@ -141,17 +169,6 @@ Add to your Cursor MCP settings:
 }
 ```
 
-### Global Install
-
-```bash
-npm install -g @tuteliq/mcp
-```
-
-Then run:
-```bash
-TUTELIQ_API_KEY=your-api-key tuteliq-mcp
-```
-
 ---
 
 ## Usage Examples
@@ -206,21 +223,18 @@ The message contains direct exclusionary language...
 ### Usage
 > "Show my monthly usage"
 
-### Age Verification
-> "Verify the age of this user using their uploaded ID document"
-> "Estimate this user's age from their selfie using biometric analysis"
-
-### Identity Verification
-> "Verify this user's identity by matching their selfie against their ID document"
+### Fraud Detection
+> "Check this message for social engineering: 'Your account will be suspended unless you verify now'"
+> "Is this a romance scam? 'I know we just met online but I need help with a medical bill'"
 
 ---
 
-## Get an API Key
+## Get Started (Free)
 
-1. Go to [tuteliq.ai](https://tuteliq.ai)
-2. Create an account
-3. Generate an API key
-4. Add it to your MCP config
+1. [Create a free Tuteliq account](https://tuteliq.ai)
+2. Go to your [Dashboard](https://tuteliq.ai/dashboard) and generate an **API Key**
+3. For Claude Desktop and other MCP plugins, generate a **Secure Token** under **Settings > Plugins**
+4. Use the API key for direct API/SDK access, or the Secure Token when connecting via MCP
 
 ---
 
@@ -231,6 +245,42 @@ The message contains direct exclusionary language...
 
 ---
 
+## Supported Languages (27)
+
+Language is auto-detected when not specified. Beta languages have good accuracy but may have edge cases compared to English.
+
+| Language | Code | Status |
+|----------|------|--------|
+| English | `en` | Stable |
+| Spanish | `es` | Beta |
+| Portuguese | `pt` | Beta |
+| French | `fr` | Beta |
+| German | `de` | Beta |
+| Italian | `it` | Beta |
+| Dutch | `nl` | Beta |
+| Polish | `pl` | Beta |
+| Romanian | `ro` | Beta |
+| Turkish | `tr` | Beta |
+| Greek | `el` | Beta |
+| Czech | `cs` | Beta |
+| Hungarian | `hu` | Beta |
+| Bulgarian | `bg` | Beta |
+| Croatian | `hr` | Beta |
+| Slovak | `sk` | Beta |
+| Slovenian | `sl` | Beta |
+| Lithuanian | `lt` | Beta |
+| Latvian | `lv` | Beta |
+| Estonian | `et` | Beta |
+| Maltese | `mt` | Beta |
+| Irish | `ga` | Beta |
+| Swedish | `sv` | Beta |
+| Norwegian | `no` | Beta |
+| Danish | `da` | Beta |
+| Finnish | `fi` | Beta |
+| Ukrainian | `uk` | Beta |
+
+---
+
 ## Best Practices
 
 ### Message Batching
@@ -245,6 +295,18 @@ Enable `PII_REDACTION_ENABLED=true` on your Tuteliq API to automatically strip e
 
 ---
 
+## Supported Languages
+
+Tuteliq supports **27 languages** with automatic detection — no configuration required.
+
+**English** (stable) and **26 beta languages**: Spanish, Portuguese, Ukrainian, Swedish, Norwegian, Danish, Finnish, German, French, Dutch, Polish, Italian, Turkish, Romanian, Greek, Czech, Hungarian, Bulgarian, Croatian, Slovak, Lithuanian, Latvian, Estonian, Slovenian, Maltese, and Irish.
+
+All 24 EU official languages + Ukrainian, Norwegian, and Turkish. Each language includes culture-specific safety guidelines covering local slang, grooming patterns, self-harm coded vocabulary, and filter evasion techniques.
+
+See the [Language Support docs](https://docs.tuteliq.ai/languages) for details.
+
+---
+
 ## Support
 
 - **API Docs**: [docs.tuteliq.ai](https://docs.tuteliq.ai)

package/dist/src/tools/admin.js

@@ -129,7 +129,7 @@ ${result.recommendations ? `### Recommendation\n${result.recommendations.reason}
         return { content: [{ type: 'text', text: `## \u26A0\uFE0F Consent Withdrawn\n\n**Type:** ${result.consent.consent_type}\n**Status:** ${result.consent.status}` }] };
     });
     server.tool('rectify_data', 'Rectify (correct) user data (GDPR Right to Rectification).', {
-        collection: z.string().describe('Firestore collection name'),
+        collection: z.string().describe('Collection name'),
         document_id: z.string().describe('Document ID to rectify'),
         fields: z.record(z.string(), z.unknown()).describe('Fields to update'),
     }, async ({ collection, document_id, fields }) => {

package/dist/src/tools/analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/tools/analysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAkC1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAkO9E"}
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/tools/analysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAkC1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAoO9E"}

package/dist/src/tools/analysis.js

@@ -192,6 +192,7 @@ ${result.recommended_next_steps.map((step, i) => `${i + 1}. ${step}`).join('\n')
             endpoints: z.array(z.string()).describe('Detection endpoints to run'),
             context: z.record(z.string(), z.unknown()).optional().describe('Optional analysis context'),
             include_evidence: z.boolean().optional().describe('Include supporting evidence'),
+            support_threshold: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Minimum severity to show crisis support resources (default: high). Critical always shows.'),
             external_id: z.string().optional().describe('External tracking ID'),
             customer_id: z.string().optional().describe('Customer identifier'),
         },
@@ -201,13 +202,14 @@ ${result.recommended_next_steps.map((step, i) => `${i + 1}. ${step}`).join('\n')
             'openai/toolInvocation/invoking': 'Running multi-endpoint analysis...',
             'openai/toolInvocation/invoked': 'Multi-endpoint analysis complete.',
         },
-    }, async ({ content, endpoints, context, include_evidence, external_id, customer_id }) => {
+    }, async ({ content, endpoints, context, include_evidence, support_threshold, external_id, customer_id }) => {
         try {
             const result = await client.analyseMulti({
                 content,
                 detections: endpoints,
                 context: context,
                 includeEvidence: include_evidence,
+                supportThreshold: support_threshold,
                 external_id,
                 customer_id,
             });

package/dist/src/tools/detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../src/tools/detection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA6C5C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAqN/E"}
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../src/tools/detection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA6C5C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CA2N/E"}

package/dist/src/tools/detection.js

@@ -54,13 +54,15 @@ export function registerDetectionTools(server, client) {
         inputSchema: {
             content: z.string().describe('The text content to analyze for bullying'),
             context: contextSchema,
+            support_threshold: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Minimum severity to show crisis support resources (default: high). Critical always shows.'),
         },
         _meta: uiMeta('Shows bullying detection results with risk indicators', 'Analyzing content for bullying...', 'Bullying analysis complete.'),
-    }, async ({ content, context }) => {
+    }, async ({ content, context, support_threshold }) => {
         try {
             const result = await client.detectBullying({
                 content,
                 context: context,
+                supportThreshold: support_threshold,
             });
             const emoji = severityEmoji[result.severity] || '\u26AA';
             let text = `## ${result.is_bullying ? '\u26A0\uFE0F Bullying Detected' : '\u2705 No Bullying Detected'}
@@ -101,13 +103,15 @@ ${result.rationale}
                 content: z.string(),
             })).describe('Array of messages in the conversation'),
             childAge: z.number().optional().describe('Age of the child in the conversation'),
+            support_threshold: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Minimum severity to show crisis support resources (default: high). Critical always shows.'),
         },
         _meta: uiMeta('Shows grooming detection results with risk indicators', 'Analyzing conversation for grooming patterns...', 'Grooming analysis complete.'),
-    }, async ({ messages, childAge }) => {
+    }, async ({ messages, childAge, support_threshold }) => {
         try {
             const result = await client.detectGrooming({
                 messages,
                 childAge,
+                supportThreshold: support_threshold,
             });
             const emoji = riskEmoji[result.grooming_risk] || '\u26AA';
             let text = `## ${result.grooming_risk === 'none' ? '\u2705 No Grooming Detected' : '\u26A0\uFE0F Grooming Risk Detected'}
@@ -145,13 +149,15 @@ ${result.rationale}
         inputSchema: {
             content: z.string().describe('The text content to analyze for unsafe content'),
             context: contextSchema,
+            support_threshold: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Minimum severity to show crisis support resources (default: high). Critical always shows.'),
         },
         _meta: uiMeta('Shows unsafe content detection results', 'Analyzing content for safety concerns...', 'Safety analysis complete.'),
-    }, async ({ content, context }) => {
+    }, async ({ content, context, support_threshold }) => {
         try {
             const result = await client.detectUnsafe({
                 content,
                 context: context,
+                supportThreshold: support_threshold,
             });
             const emoji = severityEmoji[result.severity] || '\u26AA';
             let text = `## ${result.unsafe ? '\u26A0\uFE0F Unsafe Content Detected' : '\u2705 Content is Safe'}

package/dist/src/tools/fraud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fraud.d.ts","sourceRoot":"","sources":["../../../src/tools/fraud.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AAyF1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAkD3E"}
+{"version":3,"file":"fraud.d.ts","sourceRoot":"","sources":["../../../src/tools/fraud.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,cAAc,CAAC;AA0F1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAmD3E"}

package/dist/src/tools/fraud.js

@@ -72,6 +72,7 @@ const fraudInputSchema = {
     content: z.string().describe('Text content to analyze'),
     context: z.record(z.string(), z.unknown()).optional().describe('Optional analysis context'),
     include_evidence: z.boolean().optional().describe('Include supporting evidence excerpts'),
+    support_threshold: z.enum(['low', 'medium', 'high', 'critical']).optional().describe('Minimum severity to show crisis support resources (default: high). Critical always shows.'),
     external_id: z.string().optional().describe('External tracking ID'),
     customer_id: z.string().optional().describe('Customer identifier'),
 };
@@ -88,13 +89,14 @@ export function registerFraudTools(server, client) {
                 'openai/toolInvocation/invoking': tool.invoking,
                 'openai/toolInvocation/invoked': tool.invoked,
             },
-        }, async ({ content, context, include_evidence, external_id, customer_id }) => {
+        }, async ({ content, context, include_evidence, support_threshold, external_id, customer_id }) => {
             try {
                 const fn = client[tool.method].bind(client);
                 const result = await fn({
                     content,
                     context: context,
                     includeEvidence: include_evidence,
+                    supportThreshold: support_threshold,
                     external_id,
                     customer_id,
                 });