SurveyNinja

Quick start | Skills | Tools | What to ask | Connecting

The SurveyNinja MCP server and ready-made skills for your AI assistant. Describe a survey in plain words and the assistant builds it in your account, checks it before launch, reads the responses and prepares a report you can send.

Works in Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex, Gemini CLI and other assistants that connect to remote MCP servers. Every SurveyNinja plan includes it, Free too.

You:  Build a survey for our repair shop customers: rate the work and collect

contacts for a follow-up visit. AI: ✓ picked question types ✓ built 7 questions and 2 branches ✓ applied a theme The draft is ready and does not open by its link yet. Publish it?

Quick start

1. Have a SurveyNinja account. Sign up for free if you don't have one.
2. Add the server https://mcp.surveyninja.io/mcp/v1 to your assistant. Steps for each assistant are below.
3. Allow access. Sign in to SurveyNinja when the assistant asks, choose a workspace and click Allow access. Most assistants need no key; for the rest, use an API key as shown below.
4. Ask: “Show my surveys and how many responses came in this week.”

Claude Code: everything in one install

The plugin adds the MCP server and every skill at once:

/plugin marketplace add surveyninjaio/surveyninja-mcp

/plugin install surveyninja@surveyninja

Then type /mcp, select the SurveyNinja server and sign in. The plugin is the plugin/ folder: the server and a copy of the skills, nothing else. Only the server, without the skills:

claude mcp add --transport http surveyninja https://mcp.surveyninja.io/mcp/v1

Claude and ChatGPT

Claude on the web or in the desktop app: Settings → Connectors → Add custom connector. Enter a name, for example SurveyNinja, and the server address, click Add, then Connect, and allow access in SurveyNinja. On Claude Team and Enterprise an organization owner adds the connector first, then each member connects it.

ChatGPT: turn on developer mode in the ChatGPT settings (it is available on some ChatGPT plans), create a connector with the server address and OAuth authentication, then allow access in SurveyNinja.

Other assistants

One click:

Cursor

Add the server to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json for one project, then open the MCP section in the Cursor settings and sign in to the surveyninja server:

{

"mcpServers": { "surveyninja": { "url": "https://mcp.surveyninja.io/mcp/v1" } } }

VS Code

Add the server to .vscode/mcp.json in your project, start it from the file and sign in when VS Code asks. The server works in GitHub Copilot Chat in agent mode.

{

"servers": { "surveyninja": { "type": "http", "url": "https://mcp.surveyninja.io/mcp/v1" } } }

Gemini CLI

As an extension, with the server and the skills at once:

gemini extensions install https://github.com/surveyninjaio/surveyninja-mcp

Or only the server, in ~/.gemini/settings.json:

{

"mcpServers": { "surveyninja": { "httpUrl": "https://mcp.surveyninja.io/mcp/v1" } } }

If Gemini CLI does not offer to sign in by itself, run /mcp auth surveyninja.

Codex

Add the server to ~/.codex/config.toml:

[mcp_servers.surveyninja]

url = "https://mcp.surveyninja.io/mcp/v1"

Then run codex mcp login surveyninja: SurveyNinja opens in the browser, and you click Allow access. No key goes into the file. In the Codex app, add the server under Settings → MCP servers as Streamable HTTP and select Authenticate.

Any other client

Any client that connects to remote MCP servers over Streamable HTTP can use the same address. If it supports MCP sign-in (OAuth), it opens SurveyNinja for you to allow access. If it does not, pass an API key in a header:

Authorization: Bearer YOUR_API_KEY

The same configs as files are in clients/, and every step with troubleshooting is in docs/connect.md.

At a glance

What it can do

Surveys. Create a survey from scratch, from a template or with AI. Edit questions, logic, design and settings, then publish.

Responses. Read responses, tag them and keep the account clean.

Reports. Summary, report, report with filters and AI report. Exports to CSV, Excel, Word, SPSS and PDF, public links to share results.

Delivery. Notifications, webhooks, integrations and invitations to the team.

The full list by section is in docs/tools.md, starter phrases in docs/prompts.md.

Skills

A skill is a ready-made playbook for the assistant. You ask “sort out the open-ended answers”, and the skill tells it which tools to call, in what order and how to present the result. Skills are text instructions with no code: nothing gets installed or run. Each one is also on surveyninja.io/skills with examples of the result.

Build and share

Check before launch

Understand results

Deliver responses

| New response notifications | Sets up where new responses are announced, by email or in Telegram, and fixes it when they stop arriving | [ZIP](https://surveyninja.io/skills/answer-notificati