How to Use the SurveySparrow MCP in Claude

Q: Can I use this server for testing?

Absolutely. You can test workflows by using tools like listsurveys to fetch a list of existing surveys on your account before running any complex logic.

Q: If I run a webhook test, where does that data go?

The listactivewebhooks tool shows you the configured destinations for your SurveySparrow notifications. This tells you exactly which services are receiving the real-time data.

Q: What if I need to clean up contacts?

You can use removecontact to delete a contact record from SurveySparrow directly via your agent, keeping your database clean and accurate.

Get real feedback from your users and customers using Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SurveySparrow MCP to Claude Desktop

Create your Vinkius account to connect SurveySparrow to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SurveySparrow with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage contacts directly from the chat

The `create_contact` tool lets you add new user records right where you're working. This is useful for logging initial feedback before running a full survey campaign. The `get_contact_info` tool pulls specific details on any contact, letting your agent check if they participated in past surveys or need follow-up info.

Retrieve and structure survey data

Use the `list_survey_responses` tool to pull a list of completed submissions. You can then use `get_survey_details` to see exactly what fields were collected for that specific campaign. This means you don't have to guess what data is available; your agent knows precisely which questions were asked and how the responses map.

Monitor live workflows and audience lists

The `list_active_webhooks` tool checks your current notification setup, so you always know where survey data is being sent. You can also use `list_crm_contacts` to pull the master list of people who should receive an invite. This gives your agent a full picture of both the audience size and the live integration points for SurveySparrow.

Setup guide

Set up SurveySparrow MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The SurveySparrow MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the SurveySparrow MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under surveysparrow-mcp.

json

{
  "mcpServers": {
    "surveysparrow-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by SurveySparrow. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect SurveySparrow now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about SurveySparrow MCP in Claude Desktop

The MCP Server lets your local or web-based agent run tools against your SurveySparrow account. It's like having the API live in the chat window, letting you interact with real data without leaving Claude.

Absolutely. You can test workflows by using tools like `list_surveys` to fetch a list of existing surveys on your account before running any complex logic.

It accesses operational data, specifically contact information and survey response payloads. It helps manage who gets surveyed and what they answered.

The `list_active_webhooks` tool shows you the configured destinations for your SurveySparrow notifications. This tells you exactly which services are receiving the real-time data.

You can use `remove_contact` to delete a contact record from SurveySparrow directly via your agent, keeping your database clean and accurate.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python