MCP App Store
by KeenEthics
FirstTouch icon

FirstTouch MCP Server for ChatGPT

By First Touch Inc

Overview

FirstTouch helps go-to-market teams run outbound workflows from ChatGPT. Users can build audiences from supplied contacts or a connected HubSpot list, author multi-step outreach flow plans made of email, call, manual, and branch actions, publish a flow once its configuration is valid, start selected awaiting contacts, and follow enrollment progress and the human tasks those flows create. Built-in workspace guidance keeps flow authoring aligned with the fields each tool actually accepts.

How to connect

  1. ChatGPT: Open the FirstTouch listing in the ChatGPT app directory and choose Connect. ChatGPT listing FirstTouch exposes 86 tools here.

Tools

activate_social_engagement_monitored_profile

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Resumes one saved Social Engagement monitored profile using request.profileId from list_social_engagement_monitored_profiles. Requires team admin access and paid or trial access. Collection requires the owning signal to be enabled and unlocked and sufficient credits; otherwise the profile remains suspended. Collection, including requested history, can consume FirstTouch credits. Returns the owning signal and its linked Flow Plan. Other profiles and signals retain their state; this does not publish a flow.

add_audience_contacts

ChatGPT
Adds contacts to an existing audience. Before calling, call get_workspace_guide with topic=audiences. Each contact requires an email or a first name, last name, and company domain.

add_contact_action

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Append exactly one action to an existing single-contact sequence created through create_contact_sequence or the earlier Dynamic Actions tool. Requires its exact enrollmentId. Never creates a new enrollment and cannot append to ordinary reusable Flow Plan enrollments. Only in-progress and completed sequences can be extended; completed sequences reopen automatically. Pending, failed, and canceled sequences are rejected. This adds a step to the sequence, not an unconditional immediate send: its position, delay, branch, and approval determine when it can run. Reuse the enrollment-wide email inbox and LinkedIn sender; another sender requires create_contact_sequence. For email, subjectType is required: new_thread needs subject; reply needs a prior email on the selected branch and inherits its subject. Use action.appendTarget for an existing LinkedIn connection's accepted or timeout branch. Read get_guide with topic=workflow_selection before choosing this workflow, then topic=dynamic_actions before writing. First call get_current_user and require authenticated access and granted flow:write for the active team. Use find_contact_data with every known identity unless verified enrichment was already returned in this conversation, then find_mcp_enrollment to resolve sequence continuity. Provide final content using exactly one typed action. Approval defaults to enabled; action.isHumanApprovalRequired=false is allowed only when the customer explicitly requests it. Actions may send messages, consume FirstTouch credits, or create user tasks. Execution follows approval, delay, branch, account readiness, and sender capability checks. Use the returned enrollmentId with enrollment inspection and cancellation tools; flowPlanId is not permission to modify the shared flow structure.

add_dynamic_action

ChatGPT
Deprecated compatibility tool. Creates a new contact sequence when enrollmentId is omitted, or appends one action to the specified sequence. Use create_contact_sequence for a new sequence and add_contact_action to extend one. Current sender, ownership, and approval rules apply.

add_exclusions

ChatGPT
Requires team owner/admin access. Adds contact email exclusions, company domain exclusions, and/or connected CRM exclusion segments. contacts accepts only email addresses; companies accepts only domains; crmSegments accepts numeric connected-segment ids. Before making changes, the tool verifies that every segment exists, is accessible, and has a supported type. Validation reports the zero-based array indexes of every invalid item so the input can be corrected and retried. The complete mixed mutation is atomic: if any contact, company, or segment cannot be applied, none of the requested changes are committed. For CSV input, parse email rows into contacts and domain rows into companies. Up to 1000 contact and company values combined and up to 10 segment ids may be submitted per call, so split larger files into batches.

add_manual_flow_enrollment

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Add one contact/prospect to an existing flow. For a plain request such as 'Add contact X to flow Y', omit enrollmentMode so the flow plan's processing strategy determines the outcome; a draft flow adds the contact to Awaiting. Set enrollmentMode=enroll only when the user explicitly asks to enroll or start the contact immediately; the flow must be published. Set enrollmentMode=manual only when the user explicitly asks for manual enrollment or to add the contact to Awaiting without starting it. The flow plan is specified only by top-level flowPlanId.

add_social_engagement_monitored_profile

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Adds one LinkedIn profile or company page to a selected existing Social Engagement signal. Requires team admin access and paid or trial access. Supply request.signalId from list_social_engagement_signals; custom signals supply their fixed tracking mode, so omit engagementType or supply the matching mode. Omitting signalId uses the legacy system signal and requires engagementType. loadHistory defaults to false. Use create_social_engagement_signal for a new independent signal and Flow Plan. Eligible collection can consume credits and run asynchronously while the flow is draft. The response includes socialEngagement.flowPlan and socialEngagement.signal for the owning signal. The selected signal must be enabled before adding a profile; otherwise the operation returns an error. Use update_social_engagement_signal with isEnabled=true first when enabling collection is authorized. Does not publish its flow. Each seat allows five monitors across the team, including paused monitors.

approve_tasks

