> For the complete documentation index, see [llms.txt](https://docs.zigpoll.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zigpoll.com/integrations/mcp.md). # MCP (AI Assistants) Connect Zigpoll to AI assistants like Claude using the Model Context Protocol (MCP) Zigpoll's MCP server gives AI assistants like Claude direct access to your survey data and analytics. Ask questions in plain English — get answers instantly. No coding required. ## What is MCP? The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that lets AI assistants interact directly with external services. Think of it like a USB port for AI — a standard way to plug services into any AI assistant that supports it. Zigpoll's MCP server gives AI assistants a set of tools to read your survey data, run analytics, and even create new surveys on your behalf. The full list is under [Available Tools](#available-tools). {% hint style="warning" %} **Plan requirement:** MCP uses the Zigpoll API, which is included on the **Premium** plan and higher. On a plan without API access you can still sign in, but tools that read or change survey data fail with: *"This account's plan does not include API access. Please upgrade to the Premium plan or higher."* See [Subscription Plans](/subscription-plans.md). {% endhint %} ## What You Can Do * Summarize survey responses and identify key trends * Analyze participant engagement, devices, and geographic distribution * Compare performance across multiple surveys * Correlate answers between questions * Analyze Shopify order data alongside survey responses * Get AI-generated insights and recommendations * Create, publish, and duplicate surveys using natural language * Run AI-powered synthetic research with configurable audience profiles * Send survey invitations by email, SMS, or a unique trackable link ## Quick connect guides Step-by-step pages for the most popular clients: * [Connect Zigpoll to Claude](/integrations/mcp/mcp-claude.md) (Claude Desktop & Claude Code) * [Connect Zigpoll to ChatGPT](/integrations/mcp/mcp-chatgpt.md) * [Connect Zigpoll to Codex](/integrations/mcp/mcp-codex.md) * [Connect Zigpoll to Manus](/integrations/mcp/mcp-manus.md) * [Connect Zigpoll to OpenClaw](/integrations/mcp/mcp-openclaw.md) * [Connect Zigpoll to Perplexity](/integrations/mcp/mcp-perplexity.md) Or follow the generic setup below for any MCP-compatible client. ## Setup ### Step #1: Have Your Zigpoll Login Ready Authorization uses your Zigpoll login — there's no API key to copy or paste. When you connect, your AI client opens a browser window to authorize with Zigpoll: * **If you're already logged into Zigpoll** in that browser, authorization completes automatically — you'll briefly see a loading screen, then be returned to your client. * **If you're not logged in**, you'll see a Zigpoll sign-in page. Sign in with your email and password, Google, or Shopify. Your client then stores a secure token, so you only do this once. Behind the scenes, Zigpoll creates an API key labeled "MCP" for your login (visible under **Integrations → API Keys**) — you don't need to do anything with it. ### Step #2: Connect to Your AI Client Connecting **Claude**, **ChatGPT**, **Codex**, **Manus**, **OpenClaw**, or **Perplexity**? Each has its own step-by-step page: {% content-ref url="/pages/5TuzHTEstOBBPDGnKL36" %} [Connect to Claude](/integrations/mcp/mcp-claude.md) {% endcontent-ref %} {% content-ref url="/pages/AdrL9juXS20zk9i1kR9t" %} [Connect to ChatGPT](/integrations/mcp/mcp-chatgpt.md) {% endcontent-ref %} {% content-ref url="/pages/3xlYen1RC34qBoNaQENk" %} [Connect to Codex](/integrations/mcp/mcp-codex.md) {% endcontent-ref %} {% content-ref url="/pages/xJ1XBkIwEKLtUVIfuJHO" %} [Connect to Manus](/integrations/mcp/mcp-manus.md) {% endcontent-ref %} {% content-ref url="/pages/R55k82yc5vQoeWV4vzgk" %} [Connect to OpenClaw](/integrations/mcp/mcp-openclaw.md) {% endcontent-ref %} {% content-ref url="/pages/SmK4FsxJWpQz4OwnEByf" %} [Connect to Perplexity](/integrations/mcp/mcp-perplexity.md) {% endcontent-ref %} For other MCP-capable clients: {% tabs %} {% tab title="Cursor" %} 1. Open **Settings → MCP** 2. Click **Add new MCP server** 3. Set the name to `zigpoll` and the URL to: ``` https://mcp.zigpoll.com/mcp ``` 4. Save. Cursor opens a browser window to authorize — sign into Zigpoll if prompted (authorization completes automatically if you're already logged in). {% endtab %} {% tab title="Windsurf" %} 1. Open **Settings → MCP** 2. Add a new MCP server with the URL: ``` https://mcp.zigpoll.com/mcp ``` 3. Save. Windsurf opens a browser window to authorize — sign into Zigpoll if prompted (authorization completes automatically if you're already logged in). {% endtab %} {% endtabs %} {% hint style="info" %} **How authentication works:** `mcp.zigpoll.com` uses a standard browser-based OAuth login tied to your Zigpoll account. Setting a static `Authorization: Bearer ` header will not work — your login is exchanged for a secure token through the browser authorization flow. {% endhint %} ### Step #3: Verify Your Connection Try asking your AI assistant: > "List my Zigpoll accounts" or > "Show me my recent surveys" The assistant will use the Zigpoll tools automatically to fetch your data. ## Example Prompts ### Survey Overview * "List all my surveys and their response counts" * "Show me the details of my post-purchase survey" ### Response Analysis * "Summarize the responses for my NPS survey from the last 30 days" * "What are the daily response trends for my customer satisfaction survey?" ### Participant & Engagement * "What devices and browsers are my respondents using?" * "Where are my survey respondents located?" ### Cross-Question Analysis * "How do NPS scores correlate with purchase type?" * "Compare order values for each answer on my attribution question" ### Shopify * "What products are most purchased by customers who found us through TikTok?" ### Survey Creation * "Create a new NPS survey for my account" * "Add a multiple choice question asking about customer satisfaction" ## Available Tools {% hint style="info" %} You don't need to memorize these — just describe what you want in natural language and the AI will pick the right tool. {% endhint %} ### Data Access | Tool | Description | | ----------------------- | -------------------------------------------------------------------------------- | | `get_me` | Get info about the current authenticated user | | `list_accounts` | List all accounts for the authenticated user | | `get_account` | Get details of a specific account | | `list_polls` | List all surveys for an account | | `get_poll` | Get details of a specific survey | | `list_slides` | List all questions for a survey | | `get_slide` | Get details of a specific question | | `list_responses` | List responses with pagination and filtering | | `list_participants` | List participants with pagination and filtering | | `list_emails` | List collected email addresses | | `get_verbatims` | Read the Write-Ins people typed, optionally from one group of respondents | | `get_translations` | See which languages a survey is translated into and what still needs translating | | `get_poll_action_logic` | See a survey's Action Logic rules and the actions available to the account | | `list_webhooks` | List the signed webhooks registered on a survey | ### Reference | Tool | Description | | ---------------- | --------------------------------------------------------------- | | `search_docs` | Search the Zigpoll documentation | | `get_schema` | Field-by-field reference for survey settings and question types | | `list_templates` | List built-in survey templates and delivery presets | | `get_template` | Get a template's questions or a delivery preset's settings | ### Analytics | Tool | Description | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `analyze_response_trends` | Analyze response trends over time with answer distribution | | `analyze_participants` | Analyze participant engagement and behavior | | `get_response_summary` | Get response summary with answer distribution and key metrics | | `compare_poll_performance` | Compare performance metrics across multiple surveys | | `analyze_location_metadata` | Geographic and traffic source analysis (country, UTM, referrer) | | `analyze_device_metadata` | Device, browser, and OS distribution of respondents | | `analyze_response_metadata` | Analyze custom metadata fields from responses | | `analyze_participant_metadata` | Analyze participant properties and custom fields | | `analyze_shopify_line_items` | Analyze Shopify line items from response metadata | | `analyze_order_values` | Analyze order values and revenue breakdown by answer | | `analyze_attribution` | Attribution report for a "How did you hear about us?" question: attributed revenue, AOV and share per answer by day/week/month with change versus the previous period, plus survey answers cross-tabbed against the Shopify last-click source, UTMs, landing page, referrer or discount code, including the unattributed share | | `correlate_slides` | Correlate responses between two questions | | `group_answers` | Group multiple answers together for comparison | | `correlate_metadata_with_answers` | Correlate metadata (UTM, landing page) with answers | | `analyze_dropoff` | Show where respondents abandon a survey, question by question | | `get_insights` | Get AI-generated insights with key findings and recommendations | ### Survey Management | Tool | Description | | -------------------------- | ---------------------------------------------------------------------- | | `create_poll` | Create a new survey | | `update_poll` | Update an existing survey's settings | | `create_slide` | Add a new question to a survey | | `update_slide` | Update an existing question | | `commit_staged` | Save a survey or question that was staged with a dry run | | `publish_poll` | Make a survey live and visible to respondents | | `duplicate_poll` | Create a clean copy of a survey (questions included, no response data) | | `reorder_slides` | Change the order of questions in a survey | | `delete_slide` | Delete a question from a survey (existing answers stay in exports) | | `delete_poll` | Delete a survey (requires confirmation) | | `set_translations` | Write translations for one language of a survey | | `add_poll_action_logic` | Add an Action Logic rule that runs actions when a response comes in | | `remove_poll_action_logic` | Remove an Action Logic rule from a survey | | `create_webhook` | Register a signed webhook that receives a survey's responses | | `delete_webhook` | Remove a signed webhook from a survey | ### Synthetic Research | Tool | Description | | ---------------------------- | -------------------------------------------------------------- | | `start_synthetic_research` | Generate AI survey responses from weighted audience profiles | | `get_research_status` | Check the progress of a running research job | | `cancel_synthetic_research` | Cancel a running research job (keeps generated responses) | | `generate_audience_profiles` | Generate audience profiles from a natural-language description | ### Distribution | Tool | Description | | ---------------------- | --------------------------------------------------------------------------- | | `send_email` | Send an email survey invitation to one or more recipients | | `send_sms` | Send an SMS survey invitation to one or more phone numbers | | `generate_survey_link` | Generate a unique, trackable survey link (optional metadata and expiration) | ## Supported Clients * [Claude Desktop and claude.ai](https://claude.ai/download) (as a custom connector) * [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code) * [ChatGPT](/integrations/mcp/mcp-chatgpt.md) (as a custom connector in Developer Mode) * [Codex CLI](/integrations/mcp/mcp-codex.md) * [OpenClaw](/integrations/mcp/mcp-openclaw.md) * [Cursor](https://www.cursor.com/) * [Windsurf](https://codeium.com/windsurf) * [Manus](https://manus.im/) * [Perplexity](https://www.perplexity.ai/) * Any MCP-compatible client ## Troubleshooting **Authentication errors** — Connecting should open a browser authorization page. If it doesn't appear, find the "Connect" or "Authenticate" prompt in your client and trigger it (in Claude Code, run `/mcp`). Sign in with the Zigpoll login whose data you want to access. If you're already logged in, authorization completes automatically with that login. If the "MCP" API key was revoked (**Integrations → API Keys**), disconnect and reconnect to issue a new one. A static `Authorization: Bearer ` header is not supported; authentication must go through the browser flow. **"Authorization expired"** — An authorization request is valid for 10 minutes and can only be used once. If the page sat open too long, or you refreshed or went back after approving, close it and start the connection again from your AI client. **"The requesting application is no longer registered"** — Your client's saved registration no longer matches. Remove the Zigpoll server or connector from your client, add it again, and authorize. **"This account's plan does not include API access"** — The account is on a plan without API access. Upgrade to **Premium** or higher, or connect with a login that belongs to an account on an eligible plan. **Tools not appearing** — Restart your AI client after adding the MCP server configuration. **Rate limiting** — The MCP server has automatic retries built in. If you hit rate limits, wait a moment and try again. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.zigpoll.com/integrations/mcp.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.