PickFu MCP server for Claude, Cursor, and ChatGPT

The PickFu MCP server lets AI assistants create surveys, check results, generate images, and gather consumer feedback — all through natural conversation. It’s the fastest way to integrate PickFu into your AI workflow.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and services. With the PickFu MCP server, you can ask your AI assistant to create polls, analyze results, and get consumer insights without leaving your conversation.

Connect to the MCP server

https://mcp.pickfu.com/mcp

Choose your AI client below to get set up.

Claude (claude.ai, desktop, and mobile)

Claude connects to remote MCP servers through its Connectors feature — no config files needed. This works the same way across claude.ai, the Claude Desktop app, and Claude mobile.

Open Customize

In Claude, click your profile icon (bottom-left), then Customize.

Go to Connectors

Select Connectors.

Add PickFu

Click +, then Add custom connector. Enter:

Name: PickFu
URL: https://mcp.pickfu.com/mcp

Click Add.

Authorize

The first time Claude uses a PickFu tool, you’ll be prompted to sign in to your PickFu account via OAuth.

On Team and Enterprise plans, an Owner must add the connector first. Members can then enable it from Customize > Connectors. See Anthropic’s custom connectors guide for details.

Claude Code

Run this command in your terminal:

claude mcp add pickfu --transport http https://mcp.pickfu.com/mcp

Then type /mcp inside Claude Code to verify the connection and complete OAuth sign-in. See Claude Code MCP documentation for more options.

Cursor

Open MCP settings

Open Cursor Settings and select MCP in the sidebar.

Add the server

Click Add new MCP server and enter:

Name: PickFu
Type: Streamable HTTP
URL: https://mcp.pickfu.com/mcp

Or add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):