ChatGPT
Approve selected tasks or all matching todo tasks using the UI bulk completion behavior, up to 1000 per call. Use allTasks=true directly for all matching tasks; use taskIds for a specific selected set. Approves every grouped action in section_approval tasks, logs call tasks, and marks manual tasks done. No taskHash or action decisions are required; the current task content is approved at execution time. Access and readiness checks still apply. Returns an outcome for every selected task; failures do not undo successful tasks. In allTasks mode, defaults to the current user's tasks, selects newest first, and hasMore indicates additional matching tasks were not selected. Repeat for remaining todo tasks, using ignoreTaskIds to exclude failures if needed.

attach_audience_to_flow

ChatGPT
Attaches an existing audience to an existing flow plan. Before calling, call get_workspace_guide with topic=audiences.

cancel_awaiting_flow_items

ChatGPT
Cancel selected Awaiting candidates from an existing flow without canceling active enrollment queue items. First call get_flow_workspace for the flow, then pass exact awaiting.items[].candidate_id values; ids look like enrollment_candidate_*. At least one candidate id is required, so this tool never interprets omitted ids as cancel all. Do not use this for the read-only MCP Dynamic Actions flow plan.

cancel_flow_enrollments

ChatGPT
Cancel specific enrollment queue items in a flow, or all cancellable queue items when queueItemIds is omitted.

complete_task

ChatGPT
Execute the primary action for a todo task. For call tasks, log the call; for manual tasks, mark the task done. For section_approval tasks, resolve every grouped action as approved or skipped: call preview_task immediately before this tool, copy task.payload.task_hash into taskHash, and submit exactly one decision for every id in actionGroup.expectedActionIds. Do not call when readiness.canExecute=false.

create_audience

ChatGPT
Creates a FirstTouch audience from supplied contacts or a HubSpot contact list. Before calling, call get_workspace_guide with topic=audiences.

create_audience_from_profiles

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Create a manual audience from already fetched persisted prospect ids, for example selected prospectId values returned by enrichment/discovery tools. For a contact-discovery workflow, call get_guide with topic=contact_discovery first. Does not continue search and does not charge discovery credits.

create_contact_sequence

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Create a new sequence for exactly one contact with its first action and start processing it immediately. This is not a draft-only operation: an eligible action can execute when approval and scheduling permit. Always creates a new enrollment; never appends to an existing enrollment. Use add_contact_action with enrollmentId when continuing a sequence. For multiple requested steps, call this tool once for the first action, then add_contact_action once per later step with the returned enrollmentId. A new email sequence uses new_thread and requires a final subject. The first email and LinkedIn actions establish the enrollment-wide inbox and LinkedIn sender. Use another sequence when the customer requests a different sender. Read get_guide with topic=workflow_selection before choosing this workflow, then topic=dynamic_actions before writing. First call get_current_user and require authenticated access and granted flow:write for the active team. Use find_contact_data with every known identity unless verified enrichment was already returned in this conversation, then find_mcp_enrollment to resolve sequence continuity. Provide final content using exactly one typed action. Approval defaults to enabled; action.isHumanApprovalRequired=false is allowed only when the customer explicitly requests it. Actions may send messages, consume FirstTouch credits, or create user tasks. Execution follows approval, delay, branch, account readiness, and sender capability checks. Use the returned enrollmentId with enrollment inspection and cancellation tools; flowPlanId is not permission to modify the shared flow structure.

create_flow_plan

ChatGPT
Creates a reusable flow plan. Before calling, call get_workspace_guide once with topic=flow_creation and once with topic=flow_root. A complete flow.root action tree is required. Every email and call outreach action always requires individual human approval before execution, including outreach to contacts who have not opted in. The Workspace MCP forces is_human_approval_required=true and this requirement cannot be disabled.

create_social_engagement_signal

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Creates a named Social Engagement signal, its own draft Flow Plan, and zero or more monitored LinkedIn profiles/company pages. Requires team admin access and paid or trial access. The signal's tracking mode applies to all its profiles and cannot be changed. Collection starts asynchronously when eligible and can consume FirstTouch credits, even while the linked flow is draft; loadHistory can also consume credits. Each seat allows five nondeleted monitors across the team, including paused monitors. The generated flow starts in draft with manual enrollment; creation does not publish it, enroll contacts, or send outreach. Return signalId and flowPlanId for subsequent monitoring and flow configuration. This operation is not idempotent; inspect existing signals before retrying an uncertain result.

deactivate_social_engagement_monitored_profile

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Pauses one Social Engagement monitored profile using request.profileId from list_social_engagement_monitored_profiles. Requires team admin access. Retains its subscription and history; paused monitors still count toward capacity. Returns its owning signal and linked Flow Plan. Other profiles and existing enrollments/actions continue.

delete_audience

ChatGPT
Delete an existing audience. Before calling this tool, warn the user that deletion cannot be undone. Ask whether to cancel awaiting enrollments and whether to cancel enrollments already in progress if the user did not explicitly specify each choice. Both options default to true only after the user has been asked.

delete_flow_plan

ChatGPT
Permanently remove an existing flow plan. This tool cannot delete the MCP Dynamic Actions or HubSpot Custom Actions flow plans because they are system-managed. Before calling this tool, warn the user and obtain explicit confirmation: all enrollments in the flow will be canceled, the flow plan cannot be restored, and its audience will continue to exist.

delete_social_engagement_monitored_profile

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Removes one monitored profile subscription using request.profileId from list_social_engagement_monitored_profiles. Requires team admin access. This matches Remove for a profile in the UI. Stops future collection for this subscription and retains captured history; retained history may no longer be accessible through this subscription. The owning signal and Flow Plan are retained. Use deactivate_social_engagement_monitored_profile to pause instead. Other profiles and existing enrollments/actions continue.

