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

| Variable | Description | Required | |----------|-------------|----------| | ORIGINALVOICES_API_KEY | Your OriginalVoices API key | Yes |

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:

| Name | Type | Description | |------|------|-------------| | audience | string | Description of the audience | | questions | string[] | 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