@chorus-research/mcp 0.1.0

package/README.md

@@ -0,0 +1,126 @@
+# @chorus-research/mcp
+
+MCP server for the [Chorus Research](https://chorusresearch.com) survey platform — create surveys, launch them to targeted audiences, and collect responses, all from your AI agent.
+
+Built on the [Model Context Protocol](https://modelcontextprotocol.io).
+
+## Quick Start
+
+### 1. Get an API key
+
+Sign up at [chorusresearch.com](https://chorusresearch.com) and generate an API key from your dashboard.
+
+### 2. Add to your MCP client
+
+**Claude Code (`.mcp.json`)**:
+
+```json
+{
+  "mcpServers": {
+    "chorus-research": {
+      "command": "npx",
+      "args": ["@chorus-research/mcp"],
+      "env": {
+        "CHORUS_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop (`claude_desktop_config.json`)**:
+
+```json
+{
+  "mcpServers": {
+    "chorus-research": {
+      "command": "npx",
+      "args": ["@chorus-research/mcp"],
+      "env": {
+        "CHORUS_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+The server exposes 10 tools across surveys, audiences, pricing, launch, and responses.
+
+### Surveys
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `list_surveys` | List surveys with optional filtering and pagination | `status?`, `page?`, `pageSize?`, `sort?`, `order?` |
+| `get_survey` | Get full survey details including the JSON definition | `surveyId` |
+| `create_survey` | Create a new survey draft | `name`, `survey` (JSON), `targetCompletes`, `description?` |
+
+### Audiences
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `list_audiences` | List all available audience segments with costs and targeting criteria | _(none)_ |
+| `get_audience` | Get details for a specific audience segment | `audienceId` |
+
+### Pricing
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `estimate_cost` | Calculate launch cost (costPerResponse x targetCompletes) | `audienceId`, `targetCompletes`, `projectId?` |
+| `get_pricing_config` | Get current cost-per-response and currency | _(none)_ |
+
+### Launch (two-step)
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `launch_survey` | Launch a survey to collect responses | See below |
+| `get_survey_status` | Real-time fielding status (completes, progress %, ETA) | `surveyId` |
+
+**`launch_survey` is a two-step process** to prevent accidental charges:
+
+1. **Estimate** — call with `surveyId`, `audienceId`, and `targetCompletes`. Returns a cost estimate and a `confirmToken` (valid 5 minutes).
+2. **Confirm** — call again with `surveyId` and the `confirmToken` to execute the launch and charge payment.
+
+```
+# Step 1: Get estimate
+launch_survey(surveyId, audienceId="genpop", targetCompletes=100)
+# → { step: "estimate", estimatedCost: 100, confirmToken: "tok_...", expiresAt: "..." }
+
+# Step 2: Confirm (triggers real charges)
+launch_survey(surveyId, confirmToken="tok_...")
+# → { step: "confirmed", success: true, amountCharged: 100 }
+```
+
+### Responses
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `get_responses` | Export response data with pagination | `surveyId`, `page?`, `pageSize?`, `status?`, `includeDuplicates?` |
+
+Response metadata includes device info (userAgent, screenSize, timezone), geographic data (city, state, country), and provider demographics when available. Duplicates are excluded by default.
+
+## Resources
+
+| URI | Name | Description |
+|-----|------|-------------|
+| `chorus://audiences` | Audience Catalog | Full catalog of audience segments with targeting, costs, and fielding times |
+| `chorus://pricing/config` | Pricing Configuration | Current cost-per-response and currency |
+
+## Prompts
+
+| Name | Description | Arguments |
+|------|-------------|-----------|
+| `design_survey` | Guides survey creation with best practices | `topic` (required), `audience?`, `numQuestions?` |
+| `launch_checklist` | Pre-launch validation checklist with cost review | `surveyId` (required) |
+
+## Configuration
+
+| Environment Variable | Description | Default |
+|---------------------|-------------|---------|
+| `CHORUS_API_KEY` | API key for authentication (required) | _(none)_ |
+| `CHORUS_API_BASE_URL` | Base URL for the Chorus Research API | `https://api.chorusresearch.io` |
+
+## Requirements
+
+- Node.js >= 20

package/dist/client.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Typed HTTP client wrapping the Chorus Research Public API.
+ *
+ * Reads CHORUS_API_KEY and CHORUS_API_BASE_URL from the environment.
+ */
+export interface Audience {
+    id: string;
+    name: string;
+    description: string;
+    costPerResponse: number;
+    minTargetCompletes: number;
+    maxTargetCompletes: number;
+    averageLengthOfInterview: number;
+    targeting: {
+        age_min: number;
+        age_max: number;
+        country: string;
+    };
+    estimatedFieldingTime: Record<string, string>;
+}
+export interface Survey {
+    id: string;
+    name: string;
+    survey: Record<string, unknown>;
+    targetCompletes: number;
+    description?: string;
+    status: "draft" | "live" | "complete" | "cancelled";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Pagination {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+}
+export interface PricingEstimate {
+    audienceId: string;
+    targetCompletes: number;
+    baseCostPerComplete: number;
+    subtotal: number;
+    total: number;
+    currency: string;
+}
+export interface PricingConfig {
+    costPerResponse: number;
+    currency: string;
+}
+export interface LaunchEstimate {
+    estimatedCost: number;
+    breakdown: PricingEstimate;
+    confirmToken: string;
+    expiresAt: string;
+}
+export interface LaunchConfirmation {
+    success: boolean;
+    publishedSurveyId: string;
+    workflowId: string;
+    paymentIntentId: string;
+    amountCharged: number;
+    currency: string;
+    targetCompletes: number;
+}
+export interface SurveyStatus {
+    projectId: string;
+    publishedSurveyId: string | null;
+    status: "draft" | "live" | "complete" | "cancelled";
+    completes: number;
+    target: number;
+    progress: number;
+    lastUpdated: string;
+    estimatedCompletion: string | null;
+    message?: string;
+}
+export interface SurveyResponse {
+    id: string;
+    publishedSurveyId: string;
+    responseData: Record<string, unknown>;
+    metadata: {
+        rdud?: string;
+        completedAt?: string;
+        supplier?: string;
+        demographics?: Record<string, unknown>;
+        start_time?: string;
+        end_time?: string;
+        generated_at?: string;
+        userAgent?: string;
+        language?: string;
+        screenSize?: string;
+        timezone?: string;
+        city?: string;
+        state?: string;
+        region?: string;
+        country?: string;
+    };
+    status: "complete" | "partial" | "incomplete";
+    supplier: string | null;
+    createdAt: string;
+    completedAt: string;
+}
+export interface ApiError {
+    error: string;
+    message: string;
+    code: string;
+}
+export declare class ChorusApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(opts?: {
+        baseUrl?: string;
+        apiKey?: string;
+    });
+    private headers;
+    private request;
+    listAudiences(): Promise<{
+        audiences: Audience[];
+        count: number;
+    }>;
+    getAudience(id: string): Promise<Audience>;
+    estimateCost(params: {
+        audienceId: string;
+        targetCompletes: number;
+        projectId?: string;
+    }): Promise<PricingEstimate>;
+    getPricingConfig(): Promise<PricingConfig>;
+    createSurvey(params: {
+        name: string;
+        survey: Record<string, unknown>;
+        targetCompletes: number;
+        description?: string;
+    }): Promise<Survey>;
+    listSurveys(params?: {
+        status?: string;
+        page?: number;
+        pageSize?: number;
+        sort?: string;
+        order?: string;
+    }): Promise<{
+        surveys: Survey[];
+        pagination: Pagination;
+    }>;
+    getSurvey(id: string): Promise<Survey>;
+    launchEstimate(surveyId: string, params: {
+        audienceId: string;
+        targetCompletes: number;
+    }): Promise<LaunchEstimate>;
+    launchConfirm(surveyId: string, params: {
+        confirmToken: string;
+        paymentMethodId?: string;
+    }): Promise<LaunchConfirmation>;
+    getSurveyStatus(surveyId: string): Promise<SurveyStatus>;
+    getResponses(surveyId: string, params?: {
+        page?: number;
+        pageSize?: number;
+        status?: string;
+        includeDuplicates?: boolean;
+    }): Promise<{
+        responses: SurveyResponse[];
+        pagination: Pagination;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,86 @@
+/**
+ * Typed HTTP client wrapping the Chorus Research Public API.
+ *
+ * Reads CHORUS_API_KEY and CHORUS_API_BASE_URL from the environment.
+ */
+// ── Client ────────────────────────────────────────────────────────
+export class ChorusApiClient {
+    baseUrl;
+    apiKey;
+    constructor(opts) {
+        this.baseUrl = (opts?.baseUrl ??
+            process.env.CHORUS_API_BASE_URL ??
+            "https://api.chorusresearch.io").replace(/\/$/, "");
+        this.apiKey = opts?.apiKey ?? process.env.CHORUS_API_KEY ?? "";
+    }
+    // ── Internals ──────────────────────────────────────────────────
+    headers() {
+        const h = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.apiKey) {
+            h["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return h;
+    }
+    async request(method, path, body, query) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        const res = await fetch(url.toString(), {
+            method,
+            headers: this.headers(),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const json = await res.json();
+        if (!res.ok) {
+            const err = json;
+            throw new Error(`API ${res.status}: ${err.message ?? err.error ?? "Unknown error"} (${err.code ?? "NO_CODE"})`);
+        }
+        return json;
+    }
+    // ── Audiences ──────────────────────────────────────────────────
+    async listAudiences() {
+        return this.request("GET", "/audiences");
+    }
+    async getAudience(id) {
+        return this.request("GET", `/audiences/${encodeURIComponent(id)}`);
+    }
+    // ── Pricing ────────────────────────────────────────────────────
+    async estimateCost(params) {
+        return this.request("POST", "/pricing/estimate", params);
+    }
+    async getPricingConfig() {
+        return this.request("GET", "/pricing/config");
+    }
+    // ── Surveys ────────────────────────────────────────────────────
+    async createSurvey(params) {
+        return this.request("POST", "/surveys", params);
+    }
+    async listSurveys(params) {
+        return this.request("GET", "/surveys", undefined, params);
+    }
+    async getSurvey(id) {
+        return this.request("GET", `/surveys/${encodeURIComponent(id)}`);
+    }
+    // ── Launch ─────────────────────────────────────────────────────
+    async launchEstimate(surveyId, params) {
+        return this.request("POST", `/surveys/${encodeURIComponent(surveyId)}/launch`, params);
+    }
+    async launchConfirm(surveyId, params) {
+        return this.request("POST", `/surveys/${encodeURIComponent(surveyId)}/launch/confirm`, params);
+    }
+    async getSurveyStatus(surveyId) {
+        return this.request("GET", `/surveys/${encodeURIComponent(surveyId)}/status`);
+    }
+    // ── Responses ──────────────────────────────────────────────────
+    async getResponses(surveyId, params) {
+        return this.request("GET", `/surveys/${encodeURIComponent(surveyId)}/responses`, undefined, params);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { FastMCP } from "fastmcp";
+import { ChorusApiClient } from "./client.js";
+import { registerSurveyTools } from "./tools/surveys.js";
+import { registerAudienceTools } from "./tools/audiences.js";
+import { registerPricingTools } from "./tools/pricing.js";
+import { registerLaunchTools } from "./tools/launch.js";
+import { registerResponseTools } from "./tools/responses.js";
+import { registerAudienceResources } from "./resources/audiences.js";
+import { registerPricingResources } from "./resources/pricing.js";
+import { registerDesignSurveyPrompt } from "./prompts/design-survey.js";
+import { registerLaunchChecklistPrompt } from "./prompts/launch-checklist.js";
+const server = new FastMCP({
+    name: "Chorus Research",
+    version: "0.1.0",
+    instructions: `Chorus Research MCP — programmatic survey creation, launch, and response collection.
+
+## Quick Start
+1. Use \`list_audiences\` to see available audience segments
+2. Use \`get_pricing_config\` or \`estimate_cost\` to understand pricing
+3. Use \`create_survey\` to create a survey draft with a JSON definition
+4. Use \`launch_survey\` (two-step) to launch and collect responses
+5. Use \`get_responses\` to export collected data
+
+## Key Concepts
+- **Audiences**: Pre-defined respondent segments (e.g., "genpop" = US adults 18+)
+- **Two-step launch**: Launching requires an estimate step then a confirm step to prevent accidental charges
+- **Fielding**: After launch, responses are collected automatically from the target audience
+
+## Authentication
+Set the CHORUS_API_KEY environment variable with your API key.`,
+});
+const api = new ChorusApiClient();
+// Register tools
+registerSurveyTools(server, api);
+registerAudienceTools(server, api);
+registerPricingTools(server, api);
+registerLaunchTools(server, api);
+registerResponseTools(server, api);
+// Register resources
+registerAudienceResources(server, api);
+registerPricingResources(server, api);
+// Register prompts
+registerDesignSurveyPrompt(server);
+registerLaunchChecklistPrompt(server);
+// Start on stdio (consumer MCP clients)
+server.start({ transportType: "stdio" });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAE9E,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;IACzB,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE;;;;;;;;;;;;;;;+DAe+C;CAC9D,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;AAElC,iBAAiB;AACjB,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACnC,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAClC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEnC,qBAAqB;AACrB,yBAAyB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACvC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEtC,mBAAmB;AACnB,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAEtC,wCAAwC;AACxC,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC"}

package/dist/prompts/design-survey.d.ts

@@ -0,0 +1,3 @@
+import type { FastMCP } from "fastmcp";
+export declare function registerDesignSurveyPrompt(server: FastMCP): void;
+//# sourceMappingURL=design-survey.d.ts.map

package/dist/prompts/design-survey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-survey.d.ts","sourceRoot":"","sources":["../../src/prompts/design-survey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,QAmGzD"}

package/dist/prompts/design-survey.js

@@ -0,0 +1,98 @@
+export function registerDesignSurveyPrompt(server) {
+    server.addPrompt({
+        name: "design_survey",
+        description: "Guide an AI agent through survey creation best practices for the Chorus Research platform. Produces a valid SurveyJS JSON definition.",
+        arguments: [
+            {
+                name: "topic",
+                description: "The research topic or objective for the survey",
+                required: true,
+            },
+            {
+                name: "audience",
+                description: 'Target audience description (e.g., "US adults 18+", "parents with young children")',
+                required: false,
+            },
+            {
+                name: "numQuestions",
+                description: "Approximate number of questions desired (default: 10)",
+                required: false,
+            },
+        ],
+        async load({ topic, audience, numQuestions }) {
+            const count = numQuestions || "10";
+            const aud = audience || "general population (US adults 18+)";
+            return `You are designing a survey for the Chorus Research platform. Follow these best practices:
+
+## Research Objective
+${topic}
+
+## Target Audience
+${aud}
+
+## Guidelines
+
+### Survey Structure
+- Target approximately ${count} questions
+- Keep the survey under 15 minutes to avoid LOI cost multipliers (>15 min = 20% cost increase)
+- Group related questions onto the same page
+- Start with easy, engaging questions before sensitive topics
+- Use a logical flow — general to specific
+- Survey questions are limited to 10, server will reject more.
+- There must be at least 1 question for a survey to launch
+
+### Question Types Available
+- **text**: Short open-ended (use inputType: "text", "email", "number", "date")
+- **comment**: Long open-ended (multi-line textarea)
+- **radiogroup**: Single-select from a list
+- **checkbox**: Multi-select from a list
+- **dropdown**: Single-select dropdown (good for long lists)
+- **tagbox**: Multi-select searchable dropdown
+- **boolean**: Yes/No toggle
+- **rating**: Numeric or star scale
+- **ranking**: Drag-and-drop ordering
+
+### Best Practices
+- Every input question should have \`"isRequired": true\` (auto-enforced at publish)
+- Use clear, unbiased question wording
+- Avoid double-barreled questions (asking two things at once)
+- Include "Prefer not to answer" or "Other" options for sensitive questions
+- Use \`visibleIf\` for conditional logic (e.g., show follow-up only if parent answer matches)
+- Keep choice lists to 7±2 items when possible
+- Use consistent scale directions (e.g., always low-to-high)
+
+### Survey JSON Format
+The output must be a valid JSON object with this structure:
+\`\`\`json
+{
+  "title": "Survey Title",
+  "description": "Brief description",
+  "pages": [
+    {
+      "name": "page1",
+      "title": "Page Title",
+      "elements": [
+        {
+          "type": "radiogroup",
+          "name": "q1_unique_name",
+          "title": "Question text here?",
+          "isRequired": true,
+          "choices": ["Option 1", "Option 2", "Option 3"]
+        }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+### Constraints
+- Maximum 10 pages, 50 elements per page
+- Maximum 5 MB total survey definition
+- All question \`name\` fields must be unique within the survey
+- URLs in questions must be HTTP/HTTPS
+
+Please create the complete SurveyJS JSON for this survey, then use the \`create_survey\` tool to save it as a draft.`;
+        },
+    });
+}
+//# sourceMappingURL=design-survey.js.map

package/dist/prompts/design-survey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-survey.js","sourceRoot":"","sources":["../../src/prompts/design-survey.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,MAAM,CAAC,SAAS,CAAC;QACf,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,uIAAuI;QACzI,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,gDAAgD;gBAC7D,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EACT,oFAAoF;gBACtF,QAAQ,EAAE,KAAK;aAChB;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,uDAAuD;gBACpE,QAAQ,EAAE,KAAK;aAChB;SACF;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE;YAC1C,MAAM,KAAK,GAAG,YAAY,IAAI,IAAI,CAAC;YACnC,MAAM,GAAG,GAAG,QAAQ,IAAI,oCAAoC,CAAC;YAE7D,OAAO;;;EAGX,KAAK;;;EAGL,GAAG;;;;;yBAKoB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qHA0DuF,CAAC;QAClH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/launch-checklist.d.ts

@@ -0,0 +1,3 @@
+import type { FastMCP } from "fastmcp";
+export declare function registerLaunchChecklistPrompt(server: FastMCP): void;
+//# sourceMappingURL=launch-checklist.d.ts.map

package/dist/prompts/launch-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-checklist.d.ts","sourceRoot":"","sources":["../../src/prompts/launch-checklist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,QAyE5D"}

package/dist/prompts/launch-checklist.js

@@ -0,0 +1,74 @@
+export function registerLaunchChecklistPrompt(server) {
+    server.addPrompt({
+        name: "launch_checklist",
+        description: "Pre-launch validation checklist. Guides an AI agent through verifying a survey is ready to launch, estimating costs, and confirming with the user before charging.",
+        arguments: [
+            {
+                name: "surveyId",
+                description: "The UUID of the survey to validate for launch",
+                required: true,
+            },
+        ],
+        async load({ surveyId }) {
+            return `You are preparing to launch survey \`${surveyId}\` on the Chorus Research platform. Follow this checklist carefully:
+
+## Pre-Launch Checklist
+
+### 1. Retrieve & Review Survey
+- Use \`get_survey\` to fetch the full survey definition
+- Verify the survey is in **draft** status
+- Check that it has a descriptive name
+- Review all questions for clarity and completeness
+
+### 2. Validate Survey Quality
+- [ ] All questions have clear, unbiased wording
+- [ ] Required questions are marked \`isRequired: true\`
+- [ ] Conditional logic (\`visibleIf\`) is correct
+- [ ] No duplicate question names
+- [ ] Reasonable number of pages/questions
+- [ ] Estimated completion time is reasonable (aim for <15 minutes)
+- [ ] Surveys are 10 questions or less
+
+### 3. Choose Audience
+- Use \`list_audiences\` to see available segments
+- Select the most appropriate audience for the research objective
+- Note the audience's \`minTargetCompletes\` and \`maxTargetCompletes\`
+
+### 4. Estimate Cost
+- Use \`estimate_cost\` with the chosen audience and target completes
+- Review the cost breakdown:
+  - Base cost per complete ($1.00 for General Population)
+  - Total cost (baseCostPerComplete × targetCompletes)
+- If cost seems high, consider reducing target completes
+
+### 5. Present Summary to User
+Show the user:
+- Survey name and question count
+- Target audience
+- Target completes
+- **Total estimated cost (prominently displayed)**
+- Estimated fielding time
+
+### 6. Get Explicit Confirmation
+**CRITICAL**: You MUST get explicit user confirmation before proceeding.
+Say something like: "This will charge approximately $X to your account. Shall I proceed with the launch?"
+
+### 7. Execute Launch (Two-Step)
+Only after user confirms:
+1. Call \`launch_survey\` with \`surveyId\`, \`audienceId\`, and \`targetCompletes\` → get estimate + \`confirmToken\`
+2. Call \`launch_survey\` again with \`surveyId\` and \`confirmToken\` → execute launch
+
+### 8. Verify Launch
+- Confirm the launch response shows \`success: true\`
+- Note the \`workflowId\` for status tracking
+- Use \`get_survey_status\` to verify the survey is now **live**
+
+## Important Reminders
+- The confirmToken expires in **5 minutes** — don't delay between steps
+- Launch tokens are single-use (replay attack prevention)
+- Once launched, the survey CANNOT be edited
+- Charges are processed immediately upon confirmation`;
+        },
+    });
+}
+//# sourceMappingURL=launch-checklist.js.map

package/dist/prompts/launch-checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-checklist.js","sourceRoot":"","sources":["../../src/prompts/launch-checklist.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,6BAA6B,CAAC,MAAe;IAC3D,MAAM,CAAC,SAAS,CAAC;QACf,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,oKAAoK;QACtK,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,+CAA+C;gBAC5D,QAAQ,EAAE,IAAI;aACf;SACF;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE;YACrB,OAAO,wCAAwC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAyDP,CAAC;QACnD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/resources/audiences.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerAudienceResources(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=audiences.d.ts.map

package/dist/resources/audiences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.d.ts","sourceRoot":"","sources":["../../src/resources/audiences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,eAAe,QAarB"}

package/dist/resources/audiences.js

@@ -0,0 +1,13 @@
+export function registerAudienceResources(server, api) {
+    server.addResource({
+        uri: "chorus://audiences",
+        name: "Audience Catalog",
+        description: "Full catalog of available audience segments with targeting criteria, costs, and estimated fielding times.",
+        mimeType: "application/json",
+        async load() {
+            const result = await api.listAudiences();
+            return { text: JSON.stringify(result, null, 2) };
+        },
+    });
+}
+//# sourceMappingURL=audiences.js.map

package/dist/resources/audiences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.js","sourceRoot":"","sources":["../../src/resources/audiences.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,yBAAyB,CACvC,MAAe,EACf,GAAoB;IAEpB,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,2GAA2G;QAC7G,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/resources/pricing.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerPricingResources(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/resources/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/resources/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,eAAe,QAarB"}

package/dist/resources/pricing.js

@@ -0,0 +1,13 @@
+export function registerPricingResources(server, api) {
+    server.addResource({
+        uri: "chorus://pricing/config",
+        name: "Pricing Configuration",
+        description: "Current pricing configuration including cost per response and currency.",
+        mimeType: "application/json",
+        async load() {
+            const config = await api.getPricingConfig();
+            return { text: JSON.stringify(config, null, 2) };
+        },
+    });
+}
+//# sourceMappingURL=pricing.js.map

package/dist/resources/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/resources/pricing.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CACtC,MAAe,EACf,GAAoB;IAEpB,MAAM,CAAC,WAAW,CAAC;QACjB,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,yEAAyE;QAC3E,QAAQ,EAAE,kBAAkB;QAC5B,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/audiences.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerAudienceTools(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=audiences.d.ts.map

package/dist/tools/audiences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.d.ts","sourceRoot":"","sources":["../../src/tools/audiences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,QA2B1E"}

package/dist/tools/audiences.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export function registerAudienceTools(server, api) {
+    server.addTool({
+        name: "list_audiences",
+        description: "List all available audience segments for survey targeting. Each audience includes cost per response, targeting criteria, and estimated fielding times.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        execute: async () => {
+            const result = await api.listAudiences();
+            return JSON.stringify(result, null, 2);
+        },
+    });
+    server.addTool({
+        name: "get_audience",
+        description: "Get detailed information about a specific audience segment including targeting criteria, cost, and fielding time estimates.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        parameters: z.object({
+            audienceId: z
+                .string()
+                .describe('Audience identifier (e.g., "genpop")'),
+        }),
+        execute: async ({ audienceId }) => {
+            const audience = await api.getAudience(audienceId);
+            return JSON.stringify(audience, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=audiences.js.map

package/dist/tools/audiences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.js","sourceRoot":"","sources":["../../src/tools/audiences.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,GAAoB;IACzE,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,wJAAwJ;QAC1J,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,sCAAsC,CAAC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;YAChC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/launch.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerLaunchTools(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=launch.d.ts.map

package/dist/tools/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/tools/launch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,QAwGxE"}

package/dist/tools/launch.js

@@ -0,0 +1,87 @@
+import { UserError } from "fastmcp";
+import { z } from "zod";
+export function registerLaunchTools(server, api) {
+    server.addTool({
+        name: "launch_survey",
+        description: `Launch a survey to collect responses. This is a TWO-STEP process to prevent accidental charges:
+
+Step 1 (estimate): Call with surveyId, audienceId, and targetCompletes. Returns a cost estimate and a confirmToken (valid 5 minutes).
+
+Step 2 (confirm): Call again with surveyId and the confirmToken from step 1 to execute the launch and charge payment.
+
+IMPORTANT: Step 2 triggers real charges and starts a Temporal workflow for fielding. Always show the cost estimate to the user and get explicit confirmation before proceeding to step 2.`,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        parameters: z.object({
+            surveyId: z.string().uuid().describe("Survey ID to launch"),
+            // Step 1 params
+            audienceId: z
+                .string()
+                .optional()
+                .describe('Step 1: Audience segment ID (e.g., "genpop"). Required for estimate step.'),
+            targetCompletes: z
+                .number()
+                .int()
+                .min(0)
+                .max(5000)
+                .optional()
+                .describe("Step 1: Number of completed responses desired (0-5000, raise min for production). Required for estimate step."),
+            // Step 2 params
+            confirmToken: z
+                .string()
+                .optional()
+                .describe("Step 2: Confirmation token from the estimate step. Provide this to execute the launch."),
+            paymentMethodId: z
+                .string()
+                .optional()
+                .describe("Step 2: Optional Stripe payment method ID."),
+        }),
+        execute: async (args) => {
+            const { surveyId, audienceId, targetCompletes, confirmToken, paymentMethodId } = args;
+            // Step 2: Confirm launch
+            if (confirmToken) {
+                const result = await api.launchConfirm(surveyId, {
+                    confirmToken,
+                    paymentMethodId,
+                });
+                return JSON.stringify({
+                    step: "confirmed",
+                    message: `Survey launched successfully. Workflow ${result.workflowId} is now fielding ${result.targetCompletes} responses. Amount charged: $${result.amountCharged} ${result.currency}.`,
+                    ...result,
+                }, null, 2);
+            }
+            // Step 1: Get estimate
+            if (!audienceId || !targetCompletes) {
+                throw new UserError("For step 1 (estimate), both audienceId and targetCompletes are required. For step 2 (confirm), provide the confirmToken from step 1.");
+            }
+            const estimate = await api.launchEstimate(surveyId, {
+                audienceId,
+                targetCompletes,
+            });
+            return JSON.stringify({
+                step: "estimate",
+                message: `Estimated cost: $${estimate.estimatedCost} USD. The confirmToken expires at ${estimate.expiresAt}. Call launch_survey again with the confirmToken to execute the launch.`,
+                ...estimate,
+            }, null, 2);
+        },
+    });
+    server.addTool({
+        name: "get_survey_status",
+        description: "Get the real-time fielding status of a survey including completion count, progress percentage, and estimated completion time. Results are cached for 30 seconds.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        parameters: z.object({
+            surveyId: z
+                .string()
+                .uuid()
+                .describe("Survey ID to check status for"),
+        }),
+        execute: async ({ surveyId }) => {
+            const status = await api.getSurveyStatus(surveyId);
+            return JSON.stringify(status, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=launch.js.map

package/dist/tools/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/tools/launch.ts"],"names":[],"mappings":"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"}

package/dist/tools/pricing.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerPricingTools(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/tools/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/tools/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,QAsCzE"}

package/dist/tools/pricing.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export function registerPricingTools(server, api) {
+    server.addTool({
+        name: "estimate_cost",
+        description: "Calculate the cost to launch a survey to a specific audience. Returns cost breakdown: baseCostPerComplete × targetCompletes. Use this before launching to understand pricing.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        parameters: z.object({
+            audienceId: z
+                .string()
+                .describe('Audience segment ID (e.g., "genpop")'),
+            targetCompletes: z
+                .number()
+                .int()
+                .min(0)
+                .max(5000)
+                .describe("Number of completed responses desired (0-5000, raise min for production)"),
+            projectId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Optional survey project ID for LOI auto-calculation"),
+        }),
+        execute: async (args) => {
+            const estimate = await api.estimateCost(args);
+            return JSON.stringify(estimate, null, 2);
+        },
+    });
+    server.addTool({
+        name: "get_pricing_config",
+        description: "Get the current pricing configuration including cost per response and currency. Useful for understanding how costs are calculated.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        execute: async () => {
+            const config = await api.getPricingConfig();
+            return JSON.stringify(config, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=pricing.js.map

package/dist/tools/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/tools/pricing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,oBAAoB,CAAC,MAAe,EAAE,GAAoB;IACxE,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,+KAA+K;QACjL,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CAAC,sCAAsC,CAAC;YACnD,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,0EAA0E,CAAC;YACvF,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,oIAAoI;QACtI,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/responses.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerResponseTools(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=responses.d.ts.map

package/dist/tools/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/tools/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,QAwC1E"}

package/dist/tools/responses.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export function registerResponseTools(server, api) {
+    server.addTool({
+        name: "get_responses",
+        description: "Export survey response data with pagination. Returns individual responses including answer data, metadata, and completion status. Only returns responses from published (launched) surveys. Default filter is 'complete' responses only. Duplicate respondents are excluded by default; set includeDuplicates=true to include them. Each response includes a supplier field indicating the panel source. Metadata includes device info (userAgent, screenSize, timezone, language), geographic data (city, state, country), and provider demographics when available.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        parameters: z.object({
+            surveyId: z
+                .string()
+                .uuid()
+                .describe("Survey ID to export responses for"),
+            page: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Page number (default 1)"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(1000)
+                .optional()
+                .describe("Results per page (default 100, max 1000)"),
+            status: z
+                .enum(["complete", "partial", "incomplete"])
+                .optional()
+                .describe("Filter by response status (default: complete)"),
+            includeDuplicates: z
+                .boolean()
+                .optional()
+                .describe("Include duplicate/flagged responses (default: false). By default, responses flagged as duplicates are excluded for clean data export."),
+        }),
+        execute: async ({ surveyId, ...params }) => {
+            const result = await api.getResponses(surveyId, params);
+            return JSON.stringify(result, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=responses.js.map

package/dist/tools/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/tools/responses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,GAAoB;IACzE,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,uiBAAuiB;QACziB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,QAAQ,CAAC,mCAAmC,CAAC;YAChD,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,yBAAyB,CAAC;YACtC,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,0CAA0C,CAAC;YACvD,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;iBAC3C,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,iBAAiB,EAAE,CAAC;iBACjB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,uIAAuI,CACxI;SACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE;YACzC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/surveys.d.ts

@@ -0,0 +1,4 @@
+import type { FastMCP } from "fastmcp";
+import type { ChorusApiClient } from "../client.js";
+export declare function registerSurveyTools(server: FastMCP, api: ChorusApiClient): void;
+//# sourceMappingURL=surveys.d.ts.map

package/dist/tools/surveys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surveys.d.ts","sourceRoot":"","sources":["../../src/tools/surveys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,QA8ExE"}

package/dist/tools/surveys.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+export function registerSurveyTools(server, api) {
+    server.addTool({
+        name: "list_surveys",
+        description: "List surveys with optional filtering by status and pagination. Returns survey metadata (id, name, status, dates) but not the full JSON.",
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
+        parameters: z.object({
+            status: z
+                .enum(["draft", "live", "complete", "cancelled"])
+                .optional()
+                .describe("Filter by survey status"),
+            page: z.number().int().positive().optional().describe("Page number (default 1)"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Results per page (default 20, max 100)"),
+            sort: z
+                .enum(["createdAt", "updatedAt", "name"])
+                .optional()
+                .describe("Sort field"),
+            order: z.enum(["asc", "desc"]).optional().describe("Sort order"),
+        }),
+        execute: async (args) => {
+            const result = await api.listSurveys(args);
+            return JSON.stringify(result, null, 2);
+        },
+    });
+    server.addTool({
+        name: "get_survey",
+        description: "Get full details of a specific survey including the complete JSON definition, status, and metadata.",
+        annotations: { readOnlyHint: true, destructiveHint: false },
+        parameters: z.object({
+            surveyId: z.string().uuid().describe("Survey ID (UUID)"),
+        }),
+        execute: async ({ surveyId }) => {
+            const survey = await api.getSurvey(surveyId);
+            return JSON.stringify(survey, null, 2);
+        },
+    });
+    server.addTool({
+        name: "create_survey",
+        description: "Create a new survey draft. Provide a name, the JSON definition, and a target number of completed responses. The survey will be created in 'draft' status.",
+        annotations: { readOnlyHint: false, destructiveHint: false },
+        parameters: z.object({
+            name: z
+                .string()
+                .min(1)
+                .max(255)
+                .describe("Survey name (1-255 characters)"),
+            survey: z
+                .record(z.unknown())
+                .describe("JSON definition. Must include `pages` array with question elements."),
+            targetCompletes: z
+                .number()
+                .int()
+                .min(0)
+                .max(5000)
+                .describe("Target number of completed responses (0-5000, raise min for production)"),
+            description: z
+                .string()
+                .max(1000)
+                .optional()
+                .describe("Optional survey description (max 1000 chars)"),
+        }),
+        execute: async (args) => {
+            const survey = await api.createSurvey(args);
+            return JSON.stringify(survey, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=surveys.js.map

package/dist/tools/surveys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surveys.js","sourceRoot":"","sources":["../../src/tools/surveys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,mBAAmB,CAAC,MAAe,EAAE,GAAoB;IACvE,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAChF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;iBAChD,QAAQ,EAAE;iBACV,QAAQ,CAAC,yBAAyB,CAAC;YACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAChF,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wCAAwC,CAAC;YACrD,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;iBACxC,QAAQ,EAAE;iBACV,QAAQ,CAAC,YAAY,CAAC;YACzB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACjE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACzD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,2JAA2J;QAC7J,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;QAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,gCAAgC,CAAC;YAC7C,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;iBACnB,QAAQ,CACP,qEAAqE,CACtE;YACH,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,yEAAyE,CAAC;YACtF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,8CAA8C,CAAC;SAC5D,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@chorus-research/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Chorus Research survey platform",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "chorus-research-mcp": "dist/index.js",
+    "chorus-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "inspect": "npx fastmcp inspect src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "fastmcp": "^3.34.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mcp",
+    "survey",
+    "research",
+    "chorus"
+  ],
+  "license": "Proprietary"
+}