discover_contacts

ChatGPT
CHARGED TOOL. Call get_guide with topic=contact_discovery before this tool. Each generated Boolean filter expression must be at most 255 characters, including spaces, quotes, operators, parentheses, and exclusion prefixes; inclusion/exclusion values for the same field share this budget. Role-title filters use exact matches; multiple values in the same title array match any listed value (OR). Include the requested title plus up to 5 equivalent variants when available and within this limit, prioritizing requested titles and preserving role and seniority, unless the user requests only specific exact titles. Reduce optional variants or split inclusion searches within the approved credit budget if needed; preserve other filters and never silently drop requested criteria. Load one contact discovery page and return nextSteps for audience creation, pagination, background import, flow attachment, or enrollment. For general discovery, suggest pageSize=1 first to return totalResultCount plus a preview contact. After a preview or prior page, use returned nextPage as nextToken and request only additional rows; do not restart the same search without nextToken. Reserves pageSize credits and charges 1 credit per returned profile row, up to 10 rows per call.

edit_task_action

ChatGPT
Edit one grouped action inside a todo section-approval task. Use preview_task first; use branchContext to distinguish Dynamic Actions paths and only send fields listed in actionGroup.actions[].editableFields.

enrich_company

ChatGPT
CHARGED TOOL. Find enriched company data by domain, website URL, or LinkedIn company URL. This consumes FirstTouch company enrichment credits. The enrichment result is not automatically applied or synchronized to any existing enrollment, Awaiting candidate, audience, HubSpot record, or saved prospect record. Tell the customer that nothing was injected automatically; a separate customer-requested write action is required to use the data elsewhere.

enrich_contact

ChatGPT
Enrich one identified person's professional profile for a business-related request. Returns available name, professional description, work experience, education, and languages. Fields may be missing. Provide linkedInUrl, work email, or firstName, lastName, and companyDomain. Costs 1 FirstTouch credit for a successful profile unlock; data already unlocked by the current team is not charged again. The result is not automatically applied or synchronized to any existing enrollment, Awaiting candidate, audience, HubSpot record, or saved prospect record. Tell the customer that nothing was injected automatically; a separate customer-requested write is required to apply the data elsewhere.

enrich_email

ChatGPT
Find one identified person's work email address for business communication. Provide linkedInUrl, or firstName, lastName, and companyDomain. Returns the available work email and catch-all status; a LinkedIn-based lookup may also return the matched professional profile. A lookup may return no match. Costs 2 FirstTouch credits for a successful email unlock; data already unlocked by the current team is not charged again. The result is not automatically applied or synchronized to any existing enrollment, Awaiting candidate, audience, HubSpot record, or saved prospect record. Tell the customer that nothing was injected automatically; a separate customer-requested write is required to apply the data elsewhere.

enrich_phone

ChatGPT
Find one identified person's work phone number for business communication. Provide linkedInUrl, or companyDomain with firstName or work email. Include lastName when known. Returns the available phone number, or no match when no number is found. Costs 7 FirstTouch credits for a successful phone unlock; data already unlocked by the current team is not charged again. The result is not automatically applied or synchronized to any existing enrollment, Awaiting candidate, audience, HubSpot record, or saved prospect record. Tell the customer that nothing was injected automatically; a separate customer-requested write is required to apply the data elsewhere.

enroll_awaiting_flow_items

ChatGPT
Starts selected awaiting items in a published flow plan. Before calling, call get_workspace_guide with topic=enrollments.

find_contact_data

ChatGPT
Call get_guide with topic=contact_identity for matching, identifier, conflict, trace, enrichment, and persistence guidance. Find free existing contact data for the current team from saved FirstTouch contacts, enrollments, awaiting Flow Plan candidates, and audience contacts. Saved-contact matches identify existing prospects but may not return stored email, LinkedIn, or phone fields; enrollment, awaiting-candidate, and audience matches can return stored channel data when available. Use when the user names a contact or provides partial identity. Send every identity detail already known (for example firstName and lastName alongside email or linkedInUrl): exact identifiers are preferred, while the other details provide fallback matching. This does not enrich, spend credits, or create enrollments. Duplicate contact data across sources is collapsed. For action workflows, a customer-supplied exact email, LinkedIn URL, or phone is a constraint; do not replace it with candidate data unless the customer confirms the final action target.

find_mcp_enrollment

ChatGPT
Call get_guide with topic=dynamic_actions for the complete one-contact workflow. Find existing MCP Dynamic Actions enrollments for one contact, including completed or canceled history, so the MCP client can resolve whether the requested action continues the current conversational sequence or starts fresh outreach. 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. When candidates are returned, reuse the exact enrollmentId for a related step in an enrollment created or selected earlier in the conversation, even if its status is completed. Omit enrollmentId for clearly new, fresh, separate, or unrelated outreach. Historical matches alone must not force a confirmation question. Ask only when multiple enrollments plausibly overlap, an existing current sequence may conflict with apparently fresh outreach, or the intended sequence or branch is unclear. Do not use status alone as the intent boundary: in-progress and completed enrollments can be extended, while pending, failed, and canceled enrollments cannot. Search by enrollmentId, prospectId, email, LinkedIn URL, phone, HubSpot contact id, or name with optional companyDomain. This searches MCP Dynamic Actions enrollments across dynamic action flow plans; 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. Use sourceDescription and root as context for sequence and branch selection. Use root to choose an email reply or new thread on the requested branch. Use get_flow_enrollment after selecting an enrollment only when complete enrollment/action/task details are needed.

