mobopinions-survey-mcp

# MobOpinions Survey Light — MCP server

**Run consumer surveys from your AI assistant.** Every action in [Survey Light](https://surveys.mobopinions.com) (MobOpinions' self-service survey platform) is exposed as a [Model Context Protocol](https://modelcontextprotocol.io) tool, so Claude, ChatGPT, Cursor, VS Code or any MCP client can create a survey, write the questions, target a real consumer audience through the MobOpinions panel network, launch it and read the results — inside your own MobOpinions workspace.

Registry name: `com.mobopinions/survey-light` · Remote server (no install) · License: MIT

| | |
|---|---|
| Endpoint | `https://surveys.mobopinions.com/light-api/mcp` |
| Transport | Streamable HTTP (MCP 2025-06-18), stateless JSON responses |
| Auth | OAuth 2.1 — RFC 9728/8414 discovery, RFC 7591 dynamic registration, PKCE S256, refresh tokens |
| Sign-in | your existing surveys.mobopinions.com email + password |
| Tools | 71 |

## Connect

**Claude Code**

```bash
claude mcp add --transport http surveys https://surveys.mobopinions.com/light-api/mcp
# then in a session: /mcp → surveys → Authenticate (browser login)
```

**Claude.ai / Claude Desktop** — Settings → Connectors → *Add custom connector* → URL `https://surveys.mobopinions.com/light-api/mcp` → Connect → sign in.

**ChatGPT** — Settings → Connectors → Create (developer mode) → MCP server URL `https://surveys.mobopinions.com/light-api/mcp`, authentication *OAuth* → sign in.

**Cursor / VS Code / any Streamable-HTTP + OAuth client** — `{ "mcpServers": { "surveys": { "url": "https://surveys.mobopinions.com/light-api/mcp" } } }`

There is no API key: the client discovers the authorization server, registers itself, opens the login page and stores the token. Tokens last 30 days and refresh automatically. Every tool runs with exactly the permissions of the signed-in user, in the workspace they select.

## What you can do

Ask your assistant things like:

- "Create a 6-question survey about oat-milk buying habits for 300 UK adults aged 25–44 and launch it."
- "Add a screener so only people who bought running shoes in the last 6 months qualify."
- "How many completes do we have on the Berlin survey, and what's the top answer to question 3?"
- "Export the results as an Excel file and pause the survey."

## Tools (71)

### Account & workspaces (12)

| Tool | What it does |
|---|---|
| `get_profile` | Who am I: the linked account (user id, email, display name), the workspaces |
| `get_account` | Account card: full name, email, Survey Light workspaces (id, name, role, |
| `update_account` | Set the account's full name and optionally rename the ACTIVE workspace. |
| `list_workspaces` | My Survey Light workspaces plus the id of the one this session is switched to. |
| `switch_workspace` | Make a workspace the active one for this session. Surveys, wallet and |
| `create_workspace` | Create a new Survey Light workspace (you become its owner) and switch to it. |
| `rename_workspace` | Rename a workspace you own. |
| `list_workspace_members` | Members (user id, email, role) and pending invitations of a workspace you own. |
| `invite_workspace_member` | Email an invitation to join a workspace you own (link valid 7 days). |
| `remove_workspace_member` | Remove a user from a workspace you own. Confirm with the user first. |
| `cancel_workspace_invitation` | Revoke a pending workspace invitation. |
| `accept_workspace_invitation` | Redeem a workspace invitation token (from the invitation email) for the |

### Surveys (16)

| Tool | What it does |
|---|---|
| `get_survey_options` | Reference lists for creating a survey: countries available for fielding |
| `list_surveys` | Surveys in the active workspace (newest first, max 300) with status |
| `create_survey` | Create an empty draft survey in the active workspace. Then add questions |
| `suggest_survey_topic` | AI-pick the best topic category (from get_survey_options.categories) for a research question. |
| `create_survey_from_question` | Build a complete survey (questions, screeners, skip logic, images) from ONE |
| `create_survey_from_template` | Create a new draft by copying a template survey (a survey marked with |
| `clone_survey` | Deep-copy a survey (questions, answers, targeting, skip logic) into a new draft. |
| `translate_survey` | Clone a survey once per language and machine-translate every question and |
| `set_survey_template_flag` | Mark (or unmark) a survey as a reusable workspace template. |
| `preview_survey` | Get a respondent-view preview link for a survey and mark it as tested. |
| `pause_survey` | Pause a live survey (stops collecting; funds stay reserved). Resume with resume_survey. |
| `resume_survey` | Resume a paused survey that was previously launched. |
| `delete_survey` | Permanently delete a draft or closed survey with no completes. Live/paused |
| `get_survey_status` | Cheap liveness snapshot for a survey in field: status, is_live, accepted/ |
| `launch_survey` | Take a draft live: reserves the full project value from the wallet as a hold |
| `close_survey` | Close a running survey for good: stops fielding, charges accepted completes |

### Questions & answers (13)

| Tool | What it does |
|---|---|
| `list_questions` | The questionnaire: every question with type, text, answer options, matrix |
| `add_question` | Append a question with its answer options. single_select / multi_select / |
| `update_question` | Edit an existing question's text, mandatory flag, answer randomisation, |
| `delete_question` | Delete a question and its answers/statements. Irreversible. |
| `add_answer_option` | Add one answer option to a single_select / multi_select / ranking / matrix question. |
| `update_answer_option` | Change an answer option's text, flags, image or position. |
| `remove_answer_option` | Delete one answer option from a question. |
| `reorder_answer_options` | Set the display order of a question's answers by listing their codes in order. |
| `reorder_questions` | Set the order of the editable questions by listing their qids. Locked |
| `set_question_routing` | Skip logic for a single_select question: per answer code, jump to a later |
| `parse_questionnaire_document` | AI-parse a questionnaire document (PDF, DOCX, XLSX or CSV, max 20 MB) fetched |
| `get_complete_answers` | Full question-by-question answers of one complete (by location_id from list_completes). |
| `get_close_preview` | What closing would settle: accepted/rejected counts, held amount, charge and release-back. |

### Audience & targeting (14)

| Tool | What it does |
|---|---|
| `get_targeting` | Current audience: country, gender, age ranges, employment, education, |
| `set_targeting` | Replace the survey's demographic targeting (each list you pass REPLACES that |
| `convert_location_text` | Turn a free-text location description (e.g. 'Texas and Florida', 'Greater |
| `set_location_targeting` | Apply location targeting: EITHER an admin-area selection (assoc_type + values, |
| `list_quotas` | Quota cells of a survey with limit, filled, remaining and their conditions |
| `create_quota` | Cap how many completes a group may fill. Demographic cell: quota_type 'gender' |
| `update_quota` | Change a quota's limit (any cell) or name/descriptor (manual cells only). |
| `delete_quota` | Delete a manual quota cell (auto cells follow targeting — freeze them instead). |
| `freeze_auto_quota` | Freeze an auto-generated (targeting-derived) quota so it never fills and is |
| `add_quota_condition` | Add a (question, answer code) condition to a manual quota. A condition on a |
| `update_quota_condition` | Change the question and/or answer code of a quota condition. |
| `remove_quota_condition` | Remove one condition from a manual quota. |
| `split_quota_limits` | Spread the completes target across cells — e.g. scope 'gender' = 50/50 |
| `set_target_completes` | Change the target number of completes. In field, raising it reserves the |

### Launch & field (2)

| Tool | What it does |
|---|---|
| `finish_builder` | Call after editing questions: recomputes LOI from the final question count |
| `get_launch_summary` | Pre-launch check: final quote (question count, LOI, CPI, total), whether the |

### Results, insights & export (6)

| Tool | What it does |
|---|---|
| `get_results` | Per-question aggregates over accepted completes: counts and percentages for |
| `export_results_csv` | Raw respondent-level CSV: one row per complete (accepted and rejected), one column per question. |
| `export_results_xlsx` | Excel workbook of every complete: 'Responses' (labels), 'Codes' (stored |
| `get_ai_results_summary` | AI-written digest of the results: headline, key points and watch-outs |
| `get_insights_report` | The full Insights report: methodology, banner columns, per-question findings |
| `run_insights_function` | Advanced Insights operations by name: AI narrative (insights_ai_summary with |

### Wallet & billing (2)

| Tool | What it does |
|---|---|
| `get_wallet` | Wallet balance (total_credits, pre-formatted with currency symbol) and the |
| `create_wallet_topup_checkout` | Create a Stripe Checkout link to add funds to the wallet. Returns checkout_url — |

### Other (6)

| Tool | What it does |
|---|---|
| `get_price_quote` | Price a hypothetical survey without creating anything: incidence estimate, |
| `list_piping_sources` | Questions whose answer can be piped into later text with the {{Q<qid>}} token |
| `upload_media` | Upload an image or video from a public URL to use in question text or as an |
| `list_completes` | Every complete (accepted and rejected) with timestamps, duration and rate, |
| `reject_complete` | Reject a low-quality complete before close (excluded from billing, slot |
| `get_crosstab` | Cross-tabulate one question (rows) by up to 4 banner questions (columns) with |

## Pricing

Building, editing and analysing surveys is free. Fieldwork (real respondents) is paid per completed response from the workspace wallet, at the price s