# Inquira

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/BayarBH/inquira-agent-plugin  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/inquira

## Description
AI survey platform: create and publish surveys, collect responses, generate AI analysis reports.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "inquira": {
    "command": "npx",
    "args": ["-y","inquira"]
  }
}
```

## Documentation & 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