@closedloop-ai/mcp-client 1.1.2 → 1.3.0

package/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'index.js'
+      - 'package.json'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Upgrade npm to latest
+        run: npm install -g npm@latest
+
+      - name: Check versions
+        run: |
+          node --version
+          npm --version
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts || npm install --ignore-scripts
+
+      - name: Publish with OIDC
+        run: npm publish --access public --provenance

package/README.md

@@ -1,6 +1,6 @@
-# ClosedLoop MCP Server
+# ClosedLoop AI MCP Client
 
-A lightweight Model Context Protocol (MCP) server that provides AI clients with access to ClosedLoop customer feedback data and advanced search capabilities.
+A lightweight Model Context Protocol (MCP) client that provides AI assistants with access to ClosedLoop AI customer feedback data and advanced search capabilities.
 
 ## Features
 
@@ -23,7 +23,7 @@ npm install -g @closedloop-ai/mcp-client
 
 Set the following environment variables:
 
-- `CLOSEDLOOP_API_KEY`: Your ClosedLoop API key (required)
+- `CLOSEDLOOP_API_KEY`: Your ClosedLoop AI API key (required)
 - `CLOSEDLOOP_SERVER_URL`: Server URL (default: https://mcp.closedloop.sh)
 
 ## Usage with Claude
@@ -51,18 +51,124 @@ Add this configuration to your Claude Desktop app:
 Retrieve customer insights with optional filtering and pagination.
 
 **Parameters:**
-- `date_from` (optional): Start date (YYYY-MM-DD)
-- `date_to` (optional): End date (YYYY-MM-DD)  
-- `page` (optional): Page number (default: 1)
-- `limit` (optional): Items per page (default: 20, max: 100)
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `date_from` | string | No | Start date (YYYY-MM-DD) |
+| `date_to` | string | No | End date (YYYY-MM-DD) |
+| `page` | integer | No | Page number (default: 1) |
+| `limit` | integer | No | Items per page (default: 20, max: 100) |
+
+**Response Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | string | Unique insight identifier (UUID) |
+| `signal_title` | string | Title/summary of the insight |
+| `content` | string | Raw feedback content |
+| `category` | string | Insight category (Bug, Feature Request, etc.) |
+| `severity` | string | Severity level (critical, high, medium, low) |
+| `status` | string | Processing status |
+| `source_timestamp` | string | When feedback was received |
+| `customer_name` | string | Customer who provided feedback |
+| `reporter_name` | string | Person who reported the insight |
+| `pain_point` | string | Identified customer pain point |
+| `is_deal_blocker` | boolean | Whether this blocks deals |
+| `relevance_score` | number | Business relevance score |
+| `source_name` | string | Integration source name |
+| `created_at` | string | When insight was created |
+
+**Response Example:**
+```json
+{
+  "insights": [
+    {
+      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+      "signal_title": "Mobile app crashes on startup",
+      "content": "The app keeps crashing whenever I try to open it...",
+      "category": "Bug",
+      "severity": "high",
+      "status": "processed",
+      "source_timestamp": "2024-01-15T10:30:00Z",
+      "customer_name": "Acme Corp",
+      "reporter_name": "John Smith",
+      "pain_point": "Cannot access mobile features",
+      "is_deal_blocker": true,
+      "relevance_score": 0.85,
+      "source_name": "Intercom",
+      "created_at": "2024-01-15T10:35:00Z"
+    }
+  ],
+  "pagination": {
+    "total_count": 142,
+    "page": 1,
+    "limit": 20,
+    "total_pages": 8
+  }
+}
+```
+
+---
 
 ### get_insight_detail
 Get detailed information about a specific insight item.
 
 **Parameters:**
-- `insight_id` (required): UUID of the insight item
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `insight_id` | string | Yes | UUID of the insight item |
 
-### search_insights ⭐ NEW
+**Response Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | string | Unique insight identifier (UUID) |
+| `signal_title` | string | Title/summary of the insight |
+| `content` | string | Raw feedback content |
+| `category` | string | Insight category |
+| `severity` | string | Severity level |
+| `status` | string | Processing status |
+| `summary` | string | AI-generated summary |
+| `outcome_categories` | array | Business impact categories |
+| `customer_name` | string | Customer who provided feedback |
+| `customer_email` | string | Customer email address |
+| `reporter_name` | string | Person who reported the insight |
+| `source_name` | string | Integration source name |
+| `pain_point` | string | Identified customer pain point |
+| `workaround` | string | Customer's current workaround |
+| `use_case` | string | Use case description |
+| `feature_area` | string | Related feature area |
+| `competitor_gap` | string | Competitive analysis notes |
+| `willingness_to_pay` | string | Payment willingness info |
+| `source_timestamp` | string | When feedback was received |
+| `created_at` | string | When insight was created |
+
+**Response Example:**
+```json
+{
+  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+  "signal_title": "Mobile app crashes on startup",
+  "content": "The app keeps crashing whenever I try to open it on my iPhone...",
+  "category": "Bug",
+  "severity": "high",
+  "status": "processed",
+  "summary": "Critical mobile stability issue affecting iOS users on app launch",
+  "outcome_categories": ["Product Quality", "User Experience", "Retention Risk"],
+  "customer_name": "Acme Corp",
+  "customer_email": "john@acme.com",
+  "reporter_name": "John Smith",
+  "source_name": "Intercom",
+  "pain_point": "Cannot access mobile features, forced to use desktop",
+  "workaround": "Using the web version on mobile browser",
+  "use_case": "Field sales team needs mobile access for client meetings",
+  "feature_area": "Mobile App",
+  "competitor_gap": "Competitor X has stable mobile app",
+  "willingness_to_pay": "Would pay extra for reliable mobile experience",
+  "source_timestamp": "2024-01-15T10:30:00Z",
+  "created_at": "2024-01-15T10:35:00Z"
+}
+```
+
+---
+
+### search_insights
 Advanced full-text search across customer insights with relevance ranking and comprehensive filtering.
 
 **Key Features:**
@@ -74,15 +180,17 @@ Advanced full-text search across customer insights with relevance ranking and co
 - **Language agnostic** - works with any language
 
 **Parameters:**
-- `query` (required): Search query text
-- `fields` (optional): Specific fields to search in
-- `category` (optional): Filter by insight category
-- `severity` (optional): Filter by severity level
-- `date_from` (optional): Start date filter
-- `date_to` (optional): End date filter
-- `source` (optional): Filter by data source
-- `page` (optional): Page number (default: 1)
-- `limit` (optional): Items per page (default: 20, max: 100)
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | Search query text |
+| `fields` | array | No | Specific fields to search in |
+| `category` | string | No | Filter by insight category |
+| `severity` | string | No | Filter by severity level |
+| `date_from` | string | No | Start date filter (YYYY-MM-DD) |
+| `date_to` | string | No | End date filter (YYYY-MM-DD) |
+| `source` | string | No | Filter by data source |
+| `page` | integer | No | Page number (default: 1) |
+| `limit` | integer | No | Items per page (default: 20, max: 100) |
 
 **Searchable Fields:**
 - `signal_title` - Insight title
@@ -94,6 +202,53 @@ Advanced full-text search across customer insights with relevance ranking and co
 - `competitor_gap` - Competitive analysis
 - `willingness_to_pay` - Payment willingness info
 
+**Response Fields:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | string | Unique insight identifier (UUID) |
+| `signal_title` | string | Title/summary of the insight |
+| `content` | string | Raw feedback content |
+| `category` | string | Insight category |
+| `severity` | string | Severity level |
+| `search_rank` | number | Search relevance score (higher = more relevant) |
+| `summary` | string | AI-generated summary |
+| `outcome_categories` | array | Business impact categories |
+| `is_deal_blocker` | boolean | Whether this blocks deals |
+| `relevance_score` | number | Business relevance score |
+| `customer_name` | string | Customer who provided feedback |
+| `source_name` | string | Integration source name |
+| `source_timestamp` | string | When feedback was received |
+
+**Response Example:**
+```json
+{
+  "insights": [
+    {
+      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+      "signal_title": "Mobile app crashes on startup",
+      "content": "The app keeps crashing whenever I try to open it...",
+      "category": "Bug",
+      "severity": "high",
+      "search_rank": 0.92,
+      "summary": "Critical mobile stability issue affecting iOS users",
+      "outcome_categories": ["Product Quality", "User Experience"],
+      "is_deal_blocker": true,
+      "relevance_score": 0.85,
+      "customer_name": "Acme Corp",
+      "source_name": "Intercom",
+      "source_timestamp": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total_count": 23,
+    "page": 1,
+    "limit": 20,
+    "total_pages": 2
+  },
+  "query": "mobile crash"
+}
+```
+
 ## Example Usage
 
 Once configured, you can ask Claude questions like:

package/index.js

@@ -32,7 +32,7 @@ const server = new Server(
 const tools = [
   {
     name: 'list_insights',
-    description: 'Retrieve customer insights with optional filtering and pagination',
+    description: 'Retrieve product insights with optional filtering, sorting, and pagination',
     inputSchema: {
       type: 'object',
       properties: {
@@ -42,10 +42,38 @@ const tools = [
           format: 'date'
         },
         date_to: {
-          type: 'string', 
+          type: 'string',
           description: 'End date for insights (YYYY-MM-DD)',
           format: 'date'
         },
+        severity: {
+          type: 'string',
+          enum: ['critical', 'high', 'medium', 'low', 'all'],
+          description: 'Filter by severity level (default: all)'
+        },
+        status: {
+          type: 'string',
+          enum: ['open', 'closed', 'all'],
+          description: 'Filter by insight status (default: all)'
+        },
+        source_id: {
+          type: 'string',
+          description: 'Filter by integration source UUID'
+        },
+        tag: {
+          type: 'string',
+          description: 'Filter by tag (letters, numbers, underscores, hyphens only)'
+        },
+        sort_by: {
+          type: 'string',
+          enum: ['timestamp', 'severity', 'status'],
+          description: 'Field to sort by (default: timestamp)'
+        },
+        sort_order: {
+          type: 'string',
+          enum: ['asc', 'desc'],
+          description: 'Sort direction (default: desc)'
+        },
         page: {
           type: 'integer',
           description: 'Page number (default: 1)',
@@ -228,4 +256,4 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 const transport = new StdioServerTransport();
 server.connect(transport);
 
-console.error('ClosedLoop MCP Server started');
+console.error('ClosedLoop AI MCP Client started');

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "@closedloop-ai/mcp-client",
-  "version": "1.1.2",
-  "description": "ClosedLoop MCP Server for AI client integration with advanced search capabilities",
+  "version": "1.3.0",
+  "description": "ClosedLoop AI MCP Client for AI assistant integration with advanced search capabilities",
   "main": "index.js",
   "bin": {
     "closedloop-mcp": "./index.js"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/closed-loop-ai/mcp-client.git"
+  },
   "scripts": {
     "start": "node index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "axios": "^1.6.0"
   },
   "engines": {
@@ -25,6 +29,6 @@
     "search",
     "full-text-search"
   ],
-  "author": "ClosedLoop",
+  "author": "ClosedLoop AI",
   "license": "MIT"
 }