get_contact_discovery_audience_import_status

ChatGPT
Get status for a contact discovery audience import. Saved prospect ids are omitted by default; set includeProspectIds when you need to recover partial results after a failed import.

get_contact_discovery_industry_values

ChatGPT
Return exact industry enum values for discover_contacts filters.current_company_primary_industry, filters.exclude_current_company_primary_industry, filters.current_company_industry, and filters.exclude_current_company_industry.

get_contact_trace

ChatGPT
Return a compact cross-system trace for a supplied identities array of at most 10 items: Flow Plans where a matching contact is awaiting or enrolled, audience memberships, enrollments, and readable tasks. For a selected contact, include every known supported identity as a separate array item: email, LinkedIn URL, phone, HubSpot contact id, and firstName, lastName, and companyDomain together when all three are known. Do not choose only one known identity. Each array item must contain exactly one direct identifier (email, LinkedIn URL, phone, or HubSpot contact id), or all of firstName, lastName, and companyDomain. This tool searches every item and returns the union of matching records, not one canonical contact. Every Flow Plan, audience, and enrollment includes matchedBy, showing the identity values that produced it. Use find_contact_data first for name-only searches or multiple matches. FirstTouch prospectId and enrollmentId are not accepted because they do not identify a contact across all trace sources. Each enrollment, awaiting-candidate, and audience-contact lookup is capped at 50 rows per identity; notes warns when a source reaches that cap and the trace may be incomplete. This is read-only and does not enrich, spend credits, or create an enrollment.

get_credits_usage

ChatGPT
Returns the current team credits account values. Reads the same billing account source used by the gateway credits balance API; contains no tokens or secret values.

get_current_user

ChatGPT
Returns the current FirstTouch user, active team, available teams, current-team permissions, and effective capability scopes. A team owner has full team-management rights in the current team; sender and billing capabilities are reported separately. Granted scopes are the source of truth for which MCP actions the current user can perform. Contains no access tokens, raw auth headers, or secret values.

get_exclusions

ChatGPT
Requires team owner/admin access. Returns a page of excluded contact emails and company domains, plus all connected CRM exclusion segments. Segment results include synchronization status and timestamps. Follow cursor until it is null to read every contact and company exclusion.

get_feature_costs

ChatGPT
Returns the current billing feature cost table. Contains no account balance, access tokens, or secret values.

get_flow_available_variables

ChatGPT
Returns canonical variables available for flow content, subjects, task text, and branch expressions.

get_flow_candidate

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Gets one enrollment candidate with its saved customVariables dictionary, status, contact identity, source, linked enrollment ids, and canEditCustomVariables. Use exact candidateId from list_flow_candidates or candidate_id from get_flow_workspace.awaiting.items; do not supply enrollmentId, queueItemId, or audience contact id. Saved keys may be absent from current definitions and are retained. Read flow definitions and usage separately through get_flow_workspace.customVariables.

get_flow_enrollment

ChatGPT
Get one enrollment/activity by id, including individual inbound email and LinkedIn replies with message content, tone, and received time; compact actions, tasks, warnings, interpretation notes, required follow-up action, and links. The notes explain how to assess deferred LinkedIn prospect enrichment and candidate account availability. Set includeFlowTree=true to inspect the root/tree stored on the enrollment; this snapshot can differ from the current flow-plan root after later edits. Omits the tree and enrollment.properties by default; action operationStatus is execution state, while taskStatus is the user-facing pending/done state.

get_flow_plan

ChatGPT
Returns the action tree and core settings for an existing FirstTouch flow plan.

get_flow_source_modes

ChatGPT
Returns supported source modes and required request fields for flow creation.

get_flow_workspace

ChatGPT
Get the current workspace for an existing flow: flow details, live details for its configured candidates, linked source status, estimated single-enrollment credit cost, awaiting contacts or signal events, enrollment counts/statistics, variable guidance, and available enrollment actions. candidateDetails is the source of truth for candidate account state; do not infer LinkedIn availability from the deprecated reassignment payload linkedin_account_id. Use this for flow-level enrollment statistics; use list_flow_plan_enrollments for this flow's page-style rows, list_enrollments for advanced multi-flow enrollment search, and get_flow_enrollment for one enrollment's actions/warnings.

get_guide

ChatGPT
Returns FirstTouch documentation as Markdown. Topics cover the domain overview, reusable flow creation, one-contact Dynamic Actions, contact discovery, audiences, enrollments, tasks and approvals, contact identity, and senders and capabilities.

get_linkedin_unibox_conversation

ChatGPT
Returns one synchronized FirstTouch LinkedIn Unibox conversation, its sender and participant context, and complete messages. Reading always uses mark_read=false, so inspection never changes unread state and does not trigger synchronization. Message output includes direction, timestamp, text, type, send status, and event/edit/delete/hidden indicators. Enrollment details, tasks, and activity-history payloads are intentionally excluded from this v1 response.

get_linkedin_unibox_counts

