Connect Refiner to Your AI Agent

Read survey responses, inspect reporting metrics, and tag selected feedback or maintain contact records. Ask your connected AI assistant to explain the results or carry out the specified operation.

12 tools API key

Try a Refiner Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Refiner

Summarize Survey Feedback

Read filtered responses and extract recurring themes.

/oo Refiner: List Refiner responses for form [form UUID] from [start date] to [end date], then summarize returned themes with response IDs.

Compare Survey Metrics

Request a specified reporting family over a chosen population.

/oo Refiner: Get Refiner reportType nps for forms [UUIDs] between [dates], then explain the returned metrics and their scope.

Tag Selected Feedback

Apply a supplied tag to one known response.

/oo Refiner: Apply Refiner tag [tag] to response [response UUID].

Start Working with Refiner

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Refiner

    Connect with a Refiner API key from Integrations > Rest API.

    Connect Refiner →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Refiner API key with workspace survey access.
  • Response lists and metric reports are separate. Select forms, dates, or segments explicitly to keep summaries comparable.

Refiner Tools

Refiner connects supported service operations to your AI assistant. Read survey responses, inspect reporting metrics, and tag selected feedback or maintain contact records.

Survey Data

Read forms, segments, responses, and reporting metrics.

Contact and Feedback Changes

Maintain contact details, track events, or tag responses.

12 tools

Get Account Info

Retrieve the current Refiner account, project, and subscription information.

refiner.get_account_info

List Contacts

List contacts available in the connected Refiner workspace.

refiner.list_contacts

Get Contact

Retrieve a single Refiner contact by id, email, or uuid.

refiner.get_contact

Identify User

Create or update a Refiner contact using the official identify-user endpoint.

refiner.identify_user

Track Event

Track a product event for a Refiner contact.

refiner.track_event

List Forms

List forms in the connected Refiner workspace.

refiner.list_forms

List Segments

List segments in the connected Refiner workspace.

refiner.list_segments

List Responses

List survey responses collected in Refiner.

refiner.list_responses

Tag Response

Apply a tag to a Refiner response.

refiner.tag_response

Get Reporting

Retrieve Refiner reporting metrics for forms, segments, and questions.

refiner.get_reporting

Add Contact To Segment

Add a Refiner contact to a manual segment.

refiner.add_contact_to_segment

Remove Contact From Segment

Remove a Refiner contact from a manual segment.

refiner.remove_contact_from_segment

Frequently Asked Questions

Which metrics are supported?

Reporting supports nps, csat, score, responses, views, and completion families.

Can I narrow feedback by form?

Yes. Response lists support formUuid plus date, contact, segment, and status filters.

Does reporting return individual feedback text?

Reports provide metrics; use list_responses to analyze individual response content.

Connect Refiner

About Refiner ↗