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)

1. Clone this repository (or point Codex at the repo URL if your version supports installing plugins from a URL).
2. 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.
3. 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.

Links

• Website: https://getinquira.com
• MCP & API docs: https://getinquira.com/docs/mcp
• Guide — connect Inquira to Claude: https://getinquira.com/guides/connect-inquira-to-claude-mcp
• Official MCP Registry entry: com.getinquira/inquira

License

MIT