OriginalVoices MCP Server

1# OriginalVoices MCP Server
2 
3[![npm version](https://img.shields.io/npm/v/@originalvoices/mcp-server.svg)](https://www.npmjs.com/package/@originalvoices/mcp-server)
4 
5An MCP (Model Context Protocol) server that provides access to [OriginalVoices](https://originalvoices.ai) AI twins for audience research.
6 
7## Installation
8 
9```bash
10npm install @originalvoices/mcp-server
11```
12 
13## Configuration
14 
15### Environment Variables
16 
17| Variable | Description | Required |
18|----------|-------------|----------|
19| `ORIGINALVOICES_API_KEY` | Your OriginalVoices API key | Yes |
20 
21### Claude Desktop
22 
23Add to your `claude_desktop_config.json`:
24 
25```json
26{
27  "mcpServers": {
28    "originalvoices": {
29      "command": "npx",
30      "args": ["@originalvoices/mcp-server"],
31      "env": {
32        "ORIGINALVOICES_API_KEY": "your-api-key"
33      }
34    }
35  }
36}
37```
38 
39### From Source
40 
41```json
42{
43  "mcpServers": {
44    "originalvoices": {
45      "command": "node",
46      "args": ["/path/to/ov-mcp-server/dist/index.js"],
47      "env": {
48        "ORIGINALVOICES_API_KEY": "your-api-key"
49      }
50    }
51  }
52}
53```
54 
55## Tools
56 
57### ask_twins
58 
59Ask questions to a specific audience using OriginalVoices AI twins.
60 
61**Parameters:**
62 
63| Name | Type | Description |
64|------|------|-------------|
65| `audience` | string | Description of the audience |
66| `questions` | string[] | Array of questions to ask the audience |
67 
68**Example:**
69 
70```json
71{
72  "audience": "UK, 18-30, fitness enthusiasts",
73  "questions": [
74    "When purchasing running shoes, what's most important to you?",
75    "How often do you replace your running shoes?"
76  ]
77}
78```
79 
80## Development
81 
82```bash
83# Install dependencies
84npm install
85 
86# Build
87npm run build
88 
89# Watch mode
90npm run dev
91```
92 
93## FAQ
94 
95### How do I get an API key?
96 
97You can create an API key on the [OriginalVoices Platform](https://platform.originalvoices.ai).
98 
99## License
100 
101MIT
102