@wokuapp/ai-toolkit 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "woku-ai-toolkit",
+  "owner": {
+    "name": "woku"
+  },
+  "metadata": {
+    "description": "The woku AI Toolkit: connect your agent to woku's voice-of-customer platform"
+  },
+  "plugins": [
+    {
+      "name": "woku",
+      "source": "./",
+      "description": "Design a listening program for your customer journey, run the VoC instruments (NPS, CSAT, CES, wokus), and turn every signal into a support ticket or an action plan, through woku's MCP server.",
+      "version": "0.1.0",
+      "author": { "name": "woku" },
+      "license": "MIT",
+      "homepage": "https://woku.app",
+      "keywords": ["woku", "mcp", "voice-of-customer", "cx", "nps", "csat", "ces", "surveys", "feedback"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "woku",
+  "description": "Voice-of-customer for Claude Code. Design a listening program for your customer journey, run the fast VoC instruments (NPS, CSAT, CES, wokus), and turn every signal into a support ticket or an action plan, through woku's MCP server. Bundles the woku method so the agent acts as a CX consultant.",
+  "version": "0.1.0",
+  "author": { "name": "woku" },
+  "homepage": "https://woku.app",
+  "license": "MIT",
+  "keywords": ["woku", "mcp", "voice-of-customer", "cx", "nps", "csat", "ces", "surveys", "feedback"]
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "woku",
+  "version": "0.1.0",
+  "description": "Voice-of-customer for OpenAI Codex. Design a listening program, run the VoC instruments (NPS, CSAT, CES, wokus), and turn every signal into a support ticket or an action plan, through woku's MCP server.",
+  "author": { "name": "woku" },
+  "homepage": "https://docs.woku.app/mcp/agent-guide",
+  "repository": "https://github.com/wokuApp/woku-ai-toolkit",
+  "license": "MIT",
+  "keywords": ["woku", "voice-of-customer", "cx", "nps", "csat", "ces", "surveys", "feedback"],
+  "skills": "./skills/",
+  "mcpServers": {
+    "woku": {
+      "type": "http",
+      "url": "https://api.woku.app/mcp"
+    }
+  },
+  "interface": {
+    "displayName": "woku",
+    "shortDescription": "Turn customer feedback into tickets and action plans.",
+    "longDescription": "Connect your agent to woku, the voice-of-customer platform. Design a listening program for your customer journey, place the fast VoC instruments (NPS, CSAT, CES, wokus) at each moment of truth, and turn every signal into a support ticket or an action plan.",
+    "developerName": "woku",
+    "category": "Productivity",
+    "capabilities": ["Read", "Write"],
+    "websiteURL": "https://woku.app",
+    "privacyPolicyURL": "https://woku.app/privacy-policy",
+    "termsOfServiceURL": "https://woku.app/terms-and-conditions",
+    "defaultPrompt": [
+      "How do I start listening to my customers?",
+      "Design a VoC program for my customer journey",
+      "How is my NPS, and should I open an action plan?"
+    ]
+  }
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "woku": {
+      "type": "http",
+      "url": "https://api.woku.app/mcp"
+    }
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+Initial release. Bundles woku's MCP server connection (`https://api.woku.app/mcp`) and the woku skill (the woku method plus the `woku_guide` / `design_voc_program` entry points). Plugin manifests for Claude Code (`.claude-plugin/`), Codex (`.codex-plugin/`), OpenClaw (`openclaw.plugin.json`) and Pi (`package.json`). OpenCode, claude.ai and ChatGPT connect to the MCP server through their own configuration.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 woku
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+# woku AI Toolkit
+
+Connect your AI agent to [woku](https://woku.app), the voice-of-customer platform.
+
+The toolkit gives your agent woku's full tool catalog through woku's MCP server, plus the woku method so it acts as a customer-experience consultant: design a listening program for your customer journey, place the fast VoC instruments (NPS, CSAT, CES, wokus) at each moment of truth, and turn every signal into a support ticket or an action plan.
+
+It bundles:
+
+- The **woku MCP server** connection (`https://api.woku.app/mcp`), so the agent gets the full catalog (143 tools) with woku's OAuth. No API keys to copy.
+- The **woku skill**, which primes the agent with the method and tells it to call `woku_guide` first.
+
+## Install
+
+### Claude Code
+
+Add woku's marketplace, then install the plugin. This ships both the MCP server and the skill:
+
+```
+/plugin marketplace add wokuApp/woku-ai-toolkit
+/plugin install woku@woku-ai-toolkit
+```
+
+Once the toolkit is accepted into the official marketplace, `/plugin install woku@claude-plugins-official` also works.
+
+### OpenAI Codex
+
+Add the woku MCP server to `~/.codex/config.toml` and authenticate:
+
+```toml
+[mcp_servers.woku]
+url = "https://api.woku.app/mcp"
+```
+
+```
+codex mcp login woku
+```
+
+`auth = "oauth"` is the default for a bare `url`, so Codex opens the browser to complete woku's OAuth. Check it with `codex mcp list`.
+
+### OpenCode
+
+Add the woku MCP server to your `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "woku": {
+      "type": "remote",
+      "url": "https://api.woku.app/mcp",
+      "enabled": true
+    }
+  }
+}
+```
+
+OpenCode runs OAuth automatically on the first authenticated call. To start the login yourself, run `opencode mcp auth woku`.
+
+### OpenClaw
+
+Install the plugin (this ships the woku skill):
+
+```
+openclaw plugins install git:github.com/wokuApp/woku-ai-toolkit
+```
+
+OpenClaw's plugin manifest declares local MCP servers only, so add woku's remote MCP server (`https://api.woku.app/mcp`) through your OpenClaw MCP configuration.
+
+### Pi
+
+The package exposes the woku skill through Pi's `pi` package convention. Install `@wokuapp/ai-toolkit` from npm in your project and Pi loads the skill. Add woku's MCP server (`https://api.woku.app/mcp`) through Pi's MCP configuration.
+
+### claude.ai and ChatGPT
+
+These are configured from the app, not from a package. Add a custom connector (claude.ai) or a developer-mode connector (ChatGPT) with the URL `https://api.woku.app/mcp`.
+
+### Any other MCP client
+
+Point it at `https://api.woku.app/mcp` and approve access from your woku account.
+
+See the [connect guide](https://docs.woku.app/mcp/connect-a-client) and the [agent guide](https://docs.woku.app/mcp/agent-guide) for details.
+
+## What you get
+
+Once connected, ask your agent things like:
+
+- "I run an ecommerce, how do I start listening to my customers with woku?"
+- "Design a VoC program for my customer journey."
+- "How is my NPS this month, and should I open an action plan?"
+- "Summarize last week's reviews and the top improvement themes."
+
+Every connection is bound to one company, chosen when you approve access. Read tools need no special permission; write tools require the `mcp:write` scope, and destructive tools or sends require an explicit confirmation.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/openclaw.plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "woku-ai-toolkit",
+  "name": "woku AI Toolkit",
+  "description": "Voice-of-customer for your agent. Design a listening program, run the VoC instruments (NPS, CSAT, CES, wokus), and turn every signal into a support ticket or an action plan, through woku's MCP server.",
+  "version": "0.1.0",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@wokuapp/ai-toolkit",
+  "version": "0.1.0",
+  "description": "woku AI Toolkit: connect your agent to woku's voice-of-customer platform. Design VoC programs and turn customer feedback into support tickets and action plans, through woku's MCP server.",
+  "author": "woku",
+  "license": "MIT",
+  "homepage": "https://docs.woku.app/mcp/agent-guide",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wokuApp/woku-ai-toolkit"
+  },
+  "keywords": [
+    "woku",
+    "mcp",
+    "voice-of-customer",
+    "cx",
+    "nps",
+    "csat",
+    "ces",
+    "surveys",
+    "feedback",
+    "plugin",
+    "pi-package"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "skills",
+    ".mcp.json",
+    ".claude-plugin",
+    ".codex-plugin",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  }
+}

package/skills/woku/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: woku
+description: "Use woku to protect revenue with the voice of the customer. Use when the user wants to set up customer feedback or listening, design a Voice-of-Customer program, place surveys (NPS, CSAT, CES) or wokus at moments of their customer journey, turn feedback into support tickets or action plans, or operate their woku account from the agent. Requires the woku MCP server connected (this toolkit declares it)."
+---
+
+# woku: voice-of-customer for your agent
+
+woku is a voice-of-customer platform. This toolkit connects your agent to woku's MCP server (`https://api.woku.app/mcp`), which exposes the full tool catalog plus two meta-tools that teach you how to use it. Act as a customer-experience consultant: help the user design their listening, do not just run commands.
+
+## Start here
+
+Before doing anything else, call the `woku_guide` tool. With no arguments it returns the method, the topic index, and the id-discovery rules; with a `topic` it returns a step-by-step playbook; with a `question` in natural language it picks the best playbook. Read it before calling other woku tools. If the tools are not available, tell the user to connect the woku MCP server (see this toolkit's README) and approve access.
+
+## The woku method
+
+Every business is a customer journey, and each moment of truth decides whether the customer returns or leaves. woku protects revenue with a simple idea:
+
+1. At each moment of truth, listen with a fast instrument (a rating plus a text or voice comment, under 60 seconds): NPS, CSAT, CES, or a woku.
+2. Every signal triggers an action. One signal becomes a support ticket (individual attention). Recurring signals across customers become an action plan (systematic improvement).
+3. Trackers are the connective tissue: they segment instruments by journey, moment, or locality, and that segmentation routes each ticket and groups each plan.
+
+## How to help
+
+1. To design a program, call `design_voc_program`. Pass what the user knows (business type, channels, their journey moments, how to segment) and it returns a blueprint: the recommended instrument per moment (from the canonical template: sale to CSAT, delivery to woku, support to CES, post-sale to woku, loyalty to NPS), the tracker design, the action wiring, and the ordered `create_*` steps to build it.
+2. Walk the blueprint with the user and adapt it to their real journey.
+3. Build it with the `create_*` tools once the user approves, and distribute the instruments with the `send_*` tools. Nothing is created or sent without an explicit confirmation.
+4. From then on, let every signal trigger its action: tickets for individual attention, plans for systematic improvement.
+
+## Safety
+
+Read tools need no special permission. Write tools require the `mcp:write` scope, and destructive tools (for example `delete_woku`) or sends (for example `send_nps_invitations`, `send_report_now`) require `confirm: true`. The list the server advertises on a live connection (`tools/list`) is always the authoritative answer about what is available.