How do I connect Refiner to my AI client?

You subscribe to the MCP on Vinkius and enter your Refiner API key. Once connected, you can use it in any compatible client like Claude or Cursor.

Can I trigger surveys automatically?

Yes. You can use the track event capability to log user actions, which can then trigger micro-surveys you have configured in Refiner.

What clients are compatible with this MCP?

This MCP works with any client that supports the Model Context Protocol, including Claude, Cursor, Windsurf, and VS Code.

Do I need to manage my own API hosting?

No. Vinkius hosts the MCP and manages the credentials for you, so it is ready to use immediately after you connect.

Can I update user information through the AI?

Yes. You can use the identify user capability to update technical traits for specific contacts.

Can I check the responses for a specific survey via AI?

Yes! Use the list_refiner_responses capability and provide the Survey UUID. Your agent will retrieve the latest submissions, which you can then ask the AI to summarize or filter by date.

How do I identify a user and add custom traits using the agent?

Use the identify_refiner_user action. Provide the User ID or Email and a JSON string of traits (e.g., '{"plan":"pro"}'). This helps you target surveys based on specific user metadata.

Is it possible to track a custom event to trigger a survey via AI?

Absolutely. Use the track_refiner_event capability. Provide the event name and the user's ID/Email. When this event is logged, Refiner will trigger any surveys you have configured for that specific action.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Refiner to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run surveys and analyze user sentiment through natural conversation.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 8 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 8 available through Refiner.

01
Check refiner status
Checks the current status of the Refiner API to ensure your connection is active.
02
List refiner contacts
Retrieves a list of all product contacts stored in your Refiner account.
03
Get refiner contact
Fetches specific details for a single contact in Refiner.
04
Identify refiner user
Identifies a user or updates their technical traits within the Refiner system.

Capability set02 / 02

05-08

4 capabilities in this set.

Part of 8 available through Refiner.

05
List refiner responses
Lists survey responses so you can review what users are saying.
06
List refiner segments
Provides a list of your defined user segments.
07
Track refiner event
Logs a specific user event to trigger programmed micro-surveys.
08
List refiner surveys
Shows all active in-app, email, and link surveys in your account.

Real work

What teams actually run

NPS Monitoring

Ask your agent for the latest NPS scores to see how a recent update affected user sentiment.

Automated Feedback Loops

Trigger a micro-survey immediately after a user completes a specific action like an upgrade.

User Troubleshooting

Check a specific user's traits and recent survey responses to understand their experience.

Segment Auditing

Verify that your user segments are correctly populated and responding to surveys.

Automate a task

Put Refiner to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Refiner works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Refiner to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

847ms average. Fast in production.

Refiner is checked daily against the live service.

Daily averagePeak 1067ms

Oct 3Today

Fastest day: 724ms
Slowest day: 1067ms
14-day trend: Improving-11%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Refiner, so you can see the experience inside your AI.

It does not authenticate your account with Refiner. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Refiner Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_oZTOqi44qYgTigtg1YbvsSD1RxDyuO25XsEYbPFL/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Refiner capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "refiner-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_oZTOqi44qYgTigtg1YbvsSD1RxDyuO25XsEYbPFL/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Refiner in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Refiner owners hand off.

This MCP is built for teams that need to bridge the gap between user behavior and product decisions.

01
Product Managers
They use the AI to quickly check sentiment and survey results without digging through dashboards.
02
Growth and Marketing
They automate event tracking and verify segment metadata through the agent.
03
Customer Success
They monitor individual user feedback and verify identity traits via chat.

FAQ

Questions Refiner owners ask.

01
How do I connect Refiner to my AI client?
You subscribe to the MCP on Vinkius and enter your Refiner API key. Once connected, you can use it in any compatible client like Claude or Cursor.
02
Can I trigger surveys automatically?
Yes. You can use the track event capability to log user actions, which can then trigger micro-surveys you have configured in Refiner.
03
What clients are compatible with this MCP?
This MCP works with any client that supports the Model Context Protocol, including Claude, Cursor, Windsurf, and VS Code.
04
Do I need to manage my own API hosting?
No. Vinkius hosts the MCP and manages the credentials for you, so it is ready to use immediately after you connect.
05
Can I update user information through the AI?
Yes. You can use the identify user capability to update technical traits for specific contacts.
06
Can I check the responses for a specific survey via AI?
Yes! Use the list_refiner_responses capability and provide the Survey UUID. Your agent will retrieve the latest submissions, which you can then ask the AI to summarize or filter by date.
07
How do I identify a user and add custom traits using the agent?
Use the identify_refiner_user action. Provide the User ID or Email and a JSON string of traits (e.g., '{"plan":"pro"}'). This helps you target surveys based on specific user metadata.
08
Is it possible to track a custom event to trigger a survey via AI?
Absolutely. Use the track_refiner_event capability. Provide the event name and the user's ID/Email. When this event is logged, Refiner will trigger any surveys you have configured for that specific action.

Explore

More in Productivity

Connect Refiner to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Check refiner status

List refiner contacts

Get refiner contact

Identify refiner user

05-08

List refiner responses

List refiner segments

Track refiner event

List refiner surveys

What teams actually run

NPS Monitoring

Automated Feedback Loops

User Troubleshooting

Segment Auditing

Building your own app? The connector is yours to use.

Refiner Connector

Claude Desktop

Product Managers

Growth and Marketing

Customer Success

How do I connect Refiner to my AI client?

Can I trigger surveys automatically?

What clients are compatible with this MCP?

Do I need to manage my own API hosting?

Can I update user information through the AI?

Can I check the responses for a specific survey via AI?

How do I identify a user and add custom traits using the agent?

Is it possible to track a custom event to trigger a survey via AI?

Surveypal AI Connector

Data Pipeline Prover AI Connector

Zenloop AI Connector

CustomerGauge AI Connector

Suggestions

Alchemer AI Connector

User-Agent Parser AI Connector

SurveyMonkey AI Connector

Hevo Data (ETL & Data Pipeline) AI Connector