@originalvoices/mcp-server 1.0.0 → 1.0.2

package/README.md

@@ -1,5 +1,7 @@
 # OriginalVoices MCP Server
 
+[![npm version](https://img.shields.io/npm/v/@originalvoices/mcp-server.svg)](https://www.npmjs.com/package/@originalvoices/mcp-server)
+
 An MCP (Model Context Protocol) server that provides access to [OriginalVoices](https://originalvoices.ai) AI twins for audience research.
 
 ## Installation
@@ -67,10 +69,10 @@ Ask questions to a specific audience using OriginalVoices AI twins.
 
 ```json
 {
-  "audience": "Software developers aged 25-40 in the US",
+  "audience": "UK, 18-30, fitness enthusiasts",
   "questions": [
-    "What is your biggest frustration with current dev tools?",
-    "How do you discover new tools and frameworks?"
+    "When purchasing running shoes, what's most important to you?",
+    "How often do you replace your running shoes?"
   ]
 }
 ```

package/dist/index.js

@@ -5,14 +5,22 @@ import { z } from "zod";
 import OriginalVoices from "originalvoices";
 const server = new McpServer({
     name: "originalvoices",
-    version: "1.0.0",
+    version: "1.0.2",
 });
 const client = new OriginalVoices({
     apiKey: process.env.ORIGINALVOICES_API_KEY,
 });
-server.tool("ask_twins", "Ask questions to a specific audience using Original Voices AI twins", {
-    audience: z.string().describe("Description of the audience"),
-    questions: z.array(z.string()).describe("Array of questions to ask the audience"),
+server.tool("ask_twins", "Ask questions to a specific audience using Original Voices AI twins. Use this for ad-hoc audience queries with a free-text audience description.", {
+    audience: z
+        .string()
+        .min(1)
+        .max(255)
+        .describe("The target audience to query. Typically includes demographics such as age range, gender, and location. Examples: 'Women aged 35-55 in the US and UK', 'Gen Z men (18-25) in urban areas'."),
+    questions: z
+        .array(z.string().min(1).max(2048))
+        .min(1)
+        .max(15)
+        .describe("The questions to ask the Digital Twins. Open-ended questions work best."),
 }, async ({ audience, questions }) => {
     const response = await client.ask.open({
         questions,
@@ -27,6 +35,72 @@ server.tool("ask_twins", "Ask questions to a specific audience using Original Vo
         ],
     };
 });
+server.tool("ask_audience", "Ask questions to a previously saved audience by its ID. Use list_projects first to discover projects and their audiences.", {
+    audienceId: z
+        .string()
+        .min(1)
+        .describe("The audience ID to query. Obtain IDs from list_projects."),
+    questions: z
+        .array(z.string().min(1).max(2048))
+        .min(1)
+        .max(15)
+        .describe("The questions to ask the Digital Twins. Open-ended questions work best."),
+}, async ({ audienceId, questions }) => {
+    const response = await client.ask.open({
+        questions,
+        audienceId,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response.data, null, 2),
+            },
+        ],
+    };
+});
+server.tool("ask_project", "Ask questions to a filtered subset of a project's survey panel. Filters respondents by demographics and survey answers using natural language. Use list_projects first to see available projects.", {
+    projectId: z
+        .string()
+        .min(1)
+        .describe("The project ID to query. Obtain IDs from list_projects."),
+    filter: z
+        .string()
+        .min(1)
+        .max(1024)
+        .optional()
+        .describe("Optional natural language filter to select respondents. If omitted, all respondents are queried. Examples: 'Samsung users', 'women over 30 who worry about battery'."),
+    questions: z
+        .array(z.string().min(1).max(2048))
+        .min(1)
+        .max(15)
+        .describe("The questions to ask the Digital Twins. Open-ended questions work best."),
+}, async ({ projectId, filter, questions }) => {
+    const response = await client.ask.project(projectId, {
+        questions,
+        filter,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response.data, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_projects", "List all research projects in the user's organization. Each project contains survey questions and pre-defined audiences. Use this to discover projects before using ask_project or ask_audience.", {}, async () => {
+    // SDK projects.list() has a bug (hits /v1/audiences), so use client.get directly
+    const response = await client.get("/v1/projects");
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response.data, null, 2),
+            },
+        ],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@originalvoices/mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for Original Voices - Ask AI twins questions about any audience",
+  "version": "1.0.2",
+  "mcpName": "io.github.ovlabs/originalvoices",
+  "description": "MCP server for OriginalVoices - Ask AI twins questions about any audience",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -21,11 +22,11 @@
     "twins",
     "audience-research"
   ],
-  "author": "Original Voices",
+  "author": "OriginalVoices",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/originalvoices/mcp-server.git"
+    "url": "https://github.com/ovlabs/mcp-server-originalvoices.git"
   },
   "engines": {
     "node": ">=20"
@@ -35,7 +36,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "originalvoices": "^0.11.0",
+    "originalvoices": "^0.14.1",
     "zod": "^4.3.5"
   },
   "devDependencies": {