MCP server

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.

OpenClaw

Run this command:

openclaw mcp set pickfu '{"url":"https://mcp.pickfu.com/mcp"}'

Or add to openclaw.json manually:

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

Then restart the gateway. OAuth sign-in is triggered when a tool is first called. See OpenClaw MCP documentation for details.

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.

Available tools

Survey management

Tool	Description
`create_survey`	Create a new survey with questions, options, and targeting
`update_survey`	Update survey settings, questions, targeting, and metadata
`publish_survey`	Publish a draft survey to start collecting responses
`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 results
`get_survey_responses`	Get paginated individual responses with explanations and demographics
`list_surveys`	List and search your surveys with filtering by status, type, tags, and more
`add_respondents`	Extend a completed survey with additional respondents without recreating it

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

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.

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

Supported question types

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

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

Option formats

Polls support various content types for options:

Text — Plain text options
Media URL — Images or videos via URL
ASIN — Amazon product by ASIN for comparison
Image set — Multiple images grouped together
Mockup — Product listing mockups (SERP or listing style)

All options within the same question must use the same content type.

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"

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.

Getting started

Tools

API Reference

Surveys

Tags

Traits

Playbooks

Projects

Media

What is MCP?

Connect to the MCP server

Claude (claude.ai, desktop, and mobile)

Claude Code

Cursor

ChatGPT

Notion

OpenClaw

Other MCP clients

Available tools

Survey management

Poll URL builder

Media

Discovery and organization

Help

Supported question types

Usage examples

Supported countries

Sample sizes

Option formats

Authentication

OAuth (automatic)

API keys

Need help?

MCP documentation

Help center article

Contact support

Getting started

Tools

API Reference

Surveys

Tags

Traits

Playbooks

Projects

Media

​What is MCP?

​Connect to the MCP server

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

​Claude Code

​Cursor

​ChatGPT

​Notion

​OpenClaw

​Other MCP clients

​Available tools

​Survey management

​Poll URL builder

​Media

​Discovery and organization

​Help

​Supported question types

​Usage examples

​Supported countries

​Sample sizes

​Option formats

​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

OpenClaw

Other MCP clients

Available tools

Survey management

Poll URL builder

Media

Discovery and organization

Help

Supported question types

Usage examples

Supported countries

Sample sizes

Option formats

Authentication

OAuth (automatic)

API keys

Need help?