ChatGPT
Returns LinkedIn Unibox count buckets within the same accessible sender, search, and latest-message date scope. It returns allCount, hotCount, nurtureCount, unreadCount, and archiveCount. It does not accept tags, unreadOnly, or archived filters because those values are separate count buckets. This reads synchronized FirstTouch Unibox state and does not trigger synchronization.

get_outreach_queue_insights

ChatGPT
Explains the canonical causes, resolution ownership, affected action counts, and reliable timing across the filtered active Social Outreach Queue. Use status_category and resolution_mode to determine whether human action is required or FirstTouch expects work to resume automatically; null timing means no reliable estimate exists, and ready for processing does not mean immediate send because queue order, Work Schedule, and safety spacing still apply. The response preserves the canonical queue insight fields and authorized sender identities unchanged. This reads stored FirstTouch data only and performs no external requests.

get_social_engagement_config

ChatGPT
Returns the current FirstTouch Social Engagement setup for the team. Requires team owner/admin access. Includes whether linkedin_engagement is enabled/unlocked, the existing UI-linked Social Engagement flow plan, and monitored profile counts. Use this to refresh or inspect current state when no profile mutation was just performed; manage_social_engagement_monitored_profile already returns socialEngagement.flowPlan. Adding a monitored profile does not require this tool. Like the UI config read, this may initialize missing default signal config; it does not relink the signal flow.

get_social_engagement_signal

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Returns one Social Engagement signal's enabled/unlocked state, fixed tracking mode, linked Flow Plan, and profile counts scoped to that signal. Requires team owner/admin access and an explicit signalId from list_social_engagement_signals. Profile mutation tools already return socialEngagement.flowPlan and socialEngagement.signal. Adding a monitored profile does not require this tool. May initialize missing default signal configuration; it does not relink the signal flow.

get_team_metrics

ChatGPT
Returns FirstTouch team metrics using the same core filters as the metrics endpoints: UTC date range, flow plan/source ids, and team member user ids. Use this when the customer asks for team performance, actions sent, manual task counts, email or LinkedIn engagement, replies, sentiment, opportunities, meetings booked, or email/LinkedIn chart trends. By default it returns totals, actions, engagement, and opportunity metrics; request emailChart or linkedinChart only when the customer asks for trend/chart/bucket data. flowPlanIds map to the API source_ids filter. Team owners can omit userIds to include all team users; non-owners are scoped by the service to their own user. This does not export CSV rows or return individual opportunities.

get_user_credit_usage

ChatGPT
Returns credits spent by one user in the current team, with a breakdown by billing feature. Requires team billing access. The UTC date bounds are inclusive. Optionally filter attributed transactions by source: Mcp, WebApp, Extension, PublicApi, or Unknown.

get_workspace_guide

ChatGPT
Returns concise FirstTouch guidance for a workspace topic. Read the relevant topic before creating audiences, creating flow plans, building flow roots, starting enrollments, or reviewing tasks. Tool schemas remain the source of truth for exact fields.

list_audiences

ChatGPT
Lists audiences available for contact management and flow enrollment.

list_credit_transactions

ChatGPT
Lists the current team's committed credits transaction history with UTC date, billing feature, user, and source filters. Requires team billing access. Use userId to return the exact transactions attributed to one user. Results can include committed spend, purchases, or administrative adjustments; inspect transaction type before describing an item as spent credits.

list_email_send_queue

ChatGPT
Lists FirstTouch email send queue rows that have already been submitted to the email sending service. Use this for queued or awaiting submitted email sends, sent email history, failed or canceled attempts, and as the first execution-state check when a customer asks why an email has not sent. View is one of in_queue, awaiting, done, canceled, or failed and defaults to in_queue. The response includes the selected keyset page plus all five view counts using the same sender, search, and Flow Plan filters. expected send times describe FirstTouch sending, not inbox delivery. Omitted userIds always scopes to the current caller, including admins and team owners; elevated callers must select other team members explicitly. If an expected email is absent, follow response.nextSteps because phase 1 excludes actions that have not reached mail-service submission.

list_enrollments

ChatGPT
Searches compact enrollment rows by flow, status, assignee, audience, contact, and date range.

list_flow_assignments

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Lists compact configured flow assignments for one team member, including initial and downstream reassignment candidates. Use this instead of reading every get_flow_workspace for assignment inventories. Includes drafts and published flows by default. Follow every cursor to complete the requested inventory in the same turn. Does not prove task/enrollment ownership or sender readiness. System-managed flows are excluded.

list_flow_candidates

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Lists compact enrollment candidate records for one flow plan, newest first. Defaults to Awaiting; this includes Awaiting candidates whose enrollment has already been requested, so inspect canEditCustomVariables. Set status=null for all statuses. Does not return custom input values; use get_flow_candidate for one candidate's full dictionary. Candidate ids can be used in enroll_awaiting_flow_items and cancel_awaiting_flow_items where eligible. Keep the same flowPlanId, status, and searchQuery across cursor pages.

list_flow_plan_credits_usage

ChatGPT
Lists credits spent by the current team's flow plans from the same source as the flow-plan/credits-usage-cursor UI endpoint. Requires team billing access. Use fromUtc and toUtc for the reporting period. Follow cursor pages to calculate a complete total across all matching plans.

list_flow_plan_enrollments

