Inquira
AI survey platform: create and publish surveys, collect responses, generate AI analysis reports.
Open source Repository Open in the app JSON README (API)
About
AI survey platform: create and publish surveys, collect responses, generate AI analysis reports.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- com.getinquira
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.1
- Last push
- 2026-07-16T05:11:15Z
- Repository state
- ativo
- Added
- 2026-08-29 03:01:08
- Updated
- 2026-08-29 03:01:08
- Origin id
com.getinquira/inquira
README
# Inquira Agent Plugin
Let your AI agent create, publish, and analyze surveys with **[Inquira](https://getinquira.com)** — 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`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.getinquira).
## 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](https://getinquira.com) 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:
```powershell
# Windows (PowerShell) — then restart your terminal:
setx INQUIRA_API_KEY "sk-inquira-xxxxxxxxxxxxxxxx"
```
```bash
# 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:
```toml
[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):
```toml
http_headers = { Authorization = "Bearer sk-inquira-..." }
```
### Claude Desktop / Cursor / other MCP clients
```json
{
"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