> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firsttouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# Find MCP Enrollment

> Call get_guide with topic=dynamic_actions for the complete one-contact workflow.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>Find existing MCP Dynamic Actions enrollments for one contact, including completed or canceled history, so the customer can decide whether to continue an enrollment or start a new one.</li>
<li>If no candidate is returned and the requested action has all required identity and target data, create the new action without asking the customer to confirm the same request again.</li>
<li>If any candidate is returned, the MCP client must stop and ask the customer which enrollment to continue or whether to start a new sequence;<br />never infer that choice from status or flowPlanDisplayStatus, even when the match is completed, canceled, failed, pending, or in-progress.</li>
<li>Search by enrollmentId, prospectId, email, LinkedIn URL, phone, HubSpot contact id, or name with optional companyDomain.</li>
<li>This searches MCP Dynamic Actions enrollments across dynamic action flow plans;<br />candidates include sourceDescription when known, flowPlanId, raw runtime status, hasFailedAction, flowPlanDisplayStatus, and a lightweight root with nodeId, type, payload.subject, payload.subjectType, next, onConnectionAccepted, and onConnectionTimeout.</li>
<li>Use sourceDescription as helpful context when asking whether to continue or start a new sequence, but never infer that decision.</li>
<li>Use root to choose an email reply or new thread on the requested branch.</li>
<li>Use get_flow_enrollment after selecting an enrollment only when complete enrollment/action/task details are needed.</li>
</ul>
</details>



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.firsttouch.com/llms.txt).