ChatGPT
List enrollment page rows for one flow plan and one status bucket. Use this for a simple request in a specific flow, such as 'show in-progress enrollments for this flow'. It does not filter by when an enrollment completed, failed, or was canceled. For a terminal-status time range, such as 'canceled enrollments for this flow in the last 12 hours', use list_enrollments with flowPlanId, statuses, and finishedFrom/finishedTo. Uses the flow-plan enrollment page service and can return both source=flow rows and source=queue rows. Rows include replySummary with counts and latest timestamp, but not reply bodies; use get_flow_enrollment with enrollmentId to read individual replies. Queue rows do not have enrollmentId yet; use queueItemId for queue actions, not get_flow_enrollment.

list_flow_plans

ChatGPT
Lists compact flow plans without returning their action trees.

list_hubspot_lists

ChatGPT
Returns HubSpot contact lists available to the current team.

list_linkedin_outreach_queue

ChatGPT
Lists FirstTouch LinkedIn outreach queue rows. Use this when the customer asks for active LinkedIn actions, current LinkedIn actions, LinkedIn actions waiting to run, LinkedIn action status, where a LinkedIn request/action/outreach step stands, why a LinkedIn action has not sent yet, what needs review or approval, what is pending for a sender/source/contact, or which LinkedIn actions completed, failed, or were canceled. Use view for common slices: active returns pending provider requests plus pre-provider-request blockers and excludes terminal history; review_required returns only pre-provider-request actions blocked by requirements; in_queue returns created provider requests still pending; done, canceled, and failed return terminal provider requests; all returns normal outreach rows across pending, blocked, and terminal states for view_profile, send_connection, and send_message; diagnostic_all returns an expanded debug view across all LinkedIn request types, including non-standard/internal requests; custom uses the explicit advanced filters. Advanced filters can narrow by sender users, LinkedIn account ids, flow plans, action/request types, ids, search text, and date ranges. After calling, follow response.nextSteps for task approval, activity inspection, scheduler/limit delays, account blockers, and pagination. This reads stored FirstTouch data only and performs no external requests.

list_linkedin_team_connections

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Returns saved LinkedIn connection data from the FirstTouch database only. With no filters, returns paginated known connections for the current team. When the user asks to find, show, or search connections by a role, job title, profession, department, or specialty, you MUST populate headlineKeywords and MUST NOT make an unfiltered call. Examples: 'Sales Persons in my team connections', 'people in sales', 'CFOs', 'marketing leaders', or 'React developers'. First extract the role-bearing word or phrase; ignore generic group words such as person, people, contacts, and connections. For 'Sales Persons', sales is the role-bearing term: include 'sales' as a fallback, not only 'salesperson'. Derive up to nine precise literal title alternatives plus one broad, meaningful role fallback (ten keywords maximum) and pass them together through headlineKeywords; it matches any alternative only against saved connection headlines. When the request limits when the LinkedIn connection was made, populate connectedFromUtc and/or connectedToUtc. Resolve relative periods before calling: 'last week' is the prior Monday 00:00 UTC (inclusive) through the current Monday 00:00 UTC (exclusive); 'past 7 days' is a rolling seven-day range. Use other filters for a known person, owner, LinkedIn URL, or public identifier. Do not use weak standalone words such as 'person', 'manager', or 'director' as keywords; expand abbreviations where possible. This is deterministic keyword matching over saved data, not semantic/RAG search, reads stored FirstTouch data only, and performs no external requests.

list_linkedin_unibox_conversations

ChatGPT
Lists synchronized FirstTouch LinkedIn Unibox conversations ordered by latest message descending. Search covers participant name, LinkedIn URL, company name, company domain, and latest-message preview. tags accepts hot and nurture; supplying both uses OR semantics, while omitted or empty tags applies no tag filter. unreadOnly=true returns only unread conversations. archived=true returns archived only, archived=false non-archived only, and omitted archived returns both. Date boundaries are inclusive and apply to latest-message time, falling back to conversation creation time. Defaults to 20 rows, caps at 100, and uses opaque nextCursor pagination. This does not trigger synchronization.

list_purchases

ChatGPT
Lists the current team's purchase history from the same billing source and with the same UTC date filters as the charge/cursor Billing UI endpoint. Requires team billing access. Results include subscription, additional-credits, and manual charges. Follow cursor pages to read the complete history.

list_social_engagement_engagers

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Lists stored Social Engagement engagers using FirstTouch data only. Requires team owner/admin access. Supply profileId for one exact monitored subscription, linkedinUrl for that URL across all team signals, or signalId for all monitored profiles in that signal without a URL. Supplied selectors combine with AND. Requires at least one selector. Filters by engagementType, exact postUrl, and engagement time before deduplication, counting, and pagination across the complete selection. Defaults earliestEngagementPerContact=true: one earliest matching event by engaged_at per contact, across team signals for a URL-only call or within the selected signal/subscription. With false, URL-only calls deduplicate by person plus saved event key across signals while preserving different actions by the same person; scoped calls retain all matching saved events. Returns saved data without fetching live engagement.

list_social_engagement_monitored_profiles

ChatGPT
Lists Social Engagement monitored LinkedIn profiles or company pages for the current team. Requires team owner/admin access. This corresponds to the UI section Monitored profiles / Profiles to monitor. Filter by status when the customer asks for active or inactive monitored profiles.

list_social_engagement_signals

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Lists the current team's system and custom Social Engagement signals with their IDs, names, tracking modes, enabled/unlocked states, and linked Flow Plan IDs, names, and draft states. Requires team owner/admin access. Select a signal before adding monitored profiles or updating its Flow Plan. May initialize missing default signal configuration. Each signal can monitor several profiles with its own linked flow; this does not publish flows or send outreach.

