survey-light
Server Details
Build, target, launch and analyse consumer surveys from your AI assistant (Survey Light, 71 tools).
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- menaker/mobopinions-survey-mcp
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 72 tools
The results/insights cluster is overcrowded: get_results, get_ai_results_summary, get_insights_report, get_crosstab, and run_insights_function have overlapping reporting purposes, and get_survey_status overlaps with list_completes for monitoring. Descriptions help, but an agent could still misselect among these analysis tools.
All tool names use a consistent snake_case verb_noun convention (list_surveys, create_survey, update_question, delete_quota), including compound forms like set_location_targeting. No camelCase or vague bare verbs appear, so names are predictable.
72 tools is extreme for any single MCP server, far beyond the 25+ threshold for 'too many' and into the 50+ extreme-mismatch band. Even though the survey domain is broad, the surface is too large for an agent to navigate efficiently.
The surface covers the full survey lifecycle: account/workspace setup, survey creation (manual, AI, template), questionnaire editing, targeting, quotas, launch/monitor/close, results, exports, insights, media, and translations. No obvious core operation is missing, though delete_workspace is absent.
Available Tools
72 toolsaccept_workspace_invitationAccept an invitationAInspect
Redeem a workspace invitation token (from the invitation email) for the linked account; joins the workspace and switches to it.
Inputs: token (required).
add_answer_optionAdd answer optionAInspect
Add one answer option to a single_select / multi_select / ranking / matrix question.
Inputs: qid (required), answer (required), survey_id (required), code, +4 more.
add_questionAdd questionAInspect
Append a question with its answer options. single_select / multi_select / ranking need answers; matrix needs subquestions (statements) AND answers (the scale). Piping: write {{Q}} anywhere in the text to insert the respondent's answer to an EARLIER question (ids from list_piping_sources). Returns the updated questionnaire plus created_qid.
Inputs: type (required), question (required), survey_id (required), help, +16 more.
add_quota_conditionAdd quota conditionAInspect
Add a (question, answer code) condition to a manual quota. A condition on a second question interlocks the cell.
Inputs: qid (required), code (required), quota_id (required), survey_id (required).
cancel_workspace_invitationCancel an invitationAIdempotentInspect
Revoke a pending workspace invitation.
Inputs: invitation_id (required), workspace_id.
clone_surveyClone surveyAInspect
Deep-copy a survey (questions, answers, targeting, skip logic) into a new draft.
Inputs: survey_id (required), title.
close_surveyClose survey & settleADestructiveInspect
Close a running survey for good: stops fielding, charges accepted completes and releases the rest of the hold back to the wallet. Final — no more rejections after this. Confirm with the user first.
Inputs: survey_id (required).
convert_location_textPreview location targetingARead-onlyInspect
Turn a free-text location description (e.g. 'Texas and Florida', 'Greater London', 'zip codes starting 902') into structured targeting: a region/state/DMA selection or a postcode list. Preview only — apply with set_location_targeting.
Inputs: survey_id (required), locations_text (required).
create_quotaCreate quotaAInspect
Cap how many completes a group may fill. Demographic cell: quota_type 'gender' + gender (m/f/nb) or quota_type 'age' + age_from/age_to (bound automatically to the standard questions). Own-question cell: conditions [{qid, code}] — conditions on two different questions INTERLOCK (respondent must satisfy all). Limit is in completes.
Inputs: name (required), qlimit (required), survey_id (required), age_to, +4 more.
create_surveyCreate survey (draft)AInspect
Create an empty draft survey in the active workspace. Then add questions (add_question), set the audience (set_targeting), preview it (preview_survey) and launch it (launch_survey). Returns survey_id and a price estimate. Nothing is charged until launch.
Inputs: title (required), category (required), country_code (required), submissions_quota (required), +1 more.
create_survey_from_questionCreate survey with AIAInspect
Build a complete survey (questions, screeners, skip logic, images) from ONE research question using AI, as a draft in the active workspace. Slow (up to a few minutes). Review with list_questions, then set_targeting → preview_survey → launch_survey. Limited to 5 calls per hour.
Inputs: country_code (required), research_question (required), category, completes, +1 more.
create_survey_from_templateCreate survey from templateAInspect
Create a new draft by copying a template survey (a survey marked with set_survey_template_flag, is_template=true in list_surveys).
Inputs: title (required), template_id (required), submissions_quota (required).
create_wallet_topup_checkoutTop up wallet (Stripe link)AInspect
Create a Stripe Checkout link to add funds to the wallet. Returns checkout_url — give it to the user to pay in the browser; funds land after payment. Minimum 10. billing_country is the ISO-2 country the invoice is issued to (UK customers are charged 20% VAT); ask the user for it — the call is refused with billing_country_required until Stripe knows the customer's country.
Inputs: amount (required), currency, billing_country.
create_workspaceCreate workspaceAInspect
Create a new Survey Light workspace (you become its owner) and switch to it.
Inputs: name (required).
delete_questionDelete questionADestructiveInspect
Delete a question and its answers/statements. Irreversible.
Inputs: qid (required), survey_id (required).
delete_quotaDelete quotaADestructiveInspect
Delete a manual quota cell (auto cells follow targeting — freeze them instead).
Inputs: quota_id (required), survey_id (required).
delete_surveyDelete surveyADestructiveInspect
Permanently delete a draft or closed survey with no completes. Live/paused surveys must be closed first. Irreversible — confirm with the user.
Inputs: survey_id (required).
export_results_csvExport results (CSV)ARead-onlyIdempotentInspect
Raw respondent-level CSV: one row per complete (accepted and rejected), one column per question.
Inputs: survey_id (required).
export_results_xlsxExport results (Excel with codes)ARead-onlyIdempotentInspect
Excel workbook of every complete: 'Responses' (labels), 'Codes' (stored answer codes per question) and 'Codebook' (code → label). Returned as an embedded .xlsx file (base64 blob).
Inputs: survey_id (required).
finish_builderFinish questionnaire (re-price)AIdempotentInspect
Call after editing questions: recomputes LOI from the final question count and re-prices the survey (CPI, total, feasibility) against its targeting.
Inputs: survey_id (required).
freeze_auto_quotaFreeze/unfreeze auto quotaAIdempotentInspect
Freeze an auto-generated (targeting-derived) quota so it never fills and is never rebuilt on audience changes; disabled=false unfreezes.
Inputs: disabled (required), quota_id (required), survey_id (required).
get_accountGet account & workspacesARead-onlyIdempotentInspect
Account card: full name, email, Survey Light workspaces (id, name, role, member count), active workspace id and its name.
Inputs: workspace_id.
get_ai_results_summaryAI summary of resultsARead-onlyInspect
AI-written digest of the results: headline, key points and watch-outs (needs ≥3 accepted completes).
Inputs: survey_id (required).
get_close_previewPreview close settlementBRead-onlyIdempotentInspect
What closing would settle: accepted/rejected counts, held amount, charge and release-back.
Inputs: survey_id (required).
get_complete_answersGet one respondent's answersARead-onlyIdempotentInspect
Full question-by-question answers of one complete (by location_id from list_completes).
Inputs: survey_id (required), location_id (required).
get_crosstabGet crosstabARead-onlyIdempotentInspect
Cross-tabulate one question (rows) by up to 4 banner questions (columns) with chi-square significance. Omit ids to get the default table and the list of available fields.
Inputs: survey_id (required), link, col_qid, row_qid.
get_insights_reportGet insights reportARead-onlyIdempotentInspect
The full Insights report: methodology, banner columns, per-question findings with significance flags and what changed vs a comparison survey/wave.
Inputs: survey_id (required), banner_qid, banner_qids, definition_id, +2 more.
get_launch_summaryGet launch summaryARead-onlyIdempotentInspect
Pre-launch check: final quote (question count, LOI, CPI, total), whether the survey was previewed, wallet balance, amount required and any shortfall.
Inputs: survey_id (required).
get_price_quoteGet price quoteARead-onlyIdempotentInspect
Price a hypothetical survey without creating anything: incidence estimate, LOI, cost per complete (CPI), total, feasibility and warnings. Minimum 100 completes, maximum 75 questions.
Inputs: country_code (required), submissions_quota (required), targeting, question_count, +1 more.
get_profileGet my profileARead-onlyIdempotentInspect
Who am I: the linked account (user id, email, display name), the workspaces I belong to and which one this session is switched to.
Inputs: no named parameters.
get_resultsGet resultsARead-onlyIdempotentInspect
Per-question aggregates over accepted completes: counts and percentages for choice questions, age buckets, and up to 200 open-text answers per question.
Inputs: survey_id (required).
get_survey_optionsGet survey optionsARead-onlyIdempotentInspect
Reference lists for creating a survey: countries available for fielding (code + name), survey languages, topic categories, and the wallet currency. Call this before create_survey to pick valid country_code / category values.
Inputs: no named parameters.
get_survey_statusGet field statusARead-onlyIdempotentInspect
Cheap liveness snapshot for a survey in field: status, is_live, accepted/rejected completes, target and the time of the latest complete. Poll this instead of get_results to watch progress.
Inputs: survey_id (required).
get_targetingGet audience targetingBRead-onlyIdempotentInspect
Current audience: country, gender, age ranges, employment, education, ethnicity, marital status, household income, location selection — plus the option dictionaries for each dimension and a live price quote.
Inputs: survey_id (required).
get_walletGet walletARead-onlyIdempotentInspect
Wallet balance (total_credits, pre-formatted with currency symbol) and the full transaction ledger of the active workspace: deposits, project holds, charges and releases.
Inputs: no named parameters.
invite_workspace_memberInvite a memberAInspect
Email an invitation to join a workspace you own (link valid 7 days). Fails if the address is already a member or already invited.
Inputs: email (required), role, workspace_id.
launch_surveyLaunch surveyAInspect
Take a draft live: reserves the full project value from the wallet as a hold (charged only for accepted completes at close), publishes the survey and attaches sample suppliers. Requires ≥1 question, preview_survey done, and sufficient balance. ALWAYS confirm with the user before launching.
Inputs: survey_id (required).
list_completesList completesARead-onlyIdempotentInspect
Every complete (accepted and rejected) with timestamps, duration and rate, plus accepted/rejected counts, the target and the rejection cap (15%).
Inputs: survey_id (required).
list_piping_sourcesList pipeable questionsARead-onlyIdempotentInspect
Questions whose answer can be piped into later text with the {{Q}} token (e.g. 'Why did you choose {{Q123}}?'). With current_qid, only questions asked before it are returned.
Inputs: survey_id (required), current_qid.
list_questionsList questionsARead-onlyIdempotentInspect
The questionnaire: every question with type, text, answer options, matrix statements, mandatory flag, locked flag (standard demographics can't be edited), skip routing, editable count (max 75) and LOI in minutes.
Inputs: survey_id (required).
list_quotasList quotasARead-onlyIdempotentInspect
Quota cells of a survey with limit, filled, remaining and their conditions (members), plus the questions/answers a quota can be put on. Age/gender cells derived from targeting are marked is_auto (only their limit can change, and their ids are regenerated on every call — always use ids from the LATEST response).
Inputs: survey_id (required).
list_surveysList surveysARead-onlyIdempotentInspect
Surveys in the active workspace (newest first, max 300) with status (draft/live/paused/closed), target quota, completes, CPI, total and country.
Inputs: no named parameters.
list_workspace_membersList workspace membersARead-onlyIdempotentInspect
Members (user id, email, role) and pending invitations of a workspace you own.
Inputs: workspace_id.
list_workspacesList workspacesARead-onlyIdempotentInspect
My Survey Light workspaces plus the id of the one this session is switched to.
Inputs: no named parameters.
parse_questionnaire_documentParse a questionnaire documentARead-onlyInspect
AI-parse a questionnaire document (PDF, DOCX, XLSX or CSV, max 20 MB) fetched from a public URL into a review-ready list of questions with types, answers and skips. Nothing is written — feed the result into add_question.
Inputs: url (required), survey_id (required), filename.
pause_surveyPause surveyAIdempotentInspect
Pause a live survey (stops collecting; funds stay reserved). Resume with resume_survey.
Inputs: survey_id (required).
preview_surveyPreview survey (test link)AIdempotentInspect
Get a respondent-view preview link for a survey and mark it as tested. Launch REQUIRES this step — share the test_url with the user to try the survey.
Inputs: survey_id (required).
reject_completeReject a completeAIdempotentInspect
Reject a low-quality complete before close (excluded from billing, slot reopens). Capped at 15% of the target. Give a concrete reason.
Inputs: reason (required), survey_id (required), location_id (required).
remove_answer_optionRemove answer optionADestructiveInspect
Delete one answer option from a question.
Inputs: qid (required), code (required), survey_id (required).
remove_quota_conditionRemove quota conditionADestructiveInspect
Remove one condition from a manual quota.
Inputs: quota_id (required), member_id (required), survey_id (required).
remove_workspace_memberRemove a memberADestructiveIdempotentInspect
Remove a user from a workspace you own. Confirm with the user first.
Inputs: member_user_id (required), workspace_id.
rename_workspaceRename workspaceAIdempotentInspect
Rename a workspace you own.
Inputs: name (required), workspace_id.
reorder_answer_optionsReorder answer optionsAIdempotentInspect
Set the display order of a question's answers by listing their codes in order.
Inputs: qid (required), codes (required), survey_id (required).
reorder_questionsReorder questionsAIdempotentInspect
Set the order of the editable questions by listing their qids. Locked demographics stay first; omitted questions keep their relative order after.
Inputs: qids (required), survey_id (required).
resume_surveyResume surveyAIdempotentInspect
Resume a paused survey that was previously launched.
Inputs: survey_id (required).
run_insights_functionRun an Insights functionBInspect
Advanced Insights operations by name: AI narrative (insights_ai_summary with regenerate=true), open-end theming (insights_openend_themes, needs qid), theme frames, wave maps, age bands, exhibits, share links (insights_share_create), frozen report versions, external waves, PPTX export (insights_pptx, base64), hiding findings, saved trackers (insights_definition_list/save {name, config:{waves:[{kind:'survey'|'external', id, label}], banner_qids}}/delete/clone), light_list_compare_surveys / list_surveys / get_survey. params holds the function's own arguments.
Inputs: fn (required), survey_id (required), params.
set_location_targetingSet location targetingAIdempotentInspect
Apply location targeting: EITHER an admin-area selection (assoc_type + values, US: region/division/state/county/dma; UK: region/constituency/county/district) OR a postcode list (postcodes; [] clears). location_text is the free-text label manual panels see. Use convert_location_text first.
Inputs: survey_id (required), values, postcodes, assoc_type, +1 more.
set_question_routingSet skip logicAIdempotentInspect
Skip logic for a single_select question: per answer code, jump to a later question id, 'end' (finish the survey) or 'continue' (next question). Replaces the question's existing routing.
Inputs: qid (required), routes (required), survey_id (required).
set_quota_activeSwitch quota on/offAIdempotentInspect
Switch a manual quota on (active=true) or off (active=false). An inactive quota never terminates respondents and records no fills. Auto (targeting-derived) quotas can't be switched off — freeze them instead.
Inputs: active (required), quota_id (required), survey_id (required).
set_survey_template_flagMark as templateAIdempotentInspect
Mark (or unmark) a survey as a reusable workspace template.
Inputs: survey_id (required), is_template (required).
set_target_completesSet target completesAIdempotentInspect
Change the target number of completes. In field, raising it reserves the extra amount from the wallet; lowering it refunds the surplus at close.
Inputs: survey_id (required), submissions_quota (required).
set_targetingSet audience targetingAIdempotentInspect
Replace the survey's demographic targeting (each list you pass REPLACES that dimension; pass [] to clear it; omit to leave unchanged). Option names come from get_targeting.options. Re-prices and returns the new quote.
Inputs: survey_id (required), gender, marital, education, +4 more.
split_quota_limitsSplit quota limitsAIdempotentInspect
Spread the completes target across cells — e.g. scope 'gender' = 50/50 male/female (needs male_female targeting), scope 'age' across the age cells, or explicit quota_ids. Even split by default; weights {quota_id: percent} for a custom mix; total overrides the target.
Inputs: scope (required), survey_id (required), total, weights, +1 more.
suggest_survey_topicSuggest a topic categoryARead-onlyInspect
AI-pick the best topic category (from get_survey_options.categories) for a research question.
Inputs: research_question (required).
switch_workspaceSwitch workspaceAIdempotentInspect
Make a workspace the active one for this session. Surveys, wallet and members tools all operate on the active workspace.
Inputs: workspace_id (required).
translate_surveyTranslate surveyAInspect
Clone a survey once per language and machine-translate every question and answer. Optionally re-target each clone to another country. Up to 10 languages per call; returns the new survey ids.
Inputs: languages (required), survey_id (required).
update_accountUpdate account detailsAIdempotentInspect
Set the account's full name and optionally rename the ACTIVE workspace. fullname is always written (pass the current value to keep it).
Inputs: fullname (required), workspace_name.
update_answer_optionUpdate answer optionBIdempotentInspect
Change an answer option's text, flags, image or position.
Inputs: qid (required), code (required), survey_id (required), answer, +5 more.
update_questionUpdate questionAIdempotentInspect
Edit an existing question's text, mandatory flag, answer randomisation, limits/labels or type. Locked standard demographics cannot be edited.
Inputs: qid (required), survey_id (required), help, type, +15 more.
update_quotaUpdate quotaBIdempotentInspect
Change a quota's limit (any cell) or name/descriptor (manual cells only).
Inputs: quota_id (required), survey_id (required), name, age_to, +3 more.
update_quota_conditionUpdate quota conditionAIdempotentInspect
Change the question and/or answer code of a quota condition.
Inputs: quota_id (required), member_id (required), survey_id (required), qid, +1 more.
upload_mediaUpload image/videoAInspect
Upload an image or video from a public URL to use in question text or as an answer image (img_url). Allowed: png, jpg, jpeg, gif, webp, svg, mp4, mov, webm; max 25 MB. Returns public_url.
Inputs: url (required), filename, file_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
30+ marketing data tools for AI agents: keywords, SERP, backlinks, AI visibility, app store & commerce intelligence, Reddit/LinkedIn/Facebook/YouTube research, web search, page extraction, site audit, image & video generation, one-shot marketing apps. Bring your own API key from supamarketers.com — per-tool pricing in Credits.
240 tools for Reddit, X, TikTok, Instagram, YouTube, reviews, ads, shopping and search data
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Direct access to 60+ scraping and search tools. Extract structured data from Google (Search, Maps, Trends), Amazon, Airbnb, Social Media, and any web page directly into your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for creating AI-moderated interviews and surveys, deployable with shareable links2MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to generate and publish AI surveys, retrieve collected responses, and produce analysis reports with executive summaries, key metrics, and per-question insights by forwarding tool calls to a hosted survey backend.65 npmMIT

WebAsk MCPofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to create and validate surveys, distribute them, read and tag responses, and generate reports or exports through a hosted Streamable HTTP MCP endpoint with API-key authentication.MIT
rifts.to MCP serverofficial
AlicenseAqualityBmaintenanceEnables creating, managing, and analyzing live audience surveys on rifts.to directly from an AI client. Supports creating surveys, listing them, retrieving results, and closing surveys via natural language.1428 npmApache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.