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, …)
| 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"
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
License
MIT