MCP & AI Agent Integration

Refiner
automation.

22 AI agent actions for Refiner — callable from any MCP-compatible runtime, Claude, Cursor, or Cerebral OS workflow. Use Refiner to pull reports, track KPIs, and surface insights on a schedule. Full governance, audit trail, and dry-run safety on every execution.

No credit card required
Live in production environments
<200ms median execution
Dry-run before production
Execution trace
live
22
actions
100%
governed
<200ms
latency
22
AI agent actions
8
Read operations
14
Write operations
4
High-risk actions (approval gated)
Analytics Refiner is a Analytics integration — use it to automate metrics tracking, reporting, and data analysis from any AI agent or MCP-compatible runtime.
Actions

What you can do
with Refiner.

Every action below is available as an MCP tool and a verb in Cerebral OS — callable from any AI agent, Claude, Cursor, Windsurf, or your own runtime via the BYOA API. All executions are governed, audited, and dry-run safe.

Get Response
refiner:get_response
Fetch a single survey response by ID with answer details.
Read Low risk
Get Segment
refiner:get_segment
Fetch a single user segment by ID with criteria and user count.
Read Low risk
Get Survey
refiner:get_survey
Fetch a single survey by ID with configuration and status details.
Read Low risk
Get User
refiner:get_user
Fetch a single user by ID with profile data and survey history.
Read Low risk
List Responses
refiner:list_responses
List survey responses with optional filtering by survey, user, score, and date.
Read Low risk
List Segments
refiner:list_segments
List user segments with optional filtering by name and status.
Read Low risk
List Surveys
refiner:list_surveys
List surveys with optional filtering by status and type.
Read Low risk
List Users
refiner:list_users
List users with optional filtering by email, segment, or attributes.
Read Low risk
Create Response
refiner:create_response
Create a new survey response for a user.
Write Medium risk
Create Segment
refiner:create_segment
Create a new user segment with specified criteria.
Write Medium risk
Create Survey
refiner:create_survey
Create a new survey with specified configuration.
Write Medium risk
Create User
refiner:create_user
Create a new user in Refiner with profile data and attributes.
Write Medium risk
Delete Response
refiner:delete_response
Permanently delete a survey response.
Write High risk
Delete Segment
refiner:delete_segment
Permanently delete a user segment.
Write High risk
Delete Survey
refiner:delete_survey
Permanently delete a survey and all its associated responses.
Write High risk
Delete User
refiner:delete_user
Permanently delete a user and all their associated survey responses.
Write High risk
Track Event
refiner:track_event
Track a custom event for a user to trigger surveys or update segments.
Write Medium risk
Trigger Survey
refiner:trigger_survey
Trigger a survey to be shown to a specific user.
Write Medium risk
Update Response
refiner:update_response
Update an existing survey response.
Write Medium risk
Update Segment
refiner:update_segment
Update an existing user segment's configuration.
Write Medium risk
Update Survey
refiner:update_survey
Update an existing survey's configuration and settings.
Write Medium risk
Update User
refiner:update_user
Update an existing user's profile data and attributes.
Write Medium risk
MCP & Runtime API

Call Refiner
from any AI agent.

Any AI agent — Claude, Cursor, LangChain, AutoGen, or your own — can call Refiner actions through the Cerebral OS Runtime API. Governance, credentials, and audit trail fire automatically.

refiner:get_response READ
# Call via Runtime API
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "refiner:get_response",
    "args": {},
    "execution_id": "agent-001"
  }'
refiner:create_response WRITE
# Dry-run first — no production risk
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "refiner:create_response",
    "args": {},
    "execution_id": "agent-001",
    "metadata": {"dryRun": true}
  }'
Get your Runtime API key at app.cerebralos.com/signup — 1,000 free executions, no credit card required.
AI agent examples

What your AI agent
can do with Refiner.

Real patterns your AI agent can execute via MCP or the Runtime API. Every action governed, dry-run safe, and fully audited.

Trigger
AI agent needs Refiner data
Call refiner:get_response via MCP or Runtime API
AI processes result and takes next action
Full execution logged to audit trail automatically
Trigger
Workflow needs to write to Refiner
Dry-run validates refiner:create_response before execution
Approval gate fires if risk level is high
Action executes with full governance — logged, audited, reversible
Trigger
Metric threshold reached
Pull report data
Surface insight with AI
Send digest to Slack
How it works

Every Refiner action
governed end-to-end.

Cerebral OS isn't a connector. It's the execution layer that sits in front of Refiner — adding governance, dry-run safety, and a full audit trail to every operation.

Governance first
Every verb carries a risk classification. High-risk writes require explicit approval gates before they execute in production.
Dry-run safe
Simulate any Refiner action before it touches production. See exactly what would happen before a single real call is made.
Immutable audit trail
Every Refiner action is logged — what ran, what changed, who approved it, when it happened. Full history on every verb, forever.
Connect with

Refiner works best
alongside these.

Build multi-step workflows that connect Refiner to the rest of your stack. All governed. All audited.

Refiner integration

Start free.
No credit card required.

Start free with 1,000 runs — no credit card required. Connect Refiner in minutes, dry-run every action before it touches production, full audit trail on everything.

Start free — 1,000 runs Browse all integrations →