⟡ MCP Server

MCP Documentation

Connect Inquira to Claude Desktop, Cursor, OpenAI Codex, or any MCP-compatible AI assistant. Create surveys, collect responses, and generate AI reports — all through natural language.

Authentication

All requests require a valid Inquira API key in the Authorization header. Get your key from Dashboard → Developer.

Authorization: Bearer sk-inquira-xxxxxxxxxxxxxxxx

Claude Desktop Setup

Add this to ~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "inquira": {
      "url": "https://getinquira.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor Setup

Add this to ~/.cursor/mcp.json

{
  "mcpServers": {
    "inquira": {
      "url": "https://getinquira.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

OpenAI Codex Setup

First, save your API key as an environment variable — this keeps it out of config files and chat logs:

# Windows (PowerShell) — then restart your terminal:
setx INQUIRA_API_KEY "sk-inquira-xxxxxxxxxxxxxxxx"

# macOS / Linux — add to your shell profile:
export INQUIRA_API_KEY="sk-inquira-xxxxxxxxxxxxxxxx"

Then add this to ~/.codex/config.toml (or a project-scoped .codex/config.toml) and restart Codex:

[mcp_servers.inquira]
url = "https://getinquira.com/api/mcp"
bearer_token_env_var = "INQUIRA_API_KEY"

If your Codex version doesn't support bearer_token_env_var, use http_headers = { Authorization = "Bearer sk-inquira-..." } instead.

Example Usage

// In Claude Desktop, Cursor, or Codex, just say:
"Create a customer satisfaction survey for our SaaS
product onboarding and publish it"

"Show me the responses for survey abc1234"

"Generate an AI analysis report for my latest survey"

"Create a 10-question NPS survey in Japanese and give me the link"

Available Tools

create_survey

Generate a professional survey using AI from a research goal.

Parameter	Type	Required	Description
`goal`	`string`	required	Describe what you want to research
`lang`	`en \| zh \| ja \| es \| pt`	optional	Survey language (default: en)
`publish`	`boolean`	optional	Auto-publish after creation (default: false)

create_survey(
  goal: "Customer satisfaction survey for our SaaS onboarding",
  lang: "en",
  publish: true
)

get_surveys

List all surveys belonging to the authenticated user.

Parameter	Type	Required	Description
`status`	`all \| published \| draft`	optional	Filter by status (default: all)

get_surveys(status: "published")

get_responses

Get all responses submitted to a specific survey.

Parameter	Type	Required	Description
`survey_id`	`string`	required	The survey ID

get_responses(survey_id: "abc1234")

get_ai_report

Generate an AI analysis report for a survey's responses. Returns executive summary, key metrics, insights, and action recommendations.

Parameter	Type	Required	Description
`survey_id`	`string`	required	The survey ID to analyze

get_ai_report(survey_id: "abc1234")

publish_survey

Publish a survey to make it accessible via its share link.

Parameter	Type	Required	Description
`survey_id`	`string`	required	The survey ID to publish

publish_survey(survey_id: "abc1234")

get_survey_link

Get the shareable link for a published survey.

Parameter	Type	Required	Description
`survey_id`	`string`	required	The survey ID

get_survey_link(survey_id: "abc1234")

Rate Limits & Quotas

Rate limit

60 req / min

Per API key

Free · total

100 req / month

Resets monthly

Free · create_survey

3 / month

Matches survey limit

Free · get_ai_report

Not available

Pro only

Pro · total

10,000 req / month

Resets monthly

Pro · all tools

Unlimited

No per-tool limits