# Refiner — MCP server on mcp.ai
> Connect your Refiner account and use 10 tools for forms and surveys straight from your AI agent. Connect with your own API key. Refiner is a customer feedback and survey tool designed to help businesses collect and analyze user insights.

By: mcp.ai · official
Page: https://mcp.ai/refiner

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_refiner?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/refiner/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/refiner/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/refiner/skill.md
Postman collection (v2.1): https://mcp.ai/refiner/postman.json

## Tools
- refiner_delete_contact(id?: string, email?: string) — Tool to delete a specific contact by its identifier. Provide either the user ID or email address to identify and delete the contact.
- refiner_get_account_info() — Retrieves Refiner account information including subscription plan, usage limits, and environment statistics. This action provides: - Current subscription plan and usage limits (MTU, MTE, MPV, MSR) - U
- refiner_get_contact(id?: string, uuid?: string, email?: string) — Retrieve detailed information about a specific contact using their ID, email, or UUID. Returns all stored attributes, segments, and account information.
- refiner_get_contacts(page?: integer, search?: string, order_by?: string, form_uuid?: string, page_cursor?: string, page_length?: integer, segment_uuid?: string) — Tool to retrieve a list of contacts from your Refiner account. Use when you need to filter or paginate through contacts.
- refiner_get_forms(list?: string, page?: integer, page_length?: integer, include_info?: boolean, include_config?: boolean) — Tool to retrieve a list of forms (surveys) from your Refiner account with optional filtering and pagination. Use when you need to list surveys by state, page, or include extra info/config.
- refiner_get_reporting(type: string, tag_uuids?: string[], form_uuids?: string[], segment_uuids?: string[], date_range_end?: string, date_range_start?: string, question_identifiers?: string[]) — Tool to retrieve aggregated reporting data for surveys including metrics and analytics. Use when you need survey analytics over a time range filtered by type, question identifiers, tags, forms, or seg
- refiner_get_responses(page?: integer, search?: string, include?: string, form_uuid?: string, form_uuids?: string[], page_cursor?: string, page_length?: integer, segment_uuid?: string, segment_uuids?: string[], date_range_end?: string, with_attributes?: boolean, date_range_start?: string) — Tool to retrieve all survey responses from your Refiner account with optional filtering and pagination. Use after confirming survey creation to pull response data.
- refiner_get_segments(page?: integer, page_cursor?: string, page_length?: integer) — Tool to retrieve a list of user segments from your Refiner account. Use when you need to view or paginate segments.
- refiner_track_event(id?: string, email?: string, event: string) — Tool to record a user event by name for a user identified via user ID or email. Use after confirming the identifier and event name.
- refiner_update_contact(id?: string, email?: string, account?: object, attributes?: object) — Tool to create or update a contact's attributes or account. Identifies a contact by `id` or `email` and updates their traits or account grouping. If the contact doesn't exist, it will be created autom

## Example prompts
- "What can I do in Refiner?"
- "Show me a summary of my Refiner account"

## Links
Docs: https://mcp.ai/docs/mcps/refiner
Website: https://mcp.ai/mcps/refiner