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) 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 exposes 38 tools that let AI assistants read your survey data, run analytics, and even create new surveys on your behalf.

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 (Claude Desktop & Claude Code)

• Connect Zigpoll to ChatGPT

• Connect Zigpoll to Codex

• Connect Zigpoll to Manus

Or follow the generic setup below for any MCP-compatible client.

Setup

Step #1: Get Your Zigpoll API Key

1. Log into your Zigpoll dashboard

2. Go to Settings → Manage Integrations

3. Scroll down to API Key and click Add Key under Private Keys

4. Label the key "MCP" and copy it

You won't paste this key into your client's config. When you connect, your AI client opens a browser window to authorize with Zigpoll, and you enter the key on the Zigpoll authorization page. Your client then stores a secure token, so you only do this once.

Step #2: Connect to Your AI Client

Claude Desktop

1. Open Settings → Developer → Edit Config

2. Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "zigpoll": {
      "url": "https://mcp.zigpoll.com/mcp"
    }
  }
}

1. Save and restart Claude Desktop

2. Claude opens a browser window to connect to Zigpoll. On the Zigpoll authorization page, paste the API key from Step #1 and click Authorize.

Claude Code (CLI)

Cursor

Windsurf

How authentication works: mcp.zigpoll.com uses a standard browser-based OAuth login. Your client never sends your API key directly to the server, and setting a static Authorization: Bearer <api-key> header will not work — the key is exchanged for a token through the authorization page above.

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

You don't need to memorize these — just describe what you want in natural language and the AI will pick the right tool.

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 slides (questions) for a survey
get_slide	Get details of a specific slide (question)
list_responses	List responses with pagination and filtering
list_participants	List participants with pagination and filtering
list_emails	List collected email addresses

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
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
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)

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

• Claude Code (CLI)

• Cursor

• Windsurf

• Manus

• Any MCP-compatible client

Troubleshooting

Authentication errors — Connecting opens a browser authorization page; if it doesn't appear, look for a "Connect" or "Authenticate" prompt in your client and trigger it manually (in Claude Code, run /mcp). On that page, enter a valid API key that has not been revoked — you can regenerate one from Settings → Manage Integrations → API Key. A static Authorization: Bearer <api-key> header is not supported; authentication must go through the browser flow.

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.