mcpField
O
originalvoices

originalvoices

Local
github.com/ovlabsBusiness & Marketing3Updated 30w ago
Repository

About originalvoices

OriginalVoices MCP Server connects AI assistants to OriginalVoices AI twins for audience research. It accepts an audience description and a set of questions, supporting structured inquiry into a defined group.

Key features

  1. 01Queries AI twins for a specified audience
  2. 02Accepts audience descriptions and question lists

Use cases

  1. 01Researching preferences of a defined audience
  2. 02Collecting responses to multiple audience questions

MCP support

Exposes the `ask_twins` tool to MCP clients, taking an audience description and questions and querying OriginalVoices AI twins. An OriginalVoices API key is required.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ovlabs-originalvoices": {
      "command": "npx",
      "args": [
        "-y",
        "@originalvoices/mcp-server"
      ]
    }
  }
}
Run commandnpx -y @originalvoices/mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@originalvoices/mcp-server1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.