mcp -originalvoices

This MCP server provides access to OriginalVoices AI twins for audience research, enabling you to pose questions to specific audience segments and gather insights. The server exposes the ask_twins capability, which allows you to send a clearly defined audience description along with a list of questions to prompt the OriginalVoices twins. Use cases include market research, product feedback sessions, and understanding audience preferences by querying generated perspectives from AI twins that represent a target demographic. To run, configure the server with your API key and start it through your preferred launcher (for example via npx or by running the built server script). Once active, you can call the ask_twins tool with parameters like audience descriptors and an array of questions to collect responses from the AI twins.

Prerequisites:

• Node.js and npm installed on your machine
• Access to OriginalVoices API key

Installation steps (npm package):

1. Install the MCP server package: npm install @originalvoices/mcp-server
2. Set up your environment with your API key (examples shown below in the mcp_config section): Create a configuration file or environment variables to supply ORIGINALVOICES_API_KEY.
3. Start the server using your preferred method (see configuration examples below).

Alternative run via npx (no local install):

1. Run the MCP server directly with npx, which uses the package registry to launch the server: npx @originalvoices/mcp-server
2. Ensure ORIGINALVOICES_API_KEY is available in the environment when starting the server.
3. Connect to the running MCP server endpoint as documented in your integration environment (e.g., Claude Desktop or your own client).

Environment variable: ORIGINALVOICES_API_KEY is required and should be kept secure. If using Claude Desktop, you can add the server under mcpServers with command npx and args ["@originalvoices/mcp-server"] and supply the API key via env. Keep in mind API rate limits and potential costs from OriginalVoices. If you deploy locally via node, you may need to point to the built distribution path (e.g., dist/index.js) as shown in the from-source example. Ensure your deployment environment allows outbound API calls to OriginalVoices endpoints. If you encounter connectivity or authentication issues, verify that the API key is correct and that the environment has network access to OriginalVoices services.