{
  "mcpServers": {
    "pickfu": {
      "url": "https://mcp.pickfu.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Authorize

Cursor prompts you to sign in to your PickFu account via OAuth when you first use a tool.

See Cursor’s MCP documentation for details.

ChatGPT

ChatGPT supports custom MCP connectors on Plus, Pro, and Enterprise plans. You’ll need to enable Developer Mode first.

Enable Developer Mode

Go to Settings → Apps & Connectors → Advanced settings, then toggle Developer Mode on.

Add the connector

In Settings → Apps & Connectors, click Add new connector and enter:

Name: PickFu
URL: https://mcp.pickfu.com/mcp

Authorize

Open a new chat, select the PickFu connector from the tools menu (+ button), and follow the OAuth sign-in prompt.

See OpenAI’s Developer Mode guide for details.

Notion

Notion Custom Agents support custom MCP connections on Business and Enterprise plans. A workspace admin must enable them first.

Enable custom MCP servers (admin)

Go to Settings → Notion AI → AI connectors and enable Custom MCP servers.

Add to your Custom Agent

Open your Custom Agent’s Settings → Tools & Access → Add connection → Custom MCP server. Enter:

Display name: PickFu
URL: https://mcp.pickfu.com/mcp

Click Save.

Authorize

Follow the OAuth prompt to sign in to your PickFu account. Each MCP connection is per-agent — repeat for additional agents.

See Notion’s MCP connections guide for details.

Accio Work

PickFu is an official plugin in the Accio Work plugin market — Alibaba’s AI agent for e-commerce sellers. There’s no MCP URL to paste: install the plugin and connect your account.

Find PickFu in the plugin market

In Accio Work, open Plugins → Plugin markets and search for PickFu (it’s listed under Marketing & Advertising).

Add the plugin

Click + to add PickFu to your workspace.

Connect your account

Open the plugin’s App Authorization section and connect PickFu. You’ll be sent to PickFu to sign in and approve access — the same OAuth flow every other MCP client uses.

Once connected, ask Accio for consumer feedback in plain language (“test these three main images with Amazon shoppers”). The plugin ships e-commerce playbooks for main-image CTR tests, listing copy, pricing, packaging, brand names and logos, ad creative, and validating AI-generated product images.

OpenClaw

See the OpenClaw page for MCP configuration, CLI-based skills, and the Claw Hub market research workflow.

Other MCP clients

Any MCP-compatible client that supports Streamable HTTP transport can connect:

URL: https://mcp.pickfu.com/mcp
Transport: Streamable HTTP

When prompted for authentication, sign in to your PickFu account via the OAuth flow.

Gemini: Gemini does not currently support custom connectors on the web, but you can add MCP servers through the Gemini CLI. See Gemini’s MCP server instructions for setup.

Available tools

Survey management

Tool	Description
`save_survey`	Create or update a survey. Omit `surveyId` to create; include `surveyId` to update questions, targeting, reporting, or metadata.
`publish_survey`	Publish a draft survey to start collecting responses
`mini_poll`	Create, update, or publish the account’s plan-included daily mini-poll. Plan-gated — see Mini-poll tool below
`stop_survey`	Stop a live survey early — unused responses are refunded
`delete_survey`	Delete or archive a survey
`get_survey`	Get full survey details including questions, options, AI summaries, and a per-question `results` object with vote totals, percentages, and the winning option
`get_survey_responses`	Get paginated individual responses with explanations and demographics
`list_surveys`	List and search surveys with filtering by status, type, tags, and more. Returns your team/account’s surveys by default; set `mine: true` to restrict results to surveys created by the authenticated user (requires OAuth — not available to API-key callers)
`add_respondents`	Extend a completed survey with additional respondents without recreating it
`rate_response`	Rate a response `helpful`, or flag it `not_helpful` to report low quality — feeds panel-quality review and may auto-reject the response
`pin_response`	Pin a noteworthy response to the top of the survey results

Projects

Tool	Description
`save_project`	Create or update a project (use to group related surveys with shared goal and description)
`get_project`	Get a project including its survey summaries
`list_projects`	List projects scoped to your team, with filters for bookmarked and archived status

Poll URL builder

Tool	Description
`build_poll_url`	Generate a clickable URL that creates a PickFu poll with pre-filled parameters

Media

Tool	Description
`upload_media`	Upload an image or video to get a CDN URL for use in surveys
`generate_image`	Generate an image from a text prompt for use in poll options
`extract_images`	Extract and view image URLs from a survey’s options

Inline previews in supporting clients: In MCP clients that implement MCP Apps (such as Claude and ChatGPT), generate_image renders as an inline card showing the image, prompt, and model — alongside the existing inline previews for survey-builder and results-dashboard tools. CLI and REST API callers continue to receive the CDN URL in the image_url field and can use it directly.

Images in web-based clients: Web chat clients like Claude, ChatGPT, and Notion cannot pass local file data to MCP tools — dragging or pasting an image into the chat won’t make it available to PickFu tools. To use your own images, provide a hosted image URL. You can also pass an image URL to generate_image to create variations of it. Terminal-based tools like Claude Code and OpenClaw can read local files directly.

Remote image hosts allowlist. When extract_images fetches an image or you pass a reference_image_urls URL to generate_image, the URL host must be on PickFu’s allowlist. Currently allowed:

pickfu.com (and subdomains, including media-cdn.pickfu.com)
cloudinary.com
s3.amazonaws.com and regional s3.<region>.amazonaws.com
CloudFront distributions (d*.cloudfront.net)
Amazon product image CDNs: m.media-amazon.com, ssl-images-amazon.com, images-amazon.com
files.catbox.moe
Alibaba / Aliyun image CDNs: alicdn.com and aliyuncs.com (including subdomains)

If your image is hosted somewhere else, upload it first with upload_media and use the returned media-cdn.pickfu.com URL. The same allowlist applies to the mediaUrl you pass to save_survey / build_poll_url — if a save_survey call fails with a 400 on an image URL, re-host via upload_media and try again.

Discovery and organization

Tool	Description
`list_available_targeting`	List all demographic targeting options for audience selection
`list_available_reporting`	List all available reporting demographics
`list_tags`	List tags for organizing surveys
`create_tag`	Create a new tag
`list_playbooks`	Discover step-by-step research playbooks
`get_playbook`	Get full playbook with instructions and poll creation links

Help

Tool	Description
`help_center_search`	Search the PickFu help center for articles
`mcp_feedback`	Submit feedback, suggestions, or bug reports to the PickFu team

Mini-poll tool

mini_poll runs the account’s plan-included daily mini-poll. It’s plan-gated: the tool only appears in ListTools for accounts on a plan with mini-poll capability, and teammates on the same plan share one mini-poll allowance per day. Use it when the user wants a quick, no-cost pulse check that doesn’t consume the survey balance. Mini-polls have a fixed shape:

Exactly one question per mini-poll (any type except screen_recording).
Five respondents. Sample size is not configurable.
No audience targeting and no caller-selected reporting demographics.
Publishing consumes today’s allowance; there is no charge against the account balance.

Because mini-polls publish for free, publish_survey refuses mini-poll drafts — always use mini_poll with action: "publish" instead. Actions The tool takes a single action field: create, update, or publish.

Action	Required inputs	Notes
`create`	`questions` (exactly one)	Optional: `name`, `country`, `surveyIntent`. Do NOT pass `surveyId`. Returns the draft `id`.
`update`	`surveyId` plus at least one of `name`, `country`, `surveyIntent`, `questions`	Edits an existing draft.
`publish`	`surveyId`	No draft fields allowed. Launches the mini-poll and consumes today’s allowance.

Workflow Always create first, then reuse the returned id as surveyId for later update or publish calls in the same flow:

Call mini_poll with action: "create" and the question.
Read id from the response.
Optionally call action: "update" with surveyId: <id> to refine the draft.
Confirm launch with the user in plain language, then call action: "publish" with surveyId: <id>. The assistant must not publish without explicit user confirmation.

Example: create then publish

{
  "action": "create",
  "name": "Homepage headline test",
  "country": "US",
  "questions": [
    {
      "type": "head_to_head",
      "prompt": "Which headline is more compelling?",
      "options": [
        { "value": "Ship faster with AI-native tools" },
        { "value": "Build better products in half the time" }
      ]
    }
  ]
}

The response includes an id. After the user confirms, publish it:

{
  "action": "publish",
  "surveyId": "<id from create>"
}

Errors When the daily allowance is unavailable, the tool returns a text error that surfaces two fields from the API response:

nextAvailableAt — ISO timestamp for when the account can run its next mini-poll.
claimedBy — if a teammate already used today’s allowance, the login or user id that claimed it.

Use these to tell the user who took today’s mini-poll and when the next one unlocks, rather than retrying immediately.

Supported question types

Every response includes a written explanation by default. When a respondent picks an option, ranks, rates, or clicks, they’re also required to explain why in their own words — that’s already part of every question type except screen_recording (which returns a transcription instead). Do not add a separate open_ended question to capture “why” — it wastes a question slot (multi-question surveys are priced per question) and produces redundant data. Phrase your real question, and PickFu collects the explanation automatically. The text comes back on each response as the explanation field. See surveys overview for more.

Type	Description
`head_to_head`	A/B comparison — respondents pick a favorite (2 options)
`ranked`	Respondents rank options in preference order (3–8 options)
`open_ended`	Single-concept poll with written feedback
`single_select`	Choose one from multiple options (3–8 options)
`multi_select`	Select multiple answers (3–8 options)
`click_test`	Heatmap generation from image clicks
`emoji_rating`	Emoji sentiment selection with explanation
`star_rating`	1–5 star rating with feedback
`five_second_test`	Brief timed exposure for first impressions
`screen_recording`	Record user interaction with content

Usage examples

Once connected, just ask your AI assistant naturally: Create a head-to-head poll

“Create a PickFu poll comparing these two logo designs to see which one people prefer”

Get survey results

“Show me the results from my latest PickFu survey”

Target a specific audience

“Create a poll asking Amazon Prime members aged 25–34 which product image they prefer”

Generate images for a poll

“Generate two product mockup images and create a head-to-head poll comparing them”

Supported countries

These are the markets you can target with the country field. PickFu auto-translates your poll into each market’s language and returns results in both languages — see International surveys and translation.

Code	Country
US	United States
CA	Canada
GB	United Kingdom
AU	Australia
DE	Germany
FR	France
ES	Spain
IT	Italy
JP	Japan
KR	Korea
MX	Mexico
BR	Brazil
ZA	South Africa
PL	Poland
SE	Sweden

Sample sizes

Available respondent counts: 15, 30, 50, 75, 100, 200, 300, 500

Screen recording polls use a different set: 5, 10, 15, 20, 25, 30, 50, 75. Passing any other value (for example sampleSize: 100) to save_survey or build_poll_url on a screen_recording question fails validation.

Option formats

Polls support various content types for options:

Text — Plain text via value
Media URL — Images or videos via mediaUrl
ASIN — Amazon product by asin for comparison
Image set — Multiple images grouped together via imageSet (see below)
Mockup — Product listing mockups via mockup (SERP or listing style)

One content type per option. Each option must set exactly ONE of value, mediaUrl, asin, imageSet, or mockup. Setting more than one — for example, adding a text value label to a mediaUrl image option — is rejected client-side by save_survey and build_poll_url with a message that names the conflict and the fix.Image options are auto-labeled. Do NOT put a caption in value alongside an image — respondents see image options as A, B, C… automatically. Use value only for text-only options.All options in the same question must share the same content type (all text, or all images, etc.). This cross-option rule is enforced by the API.

Example: 3-way image comparison

{
  "questions": [
    {
      "type": "ranked",
      "prompt": "Which design would you buy?",
      "options": [
        { "mediaUrl": "https://media-cdn.pickfu.com/....a.jpg" },
        { "mediaUrl": "https://media-cdn.pickfu.com/....b.jpg" },
        { "mediaUrl": "https://media-cdn.pickfu.com/....c.jpg" }
      ]
    }
  ],
  "sampleSize": "15",
  "country": "US"
}

Respondents see the three images labeled A, B, C.

Image set options

Pass imageSet on an option in save_survey to group multiple images into one comparable unit. Each entry can be one of:

An HTTPS image URL — included as-is.
A product reference — { "source": "amazon", "id": "B08288SG9K" }. PickFu expands the reference to that product’s full Amazon image gallery (every listing image) and rehosts each image. Only source: "amazon" resolves today; other sources return a 422.
A bare Amazon ASIN — "B08288SG9K" as a shorthand. The MCP server normalizes it to { source: "amazon", id: "B08288SG9K" } before forwarding. The underlying API expects the { source, id } object, so this shorthand is MCP-only.

Rules:

Use either image URLs or exactly one product reference per option — don’t mix them in the same imageSet. To compare two products’ galleries, give each its own option.
imageSet requires at least one entry.
This shape is specific to save_survey. build_poll_url only accepts plain image URLs.

Set imageSetDirection on the option to control the layout:

Value	Layout
`horizontal`	Images displayed side-by-side
`vertical`	Images stacked top-to-bottom
`a-plus`	Rendered as an Amazon A+ content block

a-plus is also what makes get_survey → save_survey round-trips work for A+ image sets — re-saving an existing A+ survey preserves its direction. Example: comparing two Amazon listings’ full galleries

{
  "options": [
    {
      "imageSet": [{ "source": "amazon", "id": "B08288SG9K" }],
      "imageSetDirection": "a-plus"
    },
    {
      "imageSet": ["B0CVFKZ1LC"],
      "imageSetDirection": "a-plus"
    }
  ]
}

Authentication

The MCP server supports two authentication methods. Most clients support both.

OAuth (automatic)

OAuth works out of the box with all clients listed above. When you first use a PickFu tool, your AI client prompts you to sign in to your PickFu account. No configuration needed.

API keys

For automation, CI/CD pipelines, and long-running agents, authenticate with an API key instead of OAuth.

Create an API key

Go to Settings > API Keys in your PickFu account and create a new key.

Add the key to your MCP client config

Pass the API key as a Bearer token in the Authorization header:

claude mcp add pickfu --transport http https://mcp.pickfu.com/mcp \
  --header "Authorization: Bearer sk_your_api_key"

{
  "mcpServers": {
    "pickfu": {
      "url": "https://mcp.pickfu.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk_your_api_key"
      }
    }
  }
}

See the authentication guide for full details on both methods.

Need help?

MCP documentation

Learn more about the Model Context Protocol.

Help center article

Quick setup overview for non-developers.

Contact support

Get help with MCP server setup.

Get started

Tools

Build apps

PickFu MCP server for Claude, Cursor, and ChatGPT

What is MCP?

Connect to the MCP server

Claude (claude.ai, desktop, and mobile)

Claude Code

Cursor

ChatGPT

Notion

Accio Work

OpenClaw

Other MCP clients

Available tools

Survey management

Projects

Poll URL builder

Media

Discovery and organization

Help

Mini-poll tool

Supported question types

Usage examples

Supported countries

Sample sizes

Option formats

Image set options

Authentication

OAuth (automatic)

API keys

Need help?

MCP documentation

Help center article

Contact support

​What is MCP?

​Connect to the MCP server

​Claude (claude.ai, desktop, and mobile)

​Claude Code

​Cursor

​ChatGPT

​Notion

​Accio Work

​OpenClaw

​Other MCP clients

​Available tools

​Survey management

​Projects

​Poll URL builder

​Media

​Discovery and organization

​Help

​Mini-poll tool

​Supported question types

​Usage examples

​Supported countries

​Sample sizes

​Option formats

​Image set options

​Authentication

​OAuth (automatic)

​API keys

​Need help?

MCP documentation

Help center article

Contact support

What is MCP?

Connect to the MCP server

Claude (claude.ai, desktop, and mobile)

Claude Code

Cursor

ChatGPT

Notion

Accio Work

OpenClaw

Other MCP clients

Available tools

Survey management

Projects

Poll URL builder

Media

Discovery and organization

Help

Mini-poll tool

Supported question types

Usage examples

Supported countries

Sample sizes

Option formats

Image set options

Authentication

OAuth (automatic)

API keys

Need help?