list_team_members

ChatGPT
Lists active members of the current FirstTouch team with their user id, name, email, role, ownership, user-facing access level (Paid sender or View-only), connected email accounts, and task-assignment permissions. Paid sender seats allow account connections and sender actions. Viewers can access the product, but cannot connect accounts, act as senders, or be assigned flow work. Use exact returned userIds when selecting team members or assigning work.

list_user_tasks

ChatGPT
Lists task summaries assigned to the current user or active members of the current team.

manage_flow_publication

ChatGPT
Publishes or unpublishes an existing flow plan. Publishing requires a valid flow configuration.

manage_social_engagement_monitored_profile

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Performs one Social Engagement monitored-profile operation. Requires team admin access. Each operation is individually exposed as add_social_engagement_monitored_profile, activate_social_engagement_monitored_profile, deactivate_social_engagement_monitored_profile, or delete_social_engagement_monitored_profile; prefer those specific tools. Supply action.type=add, activate, deactivate, or delete with only that variant's fields. Add accepts linkedinUrl, signalId and loadHistory; custom signals supply the tracking mode. For legacy system monitoring, engagementType is required. Other variants require profileId, the monitored subscription ID. Adding or resuming can consume credits when the owning signal is eligible. Deactivate pauses; delete removes only the profile subscription. The response includes the owning socialEngagement.signal and socialEngagement.flowPlan. Signal deletion and tracking-mode changes are not supported.

preview_hubspot_list

ChatGPT
Returns preview contacts for one HubSpot contact list.

preview_task

ChatGPT
Preview a single task by id, including payload, task status, blocking enrollment warnings, approval readiness, task.properties, and links. For MCP Dynamic Actions approval tasks, task.payload.actions[].branch_context and actionGroup.actions[].branchContext identify actions on the main, connection_accepted, and connection_timeout paths. task.properties is the task PropertyValueDto[] used for data variables and readiness checks, including prospect, company, routing, and enriched values when present.

reenroll_flow_enrollments

ChatGPT
Reenroll failed enrollment queue items after validate_flow_reenroll. Warning-bearing contacts are automatically skipped and returned as per-item failures to prevent duplicate outreach.

remove_dynamic_action_prospect

ChatGPT
Cancel one MCP Dynamic Actions enrollment. Use enrollmentId when available because add_dynamic_action always returns it, including email-/LinkedIn-/phone-only enrollments where prospectId can be null. prospectId is only a fallback when it identifies exactly one non-canceled MCP Dynamic Actions enrollment; otherwise call find_mcp_enrollment and pass the selected enrollmentId. This does not modify normal flow plans.

remove_exclusions

ChatGPT
Requires team owner/admin access. Removes contact email exclusions, company domain exclusions, and/or connected CRM exclusion segments. Validation is atomic and reports the zero-based array indexes of every invalid item so the input can be corrected and retried. Removing a connected segment stops its synchronization and deactivates exclusions currently attributed to that segment. An individual exclusion supplied by an active connected segment can return during its next synchronization. Obtain explicit user confirmation before calling this tool. Up to 1000 contact and company values combined and up to 10 segment ids may be submitted per call.

replace_flow_root

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Replace an existing reusable flow-plan root with a complete node tree. Call get_guide with topic=flow_plan_creation before building root JSON, and call get_flow_available_variables before using variables in prompts or expressions. When payload.enable_ai_generation=true, at least one applicable content field must be empty or contain square-bracket AI instructions; otherwise the request is rejected. Email and InMail check body and subject independently; an inherited email reply subject does not count. Set enable_ai_generation=false for finished literal text. Do not use this for independent contact chains; use the contact sequence tools once per contact per step. Never use this for the MCP Dynamic Actions flow plan; use the contact sequence tools to create or extend enrollments and cancel_flow_enrollments with explicit IDs to cancel them. The flow becomes a draft after replacement.

report_issue

ChatGPT
Submit a user-requested issue report to FirstTouch. Read get_guide(topic=issue_reporting) before submitting. Reports are limited to 10 per user per UTC day; retries using the same submissionKey return the original report.

resync_exclusion_segment

ChatGPT
Requires team owner/admin access. Requests an immediate refresh of one active connected CRM exclusion segment and returns its pending synchronization state.

send_linkedin_unibox_message

ChatGPT
Sends one exact LinkedIn Unibox reply through the sender account configured for the conversation. Use only when the customer explicitly requested this exact text or approved a presented draft. A summary, inspection, or draft does not authorize sending. conversationId must be exact and text must be non-empty. The configured manual_reply_send_mode is always used; this tool has no reply-mode override. Never retry automatically. If an ambiguous failure or timeout occurs, re-fetch the conversation and ask the customer whether to retry. Blocked results are not successful.

skip_task

ChatGPT
Skip a todo call or manual task. This matches the skip action and does not cancel the whole enrollment. For section approval flow cancellation, use the flow enrollment cancellation tools.

start_contact_discovery_audience_import

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Call get_guide with topic=contact_discovery before starting an async contact discovery import. Fetches up to 100 total profiles and creates a manual audience when complete. Costs 1 credit per additional profile row requested beyond initialProspectIds. After a failed import, suggest trying again later; start a new import from saved IDs and token only when the user requests a retry. Correct explicit filter-validation errors before retrying.

