@answerai/answeragent-mcp 1.0.1 → 1.2.0

package/README.md

@@ -129,12 +129,62 @@ The server requires two environment variables:
 ### Document Store Management
 - `create_document_store` - Create document stores
 - `get_document_store` - Get store details
+- `update_document_store` - Update document stores
 - `delete_document_store` - Remove document stores
 - `list_document_stores` - List all stores
-- `query_vector_store` - Query document stores
+- `query_vector_store` - Query document stores (basic)
+- `query_vector_store_with_filter` - Query with metadata filtering (see below)
 - `upsert_document` - Add/update documents
 - `refresh_document_store` - Refresh store contents
 
+#### Metadata Filtering with `query_vector_store_with_filter`
+
+This tool allows semantic search with Pinecone metadata filters to narrow down results based on document metadata fields.
+
+**Parameters:**
+- `storeId` (required): Document store ID
+- `query` (required): Semantic search query text
+- `metadataFilter` (optional): Pinecone metadata filter object
+
+**Supported Filter Operators:**
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| `$eq` | Equal to | `{"department": {"$eq": "sales"}}` |
+| `$ne` | Not equal to | `{"status": {"$ne": "archived"}}` |
+| `$gt` | Greater than (numbers) | `{"version": {"$gt": 1.0}}` |
+| `$gte` | Greater than or equal | `{"version": {"$gte": 2.0}}` |
+| `$lt` | Less than (numbers) | `{"priority": {"$lt": 5}}` |
+| `$lte` | Less than or equal | `{"priority": {"$lte": 3}}` |
+| `$in` | Value in array | `{"status": {"$in": ["active", "pending"]}}` |
+| `$nin` | Value not in array | `{"status": {"$nin": ["deleted", "archived"]}}` |
+| `$or` | Any condition matches | `{"$or": [{"dept": {"$eq": "sales"}}, {"dept": {"$eq": "marketing"}}]}` |
+| `$and` | All conditions match | `{"$and": [{"category": {"$eq": "docs"}}, {"version": {"$gte": 2.0}}]}` |
+
+**Example Filters:**
+
+```json
+// Simple equality
+{"department": {"$eq": "engineering"}}
+
+// Numeric comparison
+{"version": {"$gte": 2.0}}
+
+// Multiple conditions (implicit AND)
+{"department": {"$eq": "sales"}, "product": {"$eq": "enterprise"}}
+
+// OR condition
+{"$or": [{"department": {"$eq": "sales"}}, {"department": {"$eq": "marketing"}}]}
+
+// IN operator
+{"department": {"$in": ["sales", "marketing", "support"]}}
+```
+
+**Important Notes:**
+- String comparisons are case-sensitive
+- Numeric operators require numeric values in metadata (not strings)
+- Documents must have metadata fields set during upsert to be filterable
+
 ### Assistant Management
 - `create_assistant` - Create AI assistants
 - `get_assistant` - Get assistant details
@@ -199,6 +249,18 @@ After configuring in Cursor, you can use natural language commands:
 4. **Query documents**:
    > "Search my 'Contracts' document store for information about payment terms"
 
+5. **Query with metadata filter**:
+   > "Search my document store for pricing information, but only from the sales department"
+
+   The agent will use `query_vector_store_with_filter` with:
+   ```json
+   {
+     "storeId": "your-store-id",
+     "query": "pricing information",
+     "metadataFilter": {"department": {"$eq": "sales"}}
+   }
+   ```
+
 ### With Claude Desktop
 
 After adding to your Claude Desktop configuration:

package/dist/services/document-store.js

@@ -38,4 +38,39 @@ export class DocumentStoreService {
         const { data } = await apiClient.post(`/document-store/vectorstore/query`, payload);
         return data;
     }
+    /**
+     * Query vector store with metadata filtering support.
+     *
+     * This method allows semantic search with Pinecone metadata filters
+     * to narrow down results based on document metadata fields.
+     *
+     * @param payload - Query parameters
+     * @param payload.storeId - Document store ID
+     * @param payload.query - Semantic search query text
+     * @param payload.metadataFilter - Optional Pinecone metadata filter object
+     *
+     * @returns Query results with matching documents, metadata, and timing info
+     *
+     * @example
+     * // Query with department filter
+     * await queryVectorStoreWithFilter({
+     *   storeId: "abc-123",
+     *   query: "What are the pricing options?",
+     *   metadataFilter: { department: { $eq: "sales" } }
+     * });
+     */
+    async queryVectorStoreWithFilter(payload) {
+        const requestBody = {
+            storeId: payload.storeId,
+            query: payload.query,
+        };
+        // Pass metadata filter via inputs (merged with vectorStoreConfig on server)
+        if (payload.metadataFilter) {
+            requestBody.inputs = {
+                pineconeMetadataFilter: payload.metadataFilter,
+            };
+        }
+        const { data } = await apiClient.post(`/document-store/vectorstore/query`, requestBody);
+        return data;
+    }
 }

