QuestionPunk
Create and edit QuestionPunk surveys and AI interviews from a research brief, publish when you ask, and read responses and reports from studies your account can access.
Hosted MCP Server
npx add-mcp 'https://app.questionpunk.com/api/v1'Installs into Claude Code, Codex, Cursor and more
Documentation
Your research, in your assistant
Connect QuestionPunk to create survey drafts, refine questions, review branching logic, and work with research results your account can access.
Connect your account
You need a QuestionPunk account and permission to access the studies you want to use. Your existing plan limits apply. Your assistant or organization may restrict custom connectors.
- Open your assistant’s custom MCP connector settings.
- Name the connector QuestionPunk and enter
https://app.questionpunk.com/api/v1. - Select OAuth and automatic client registration when offered. Sign in to QuestionPunk and review the requested permissions.
- Start a new conversation with QuestionPunk enabled. Ask: “Verify my QuestionPunk connection, then create an unpublished draft called Onboarding feedback.”
Install in your assistant
Add to Cursor Install in VS Code Install in VS Code Insiders
The buttons open the editor with QuestionPunk filled in. Sign in to QuestionPunk when it asks.
- ChatGPT: open QuestionPunk in the Plugin directory and connect it.
- Claude: Customize → Connectors → Add custom connector, and choose automatic registration.
- Claude Code:
claude mcp add --transport http questionpunk https://app.questionpunk.com/api/v1, thenclaude mcp login questionpunk. - Codex:
codex mcp add questionpunk --url https://app.questionpunk.com/api/v1, thencodex mcp login questionpunk. - VS Code, without the button: run MCP: Add Server, choose HTTP and enter
https://app.questionpunk.com/api/v1; VS Code opens the sign-in in your browser. - Gemini CLI:
gemini mcp add --transport http questionpunk https://app.questionpunk.com/api/v1, then/mcp auth questionpunkinside Gemini CLI. - Gemini: Settings → Connected Apps → Custom apps → Add a custom app, then enter the address. Google offers custom apps to personal accounts in the US.
- Grok: at grok.com/connectors, choose New Connector → Custom, enter the address and sign in.
- Zed: Settings → AI → MCP Servers → Add Remote Server, then enter the address.
Your workspace’s policies decide whether you can add QuestionPunk in ChatGPT or Claude.
What you can do
- Create a draft from a brief or a template.
- Read a saved study, edit questions and their text in the survey's existing languages (adding a new language isn't available through the connector), and configure branching.
- Review a draft and publish it when you explicitly request publication.
- With response permission, retrieve counts, reports, cross-tabulations, comments, and export links.
- Search your studies by title or description and read a study's questions, which ChatGPT also uses for company knowledge and deep research.
Try:
- “@QuestionPunk create an unpublished draft survey with five questions about onboarding.”
- “@QuestionPunk summarize the completed responses to my latest study, with sample sizes.”
- “Review my draft in QuestionPunk for leading questions and confusing branching.”
- “Publish my reviewed QuestionPunk draft and give me the link to send to participants.”
Participants answer through the study’s QuestionPunk link, which the connector returns when it publishes or reads a study. This researcher connector does not answer studies on a participant’s behalf or purchase recruitment.
Permissions and data
Each connection uses your own OAuth authorization. Reading your studies and templates needs only read. Creating, editing and publishing also require write. Response and reporting tools require responses:read. QuestionPunk AI operations require ai. If a connection lacks a permission, its write, response and AI tools still appear, and calling one asks you to reconnect and approve it.
Selected account information, study content, and requested research results are returned to the assistant you connect. Only connect an assistant you want to receive that data. The assistant provider’s own terms and retention policies apply to its copies. QuestionPunk’s processing is described in our privacy policy and terms.
Disconnect a grant in QuestionPunk Settings → Integrations → Connected apps. Revoking access prevents further use of that grant; it does not erase data already returned to an assistant.
Troubleshooting
- If sign-in expires or a grant is revoked, reconnect using the host’s OAuth flow. Never paste tokens into a chat.
- If a tool is missing, check the requested scopes and refresh the host’s connector catalog, then start a new conversation.
- If the assistant reports that QuestionPunk is limiting requests, wait a minute and try again.
- If a write times out, read the saved study before retrying. Keep its returned ID to avoid duplicate drafts.
- If an export cannot download in the host, open the study in QuestionPunk and export there.
- OpenClaw shared channels require separately authorized requester identities. Muse setup remains a pilot pending host compatibility verification.