Back to MCP Servers

Server Originalvoices

Instantly understand what real users think and why by querying our network of 1:1 Digital Twins - each representing a real person. Give your AI agents authentic human context to ground outputs, improve creative, and make smarter decisions.

researchaiagent
By ovlabs
22Updated 3 months agoJavaScript

Installation

npx -y mcp-server-originalvoices

Configuration

{
  "mcpServers": {
    "mcp-server-originalvoices": {
      "command": "npx",
      "args": ["-y", "mcp-server-originalvoices"]
    }
  }
}

How to use

  1. Run the installation command above (if needed)
  2. Open your Claude Code settings file (~/.claude/settings.json)
  3. Add the configuration to the mcpServers section
  4. Restart Claude Code to apply changes

OriginalVoices MCP Server

npm version

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

View source on GitHub