io.github.ovlabs/originalvoices MCP Server

An MCP (Model Context Protocol) server that provides access to OriginalVoices AI twins for audience research. The server is designed to ask AI twins questions about any audience, using an OriginalVoices API key for authentication.

🛠️ Key Features

Access to OriginalVoices AI twins
Supports asking AI twins questions for audience research
MCP server for audience research workflows
Package: @originalvoices/mcp-server

🚀 Use Cases

Audience research using AI twins
Q&A for understanding audience needs and perspectives

⚡ Developer Benefits

Standard MCP server interface for model integrations
Simple installation via npm: npm install @originalvoices/mcp-server
Uses ORIGINALVOICES_API_KEY for required configuration

⚠️ Limitations

Requires the ORIGINALVOICES_API_KEY environment variable (marked required)
Additional configuration details (e.g., Claude Desktop setup) are only partially included in the provided source text

Configuration

Environment Variables

Variable

Description

Required

ORIGINALVOICES_API_KEY

Your OriginalVoices API key

Yes

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "originalvoices": {
      "command": "npx",
      "args": ["@originalvoices/mcp-server"],
      "env": {
        "ORIGINALVOICES_API_KEY": "your-api-key"
      }
    }
  }
}

From Source

json

{
  "mcpServers": {
    "originalvoices": {
      "command": "node",
      "args": ["/path/to/ov-mcp-server/dist/index.js"],
      "env": {
        "ORIGINALVOICES_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

ask_twins

Ask questions to a specific audience using OriginalVoices AI twins.

Parameters:

Name

Type

Description

audience

string

Description of the audience

questions

string[]

Array of questions to ask the audience

Example:

json

{
  "audience": "UK, 18-30, fitness enthusiasts",
  "questions": [
    "When purchasing running shoes, what's most important to you?",
    "How often do you replace your running shoes?"
  ]
}

io.github.ovlabs/originalvoices