Overview
Unify MCP provides tools for running agents, loading identity and data for context, and calling Unify’s public APIs. Every tool call is scoped to the Unify user and tenant that authenticated the connection. A tool can only read or act on data that user can already see in Unify.Agent tools
Userun_agent to start work, then use the other agent tools to monitor,
continue, cancel, and read runs.
run_agent
Starts Unify’s general-purpose agent on a natural language task, using the same underlying agent as chat in Unify. Tasks can include research, list building, sequence preparation, and CRM updates. Returns a run ID and a conversation link immediately while the agent works in the background.An existing conversation started through
run_agent to continue. Omit this
field to start a new conversation. The conversation must belong to the
authenticated user and have no run already in progress.Example call
Example response
poll_agent
Checks the status of a run started byrun_agent. Keep calling this while
the run is PENDING.
When input is needed, a compatible client can display an interactive question
dialog. Answering it resumes the run and returns PENDING. If the tool returns
CLARIFICATION_NEEDED, present the returned questions and call answer_question
with the user’s answers before polling again.
Status values:
Example response (still running)
answer_question
Answers every question from aCLARIFICATION_NEEDED run and resumes it.
Pass the questions back exactly as poll_agent returned them. The tool
validates that the submitted answers line up with the pending questions
before resuming the run.
Example call
read_agent_results
Reads the final answer or error from a terminal run (READY or ERROR).
Call poll_agent first. This tool errors if the run hasn’t reached a
terminal status yet.
Example response
cancel_agent
Stops an in-flight run started byrun_agent. It is safe to call after a run
has already finished.
list_agent_runs
Lists agent runs started throughrun_agent for the current user, newest
first.
Context and identity tools
get_me
Returns the authenticated Unify user’s profile and workspace identity. This tool does not require any input.load_datatable
Loads a Unify DataTable the calling user owns, including its metadata, columns, and a page of rows with a cursor for pagination.Only DataTables owned by the authenticated user are accessible. This tool
can’t load another user’s tables even within the same tenant.
load_mailbox_voice_profile
Loads the writing voice profile for a specific connected mailbox, the same profile Unify uses to personalize outbound copy in that mailbox’s voice.The mailbox must be connected and owned by the authenticated user, and must
already have an analyzed voice profile, otherwise the call errors.