open-voc

Voice of Customer (VoC) MCP Plugin for AI Agents - Auto-record and analyze user feedback.

Features

• Auto-record: Automatically detects and records user feedback
• NPS Classification: Promoter / Passive / Detractor
• Feedback Types: Feature Request / Bug Report / UX Feedback / Preference / Suggestion
• Value Scoring: 1-10 score based on importance, feasibility, and business impact
• MCP Tools: voc_record, voc_report, voc_stats, voc_utterances

Requirements

• Node.js >= 18
• bun or npm
• OpenCode >= 1.0.150

Installation

For Humans

Tell your LLM agent:

Install open-voc plugin for OpenCode

For LLM Agents

1. Clone or copy the project:

git clone https://github.com/normdist-ai/open-voc.git
cd open-voc

2. Build the plugin:

bun install
bun run build

3. Add to OpenCode config (~/.config/opencode/opencode.json):

{
  "plugins": ["open-voc"]
}

4. Restart OpenCode

Usage

The plugin exposes MCP tools. Use them to record and analyze feedback:

Record Feedback

{
  "tool": "voc_record",
  "arguments": {
    "text": "User feedback text",
    "session_id": "session-123"
  }
}

Get Statistics

{
  "tool": "voc_stats"
}

Get Full Report

{
  "tool": "voc_report"
}

Trigger Keywords

The skill automatically detects feedback using these keywords:

Category	Keywords
Feedback	I think, I hope, suggest
Requirements	need, want, could you
Problems	bug, error, broken, fail
Preferences	like, dislike, prefer

Output Format

Recorded feedback includes:

Field	Description
nps_sentiment	promoter / passive / detractor
feedback_type	Feature Request / Bug Report / UX Feedback / Preference / Suggestion
value_score	1-10 based on importance + feasibility + impact
rating	🏆 Extremely High / ⭐ High / 🌟 Medium / 💡 Low / 📝 Informational

Data Storage

Per-project: {project}/.voc/utterances.jsonl

Skill: ~/.agents/skills/open-voc/voc-log.jsonl

License

SUL-1.0