# MCP (AI Assistants)

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 exposes 29 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 and publish new surveys using natural language

## Setup

### Step #1: Get Your Zigpoll API Key

1. Log into your [Zigpoll dashboard](https://app.zigpoll.com)
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

### Step #2: Connect to Your AI Client

{% tabs %}
{% tab title="Claude Desktop" %}

1. Open **Settings → Developer → Edit Config**
2. Add the following to `claude_desktop_config.json`:

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

3. Save and restart Claude Desktop
4. When prompted, authenticate with your Zigpoll API key
   {% endtab %}

{% tab title="Claude Code (CLI)" %}
Run this command in your terminal:

```bash
claude mcp add --transport http zigpoll https://mcp.zigpoll.com/mcp
```

When prompted, authenticate with your Zigpoll API key.
{% endtab %}

{% 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 and authenticate with your Zigpoll API key when prompted
   {% endtab %}

{% tab title="Windsurf" %}

1. Open **Settings → MCP**
2. Add a new MCP server with the URL:

```
https://mcp.zigpoll.com/mcp
```

3. Save and authenticate with your Zigpoll API key when prompted
   {% endtab %}
   {% endtabs %}

### 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 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                   |
| `publish_poll` | Make a survey live and visible to respondents |

## Supported Clients

* [Claude Desktop](https://claude.ai/download)
* [Claude Code (CLI)](https://docs.anthropic.com/en/docs/claude-code)
* [Cursor](https://www.cursor.com/)
* [Windsurf](https://codeium.com/windsurf)
* Any MCP-compatible client

## Troubleshooting

**Authentication errors** — Verify your API key is correct and has not been revoked. You can regenerate it from Settings → Manage Integrations → API Key.

**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.