@closedloop-ai/mcp-client 1.1.1 → 1.2.5

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

@@ -18,7 +18,7 @@ if (!CLOSEDLOOP_API_KEY) {
 const server = new Server(
   {
     name: 'closedloop-mcp-server',
-    version: '1.1.0',
+    version: '1.1.2',
     description: 'Provides access to ClosedLoop AI product feedback data and insights with advanced search capabilities.',
   },
   {
@@ -178,7 +178,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (!args.query) {
           throw new Error('query is required');
         }
-        response = await axios.post(`${CLOSEDLOOP_SERVER_URL}/search`, args, {
+        // Use MCP protocol for search_insights
+        response = await axios.post(CLOSEDLOOP_SERVER_URL, {
+          jsonrpc: '2.0',
+          id: 1,
+          method: 'tools/call',
+          params: {
+            name: 'search_insights',
+            arguments: args
+          }
+        }, {
           headers
         });
         break;
@@ -187,11 +196,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         throw new Error(`Unknown tool: ${name}`);
     }
 
+    // Handle MCP protocol response for search_insights
+    let responseData = response.data;
+    if (name === 'search_insights' && responseData.result) {
+      responseData = responseData.result;
+    }
+
     return {
       content: [
         {
           type: 'text',
-          text: JSON.stringify(response.data, null, 2)
+          text: JSON.stringify(responseData, null, 2)
         }
       ]
     };
@@ -213,4 +228,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,11 +1,15 @@
 {
   "name": "@closedloop-ai/mcp-client",
-  "version": "1.1.1",
-  "description": "ClosedLoop MCP Server for AI client integration with advanced search capabilities",
+  "version": "1.2.5",
+  "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"
   },
@@ -25,6 +29,6 @@
     "search",
     "full-text-search"
   ],
-  "author": "ClosedLoop",
+  "author": "ClosedLoop AI",
   "license": "MIT"
 }