MCP server

OriginalVoices runs a hosted Model Context Protocol server. Any MCP client or agent framework can connect to it. For Claude, ChatGPT, Cursor and other assistants, follow Connect your assistant instead.

https://api.originalvoices.ai/mcp

It uses the Streamable HTTP transport. Authenticate with either:

• An API key: X-Api-Key: YOUR_API_KEY
• OAuth: Authorization: Bearer ACCESS_TOKEN, for clients that sign in with OAuth.

{
  "mcpServers": {
    "originalvoices": {
      "type": "http",
      "url": "https://api.originalvoices.ai/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

Tools

ask_twins

Ask up to 15 questions to Digital Twins. Pass exactly one of audience, audienceId or studyId.

Parameter	Type	Description
questions	array, required	1–15 questions. A string is an open question. { question, choices, multiple? } is a choice question with 2–20 options.
audience	string	Who to ask, in plain words, e.g. "Women aged 35-55 in the US and UK".
audienceId	string	A saved audience from list_audiences.
studyId	string	A study from list_studies. Its participants answer.
filter	string	Only with studyId: free text that narrows participants, e.g. "said price was the main barrier".
sampleSize	integer	How many participants to ask.

{
  "audience": "UK, 18-30, fitness enthusiasts",
  "questions": [
    { "question": "Which matters most in a running shoe?", "choices": ["Price", "Comfort", "Style"] },
    "Why did you pick that?"
  ]
}

It returns each Twin's answers with a low, medium or high confidence, plus a count and percentage per option for choice questions. Billing is per answer, as with the API.

list_audiences

Lists the saved audiences your organisation can ask. Pass an id from the result to ask_twins as audienceId.

list_studies

Lists your organisation's finished studies, with participant counts and questions. Pass an id from the result to ask_twins as studyId.

Local server (npm)

For clients that only support stdio, @originalvoices/mcp-server runs the same three tools locally:

{
  "mcpServers": {
    "originalvoices": {
      "command": "npx",
      "args": ["@originalvoices/mcp-server"],
      "env": { "ORIGINALVOICES_API_KEY": "your-api-key" }
    }
  }
}

Prefer the hosted server where your client supports it: there's nothing to install or update.

GitHub