MCP Server Documentation

What is this?

The Model Context Protocol is an open standard that lets AI assistants securely call tools and read data from external systems. Votira's MCP server exposes read tools so an assistant can answer questions about your surveys and respondents on your behalf.

Authentication

Generate a single MCP access key in Settings (one key per account). It is shown only once. Present it as a Bearer token on the MCP endpoint:

Authorization: Bearer vot_mcp_xxxxxxxxxxxxxxxx

You can rotate or delete the key at any time; rotation immediately invalidates the previous secret.

Client configuration

Point any MCP client that supports the streamable HTTP transport at the endpoint. Example client config:

{
  "mcpServers": {
    "votira": {
      "url": "https://votira.co/mcp",
      "headers": { "Authorization": "Bearer vot_mcp_xxxxxxxx" }
    }
  }
}

Available tools

Tool	Arguments	Returns
`list_surveys`	—	Your surveys with id, title, status and response count.
`get_survey`	`survey_id`	A survey with its questions and settings.
`get_survey_responses`	`survey_id`, `limit?`, `offset?`	Paginated responses for a survey.
`get_survey_analysis`	`survey_id`	Cached whole-survey and per-question AI analysis.

Protocol methods

The endpoint implements the core MCP JSON‑RPC methods: initialize, tools/list and tools/call (plus ping). Example tool listing:

curl -X POST https://votira.co/mcp \
  -H "Authorization: Bearer $VOTIRA_MCP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

curl -X POST https://votira.co/mcp \
  -H "Authorization: Bearer $VOTIRA_MCP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_survey","arguments":{"survey_id":"srv_123"}}}'

Security & limits

Tools are read-only and always scoped to the key owner's own data.
An inactive account plan returns 403 Forbidden.
The endpoint is rate limited (600 requests/hour per client).
No personally identifiable information is written to server logs.