Inquira Agent Plugin

Let your AI agent create, publish, and analyze surveys with Inquira — an AI-powered survey platform. This repo packages Inquira's remote MCP (Model Context Protocol) server as a plugin for OpenAI Codex, plus drop-in configs for Claude, Cursor, and any MCP-compatible client.

Inquira is published in the official MCP Registry as com.getinquira/inquira.

What is Inquira?

Inquira turns a one-sentence research goal into a professional survey, collects responses through a shareable link, and generates an AI analysis report — executive summary, key metrics, per-question insights, and prioritized recommendations. Through this plugin, an agent can do all of that for you in natural language.

Ask your agent things like:

"Create a customer satisfaction survey for our SaaS onboarding and publish it"
"Create a 10-question NPS survey in Japanese and give me the link"
"Show me the responses for my latest survey"
"Generate an AI analysis report for my survey"

Requirements

An Inquira account (the free plan works)
An Inquira API key — in the app, open Developer from your account menu and create a key (keys look like sk-inquira-...)
An agent with MCP or plugin support (Codex, Claude Desktop, Cursor, …)

Available tools

Tool	Description
`create_survey`	Generate a professional survey from a research goal with AI (5 languages, optional auto-publish). Returns the survey ID and shareable link.
`get_surveys`	List the surveys belonging to your account (filter by status).
`publish_survey`	Publish a draft survey so it accepts responses via its share link.
`get_survey_link`	Get the shareable link for a published survey.
`get_responses`	Fetch the responses submitted to a survey.
`get_ai_report`	Generate an AI analysis report: executive summary, key metrics, per-question insights, and action recommendations.

Full MCP & API documentation: https://getinquira.com/docs/mcp

Install

Codex (as a plugin)

Clone this repository (or point Codex at the repo URL if your version supports installing plugins from a URL).
Open inquira/.mcp.json and replace YOUR_INQUIRA_API_KEY with your key. Treat your local copy as private — never commit a real key. For a keyless setup, use the plain-MCP install below.
Install the ./inquira plugin folder in Codex.

Codex (plain MCP, no plugin)

1. Store your API key as an environment variable so it stays 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"

2. Add to ~/.codex/config.toml (or a project-scoped .codex/config.toml), then 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, fall back to an inline header (less safe — the key lives in the config file):

http_headers = { Authorization = "Bearer sk-inquira-..." }

Claude Desktop / Cursor / other MCP clients

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

What's in this repo

.agents/plugins/marketplace.json     Marketplace manifest
inquira/
  .codex-plugin/plugin.json          Plugin metadata
  .mcp.json                          MCP server config (add your API key here)
  assets/logo.png                    Logo
  skills/                            Workflow skills for the agent

How it works

The plugin points your agent at Inquira's remote MCP server over Streamable HTTP at https://getinquira.com/api/mcp. Every request carries your API key as an Authorization: Bearer header. The server exposes the six tools above; your agent calls them to create, publish, and analyze surveys on your Inquira account.

License

MIT