tasks_get_statuses

ChatGPT
Check the current status and refresh flag of up to 500 known tasks in one call. Prefer this tool over tasks_list or preview_task for recurring monitoring of saved task IDs. Returns todo, done, or canceled without task details or readiness checks. Missing, deleted, and inaccessible IDs are grouped in unavailableTaskIds without disclosing the reason. All statuses and assignees the caller can read in the current team are included. A done approval task does not mean outreach has been sent. Use tasks_list to discover new tasks.

tasks_list

ChatGPT
Call get_guide with topic=tasks_and_approvals for task kinds, readiness, approval, editing, completion, and skipping guidance. List lightweight task summaries with title, summary, assignee, contact/company details, enrollment status and workflow name, and direct UI links. Use task.id with preview_task to open full details. Without taskIds, defaults to todo tasks assigned to the current user. With taskIds, defaults to all statuses and all assignees the caller can read in the current team; explicit statuses, assignedUserId, and includeTeamTasks=true still apply. Callers can set includeTeamTasks=true to read tasks owned by active members of the current team, or assignedUserId for one user. For a general request to view pending tasks, omit types. Use preview_task for payload, properties, warnings, and action details.

update_flow_candidates_custom_variables

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Updates saved inputs for 1 to 100 unique enrollment candidates in the current team and the specified flowPlanId. One type applies to all items: upsert adds or overwrites supplied customVariables while preserving all other keys; remove deletes supplied keys, with missing keys a no-op. Each candidate commits independently; returns updated ids and failed items with candidateId, code, and actionable message. Malformed shapes or duplicate ids reject the whole request before any updates. Allowed only while Awaiting, before enrollment is requested or created. Upsert values for keys with current flow definitions must match their declared types; unknown keys and incomplete required inputs are allowed during preparation. The final dictionary supports up to 20 values, strings up to 10000 characters, 20 KiB total; values must be strings without curly braces, integers, or booleans. Does not modify audience contacts, definitions, or existing enrollment snapshots and does not enroll candidates. Failure codes: candidate_not_found, candidate_flow_mismatch, candidate_not_editable, custom_variables_invalid, custom_variables_limit_exceeded, candidate_changed. Reload get_flow_candidate before retrying candidate_changed.

update_flow_custom_variables

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Updates custom input definitions atomically through add, updateLabels, and remove. Read get_flow_workspace.customVariables first for definitions, isUsed, canDelete, and referencePaths. Each name may appear only once across all operations; overlapping or duplicate names are rejected. Add requires a new name, updateLabels and remove require existing names. Name and type cannot change; removal requires no references in the current tree, including branch expressions. The final list supports up to 20 definitions. Any invalid operation rejects the entire batch. Preserves publication state, tree, saved audience/candidate values, and existing enrollment snapshots. Returns all definitions and current usage. If a concurrent edit conflicts, reload the workspace before retrying.

update_flow_plan

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Update an existing reusable Flow Plan's name, options, AI qualification, or candidate assignees. Read get_flow_workspace first to inspect the current settings. Omitted top-level settings keep their current values; supplied options and aiQualification replace their complete blocks, and candidates replaces the complete candidate list. Removing candidate assignees can move their affected enrollments to failed. A name-only or no-op update preserves the current published/draft state. Any configuration change moves a published reusable flow to Draft, pausing new enrollments until a separate manage_flow_publication call publishes it again. This tool does not replace the root, attach an audience, publish a flow, or explicitly enroll contacts. Enrichment and CRM options configure subsequent execution, which may consume FirstTouch credits or write to the connected CRM; setting them does not itself run those operations. For the shared contact-sequence Flow Plan, only mcpDynamicActionsOptions.is_enrich_hubspot and mcpDynamicActionsOptions.is_push_to_hubspot_tasks are allowed. These are shared settings, not per-action or per-enrollment overrides. The task setting controls call, manual, and approval task sync together; omitted flags keep their current values, and all other fields for that system flow are rejected.

update_linkedin_unibox_conversation_state

ChatGPT
Updates explicit state on one synchronized FirstTouch LinkedIn Unibox conversation. Use only when the customer explicitly asks to mark it read or unread, archive or unarchive it, or change its tag. isRead=true marks read and false marks unread. isArchived=true archives and false unarchives. tag accepts hot, nurture, or none: hot and nurture replace the tag, while none clears it. Omit any state field that should remain unchanged. MCP supports at most one tag on a conversation. At least one of tag, isRead, or isArchived must be supplied. This changes FirstTouch state only; it does not send a message or trigger synchronization.

update_social_engagement_signal

ChatGPT
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling. Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request. Updates one Social Engagement signal by required signalId. Currently supports only isEnabled: enables or deactivates collection for the selected signal. Requires team admin access; enabling requires paid or trial access. Deactivation retains its profiles and history; other signals retain their state, and existing enrollments and their actions continue. Enabling resumes eligible active profiles subject to access and credits; paused profiles remain paused. Collection and pending requested history can consume FirstTouch credits, even while the linked flow is draft. Does not publish or change the linked Flow Plan, delete or rename the signal, or change its tracking mode.

validate_flow_reenroll

ChatGPT
Validate failed enrollment queue items before reenrolling them. Warning details identify contacts that will be automatically skipped to prevent duplicate outreach.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/firsttouch"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/firsttouch)