English Français العربية

io.github.ovlabs/originalvoices

Official registry Other

Ask Digital Twins of real people about anything: open and choice questions, any audience.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http originalvoices 'https://api.originalvoices.ai/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "originalvoices": {
            "type": "http",
            "url": "https://api.originalvoices.ai/mcp"
        }
    }
}
NPM package @originalvoices/mcp-server
Claude Code 
claude mcp add originalvoices -- npx -y @originalvoices/mcp-server@2.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "originalvoices": {
            "command": "npx",
            "args": [
                "-y",
                "@originalvoices/mcp-server@2.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. OriginalVoices MCP Server
  2. Installation
  3. Configuration
  4. Tools
  5. Development
  6. FAQ
  7. License

OriginalVoices MCP Server

An MCP (Model Context Protocol) server that provides access to OriginalVoices AI twins for audience research.

Installation

npm install @originalvoices/mcp-server

Configuration

Environment Variables
VariableDescriptionRequired
ORIGINALVOICES_API_KEYYour OriginalVoices API keyYes
Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "originalvoices": {
      "command": "npx",
      "args": ["@originalvoices/mcp-server"],
      "env": {
        "ORIGINALVOICES_API_KEY": "your-api-key"
      }
    }
  }
}
From Source
{
  "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:

NameTypeDescription
audiencestringDescription of the audience
questionsstring[]Array of questions to ask the audience

Example:

{
  "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?"
  ]
}

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

FAQ

How do I get an API key?

You can create an API key on the OriginalVoices Platform.

License

MIT

Frequently asked questions

What is io.github.ovlabs/originalvoices?

Ask Digital Twins of real people about anything: open and choice questions, any audience.

How do I install io.github.ovlabs/originalvoices?

It runs as a remote server. In Claude Code: claude mcp add --transport http originalvoices 'https://api.originalvoices.ai/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ovlabs/originalvoices need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ovlabs/originalvoices open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.ovlabs/originalvoices?

It is published by ovlabs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.