package/dist/tools/document-stores.js

@@ -101,7 +101,7 @@ export const refreshDocumentStore = {
 };
 export const queryVectorStore = {
     name: "query_vector_store",
-    description: "Query vector store",
+    description: "Query vector store (basic, no filtering)",
     inputSchema: {
         type: "object",
         properties: {
@@ -115,3 +115,102 @@ export const queryVectorStore = {
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },
 };
+/**
+ * Query vector store with metadata filtering.
+ *
+ * This tool allows semantic search with Pinecone metadata filters to narrow down
+ * results based on document metadata fields. Documents must have metadata fields
+ * set during upsert to be filterable.
+ *
+ * ## Metadata Filter Syntax (Pinecone)
+ *
+ * The metadataFilter parameter accepts a JSON object with Pinecone filter operators.
+ *
+ * ### Comparison Operators:
+ * - `$eq`  - Equal to (string, number, boolean)
+ * - `$ne`  - Not equal to
+ * - `$gt`  - Greater than (numbers only)
+ * - `$gte` - Greater than or equal to (numbers only)
+ * - `$lt`  - Less than (numbers only)
+ * - `$lte` - Less than or equal to (numbers only)
+ * - `$in`  - Value is in array
+ * - `$nin` - Value is not in array
+ *
+ * ### Logical Operators:
+ * - `$and` - All conditions must match
+ * - `$or`  - Any condition must match
+ *
+ * ### Example Filters:
+ *
+ * 1. Simple equality:
+ *    { "department": { "$eq": "sales" } }
+ *
+ * 2. Numeric comparison:
+ *    { "version": { "$gte": 2.0 } }
+ *
+ * 3. Multiple conditions (AND - implicit):
+ *    { "department": { "$eq": "sales" }, "product": { "$eq": "enterprise" } }
+ *
+ * 4. OR condition:
+ *    { "$or": [{ "department": { "$eq": "sales" } }, { "department": { "$eq": "marketing" } }] }
+ *
+ * 5. AND with OR:
+ *    { "$and": [{ "category": { "$eq": "documentation" } }, { "$or": [{ "version": { "$gte": 2.0 } }, { "priority": { "$eq": "high" } }] }] }
+ *
+ * 6. IN operator (value in list):
+ *    { "department": { "$in": ["sales", "marketing", "support"] } }
+ *
+ * 7. NOT IN operator:
+ *    { "status": { "$nin": ["archived", "deleted"] } }
+ *
+ * ### Important Notes:
+ * - String comparisons are case-sensitive
+ * - Numeric operators ($gt, $gte, $lt, $lte) require numeric values in metadata
+ * - Security filters (_chatflowId, _organizationId) are automatically applied
+ * - Filter fields must exist in document metadata to match
+ */
+export const queryVectorStoreWithFilter = {
+    name: "query_vector_store_with_filter",
+    description: `Query vector store with metadata filtering. Allows semantic search filtered by document metadata.
+
+METADATA FILTER OPERATORS:
+- $eq: Equal to (e.g., {"department": {"$eq": "sales"}})
+- $ne: Not equal to
+- $gt, $gte, $lt, $lte: Numeric comparisons (e.g., {"version": {"$gte": 2.0}})
+- $in: Value in array (e.g., {"status": {"$in": ["active", "pending"]}})
+- $nin: Value not in array
+- $or: Any condition matches (e.g., {"$or": [{"dept": {"$eq": "sales"}}, {"dept": {"$eq": "marketing"}}]})
+- $and: All conditions match
+
+EXAMPLES:
+1. Filter by department: {"department": {"$eq": "engineering"}}
+2. Filter by version >= 2.0: {"version": {"$gte": 2.0}}
+3. Multiple departments: {"$or": [{"department": {"$eq": "sales"}}, {"department": {"$eq": "marketing"}}]}
+4. Combined filters: {"category": {"$eq": "docs"}, "version": {"$gte": 1.5}}`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            storeId: {
+                type: "string",
+                description: "Document store ID (UUID)",
+            },
+            query: {
+                type: "string",
+                description: "Semantic search query text",
+            },
+            metadataFilter: {
+                type: "object",
+                description: "Pinecone metadata filter object. Use operators like $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $or, $and",
+            },
+        },
+        required: ["storeId", "query"],
+    },
+    handler: async ({ storeId, query, metadataFilter, }) => {
+        const result = await service.queryVectorStoreWithFilter({
+            storeId,
+            query,
+            metadataFilter,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@answerai/answeragent-mcp",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "A lightweight Model Context Protocol (MCP) server for Answer AI chatflow and document store management",
   "type": "module",
   "main": "dist/index.js",