Skip to main content
Close MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 114
  • Triggers: 0
  • Slug: CLOSE_MCP
  • Version: 20261018_00

Tools

Slug: CLOSE_MCP_ACTIVITY_SEARCHSearch for activities. Results are returned ordered by date descending.Examples:
  • To list activities on a lead, use the lead_ids filter.
  • To list conversations, filter for calls and meetings.

Input Parameters

string
Pagination cursor, give only when more results are requested.
string
string
string
Filter activities by direction (inbound = received by the user, outbound = sent by the user). Applies to Call, SMS, Email, and WhatsApp activities; activity types that have no direction (e.g. Note, Task) are excluded when this filter is set.
string
string
Filter calls by status (e.g. completed, no-answer, busy). Only meaningful when activity_types includes Call; a no-op unless Call is searched. Other activity types use different status vocabularies, so they never match these values and are effectively excluded.
string
string
string
Filter by voice agent config IDs. Matches Call, Email, and SMS activities that carry an agent_config_id; other activity types are filtered out implicitly because the field is not indexed for them.
string

Output

string
array
required
string
Slug: CLOSE_MCP_AGGREGATIONPerform an aggregation to answer questions like:
  • How many emails were sent this week?
  • Calls by user this week (Who made the most?)
You MUST first fetch the list of available fields using the get_fields tool.

Input Parameters

string
Reference or enum fields to group by, max 2
string
Interval to aggregate by when using date fields. Determined automatically by default.
string
Aggregation specifications to compute
string
Determined automatically by default.
string
Time buckets
array
required
Object types to include in aggregation

Output

array
string
Slug: CLOSE_MCP_APPLY_VOICE_AGENT_UPDATEApply a previously proposed voice agent update.This tool persists the server-stored proposal identified by proposal_id. It does not rerun the feedback processor, and it fails if the proposal has expired or the voice agent changed after the proposal was created.

Input Parameters

string
required
Proposal ID returned by propose_voice_agent_update.

Output

string
required
string
required
Slug: CLOSE_MCP_CLOSE_PRODUCT_KNOWLEDGE_SEARCHSearch Close product documentation and knowledge base for relevant information.Use this tool when users ask about:
  • How to use specific Close features
  • Close API documentation and integration
  • Workflow automation and best practices
  • Product capabilities and limitations
  • Setup and configuration guidance
Example queries:
  • “How do I set up automated lead assignment?”
  • “What are Close’s API rate limits?”
  • “How to create custom fields in Close?”
  • “Best practices for email templates in Close”

Input Parameters

string
required
Natural language query to search Close product documentation and knowledge

Output

array
Relevant excerpts paired with their sources
Slug: CLOSE_MCP_CREATE_ADDRESSAdd a new address to an existing lead (company).

Input Parameters

string
required
City
string
required
Label for the address
string
required
State or province
string
required
Country code (ISO 3166-1 alpha-2)
string
required
ID of the lead to add the address to
string
required
ZIP or postal code
string
required
Address line 1
string
Address line 2

Output

string
required
string
required
string
required
array
required
string
required
string
string
required
string
string
required
string
string
required
array
Custom field values set on this object
string
ID of the lead’s primary contact (its first contact), if any.
Slug: CLOSE_MCP_CREATE_CALL_TASKSchedule a call task on a lead, assigned to either a user or a voice agent (Chloe).A call task represents a scheduled outbound call that will be made to the specified contact at the given time. The task can be assigned to a specific user or dispatched to a voice agent.

Input Parameters

string
The call task description/instructions.
string
required
ID of the lead this call task belongs to
string
Due date or datetime for the call task. Can be a date (YYYY-MM-DD) or datetime (ISO 8601). If not provided, the task will be due immediately.
string
required
ID of the contact to call. Must belong to the specified lead.
string
ID of the user to assign the call task to. Mutually exclusive with agent_config_id.
string
ID of the voice agent (Chloe) to dispatch the call task to. Mutually exclusive with assigned_to.

Output

string
required
string
Call task text/instructions
boolean
required
string
ID of the associated Call activity, if any
string
required
ID of the lead this call task belongs to
string
required
Date and time of the scheduled call (ISO 8601)
string
required
Name of the lead this call task belongs to
string
required
ID of the associated contact
string
required
string
required
string
required
string
ID of the user assigned to this call task (None when assigned to an agent)
boolean
required
Whether the call task has been completed
string
required
Name of the associated contact
string
Full name of the assigned user (None when assigned to an agent)
string
ID of the voice agent config (non-null when assigned to a voice agent)
string
Name of the voice agent (non-null when assigned to a voice agent)
string
required
Slug: CLOSE_MCP_CREATE_COMMENTAdd a comment to a commentable object (note, call, opportunity, task, custom object, etc.).If the object already has a comment thread, the new comment is appended to it. Otherwise a new thread is started for the object. Use this tool for both starting a conversation and replying to an existing one — the object_id alone determines which.Comments support @-mentions of users and groups. The body is HTML.

Input Parameters

string
required
Body of the comment as Close rich text (HTML). Must be a valid Close rich-text document: wrap the whole content in a single <body> tag and put each line/paragraph in a block-level tag. Supported tags include <p>, <h1>-<h6>, <ul>/<ol> with <li>, <blockquote>, <hr>, <a href=…>,
, and inline formatting <strong>/<b>, <em>/<i>, <u>, <s>, <code>, <span>. Emoji and unicode are accepted. Escape literal ’&’ as ’&’ and literal ’<’ as ’<’ in text content. To @-mention a user, call the org_users tool to look up the target user and embed their mention_html value verbatim in the body. To @-mention a group, call the find_groups tool to look up the target group and embed their mention_html value verbatim in the body. Example: <body><p>Nice work <span data-type=“mention” data-id=“user_abc123” data-label=“Jane Doe” class=“mention”>@Jane Doe</span> on closing this!</p></body>
string
required
ID of the commentable object: an activity ID (acti_…, e.g. a note, call, email, SMS, meeting, or custom activity), an opportunity ID (oppo_…), a task notification ID (task_…), or a custom object ID (custobj_…). One comment thread exists per object; this tool adds to it or creates it if none exists yet.

Output

string
required
string
required
string
required
array
required
string
required
string
required
string
required
string
required
string
required
string
Full name of the user who wrote the comment.
string
Full name of the user who last edited the comment.
Slug: CLOSE_MCP_CREATE_CONTACTCreate a new contact for a lead.A contact represents a person associated with a lead (company).

Input Parameters

string
Name of the contact
string
List of URLs for the contact
string
Job title of the contact
string
List of email addresses for the contact
string
List of phone numbers for the contact
string
required
ID of the lead this contact belongs to
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
array
string
array
array
string
required
string
required
string
string
required
string
string
required
array
Custom field values set on this object
Slug: CLOSE_MCP_CREATE_CUSTOM_ACTIVITY_INSTANCECreate a new custom activity instance on a lead.A custom activity instance is an activity of a custom activity type, holding the custom field values defined by that type. Use the find_custom_activities tool to look up the available custom activity types.If in an interactive session, ask the user for the relevant field values (including custom fields) before creating, even if they are not required.

Input Parameters

boolean
Whether to pin the custom activity to the top of the lead’s timeline
string ("draft" | "published")
Status of the custom activity. Published activities validate required custom fields; draft activities do not.
string
required
ID of the lead this custom activity belongs to
string
ID of the user to attribute the custom activity to (defaults to the caller)
string
ID of the contact to associate with the custom activity
string
When the custom activity occurred
string
When the custom activity was created. Defaults to now; set this to backfill an activity at a past time.
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.
string
required
ID of the custom activity type. Use the find_custom_activities tool to look up the available custom activity types.

Output

string
required
Unique identifier of the custom activity instance
boolean
required
Whether the custom activity is pinned to the top of the lead’s timeline
string ("draft" | "published")
required
Whether the custom activity is published or draft; draft instances skip required custom-field validation
string
required
ID of the lead this custom activity belongs to
string
ID of the user the custom activity is attributed to (its owner; may differ from the creator)
string
Name of the lead this custom activity belongs to
string
When the custom activity was pinned, or null if it is not pinned
string
Full name of the user the custom activity is attributed to
string
ID of the contact on the lead this custom activity is associated with, if any
string
required
When the custom activity was created
string
ID of the user who created the custom activity
string
required
When the custom activity was last updated
string
ID of the user who last updated the custom activity
string
required
When the activity occurred; may be backdated and differ from the creation time
string
Name of the associated contact, if any
array
Custom field values set on this object
string
Full name of the user who created the custom activity
string
Full name of the user who last updated the custom activity
string
When the custom activity was last published, or null if it has only ever been a draft
string
required
ID of the custom activity type that defines this instance’s shape and custom fields
string
Name of the custom activity type that defines this instance’s shape and custom fields
Slug: CLOSE_MCP_CREATE_CUSTOM_OBJECT_INSTANCECreate a new custom object instance on a lead.A custom object instance is a record of a custom object type, attached to a lead and holding the custom field values defined by that type. Use the find_custom_object_types tool to look up the available custom object types.If in an interactive session, ask the user for the relevant field values (including custom fields) before creating, even if they are not required.

Input Parameters

string
required
Display name for the custom object instance
string
required
ID of the lead this custom object belongs to
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.
string
required
ID of the custom object type that defines this instance’s shape and custom fields. Use the find_custom_object_types tool to look up the available custom object types.

Output

string
required
Unique identifier of the custom object instance
string
Display name of the custom object instance
string
required
ID of the lead this custom object belongs to
string
Name of the lead this custom object belongs to
string
required
When the custom object was created
string
ID of the user who created the custom object
string
required
When the custom object was last updated
string
ID of the user who last updated the custom object
array
Custom field values set on this object
string
Full name of the user who created the custom object
string
Full name of the user who last updated the custom object
string
required
ID of the custom object type that defines this instance’s shape and custom fields
string
Name of the custom object type this instance belongs to
Slug: CLOSE_MCP_CREATE_DRAFT_EMAILCreate a draft email on a lead.The email is saved as an unsent draft for the user to review, edit, and send from Close; it is never sent automatically. Provide the body as Close rich text (HTML) via body_html; the sender’s saved email signature is appended automatically. To create a reply in an existing thread, provide the ID of the email being replied to via in_reply_to_id.

Input Parameters

string
List of CC email addresses
string
List of recipient email addresses
string
List of BCC email addresses
string
Email address of a connected sending identity, including aliases. Must match an available sender for the current user.
string
required
ID of the lead this draft email belongs to
string
Subject line of the email
string
Draft body as Close rich text (HTML). Wrap the whole content in a single <body> tag and put each line/paragraph in a block-level tag. Supported tags include <p>, <h1>-<h6>, <ul>/<ol> with <li>, <blockquote>, <hr>, <a href=…>,
, and inline formatting <strong>/<b>, <em>/<i>, <u>, <s>, <code>, <span>. Escape literal ampersands as ’&’. Example: <body><p>Hi <strong>Jane</strong>,</p><p>Following up on our call.</p></body>. Do not include a signature block (name, title, company, contact details); the sender’s saved email signature is appended automatically. A short closing line such as ‘Best,’ is fine.
string
Plaintext body content. Prefer body_html; if only one of body_html/body_text is provided the other is derived automatically.
string
ID of the contact this draft email is addressed to
string
ID of the email this draft replies to. The draft joins that email’s thread.

Output

array
string
required
array
array
string
string
required
string
string
string
string
Rich-text (HTML) body content
string
Plaintext body content
string
string
required
string
required
Slug: CLOSE_MCP_CREATE_EMAIL_TEMPLATECreate a new email template.Handling of attachments and unsubscribe links via this tool is currently unsupported.Email template body should be HTML formatted.Use template tags as placeholders, for example: {{ organization.name }} to refer to the sender’s organization name. {{ user.first_name }} {{ user.last_name }} {{ user.email }} {{ user.phone }} to refer to the user sending the email. {{ lead.display_name }} to refer to the lead name (recipient’s name/company). {{ contact.first_name }} {{ contact.last_name }} to refer to the recipient.

Input Parameters

string
string
string
required
string
required
string
required
boolean
Share this template with the organization (required for use in workflows)

Output

array
required
string
required
array
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_CREATE_LEADCreate a new lead (company).After creating a lead, you should usually add an address or contact (including phone or email) to the lead.

Input Parameters

string
URL of the lead’s website
string
Name of the lead
string
ID of the lead status
string
Description of the lead
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
required
string
required
array
required
string
required
string
string
required
string
string
required
string
string
required
array
Custom field values set on this object
string
ID of the lead’s primary contact (its first contact), if any.
Slug: CLOSE_MCP_CREATE_LEAD_STATUSCreate a new lead status.

Input Parameters

string
required
Label for the lead status

Output

string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_CREATE_NOTECreate a new note on a lead.A note is a text-based activity attached to a lead. At least one of note (plaintext) or note_html (rich text) must be provided.

Input Parameters

string
Plaintext note content
string
Title of the note
string
Whether to pin the note to the top of the lead
string
required
ID of the lead this note belongs to
string
ID of the user to attribute the note to (defaults to caller)
string
Rich-text (HTML) note content
string
ID of the contact to associate with the note
string
When the note activity occurred

Output

string
required
string
required
Plaintext note content
string
boolean
string
required
string
string
string
Rich-text (HTML) note content
string
string
string
required
string
required
string
required
string
boolean
Slug: CLOSE_MCP_CREATE_OPPORTUNITYCreate a new opportunity.Requires a lead ID and status ID. Other fields are optional. The value should be specified in cents (e.g., $100.00 = 10000).

Input Parameters

string
Plaintext version of the note.
string
Value in cents
string
required
ID of the lead this opportunity belongs to
string
ID of the user assigned to this opportunity. Defaults to the current user.
string
Expected close date
string
Rich-text HTML version of the note, wrapped in <body>...</body> (e.g. <body><p>text with <strong>bold</strong></p></body>). When set, note is automatically derived from it, overriding any note value passed in the same request.
string
required
ID of the opportunity status
string
Confidence percentage (0-100)
string
ID of the primary contact for this opportunity
string
Period for the value
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
Plaintext version of the note.
string
Value in cents
string
required
ID of the lead this opportunity belongs to
string
required
ID of the user assigned to this opportunity
string
Date the opportunity is expected to close (if active), or date the opportunity was won or lost.
string
required
Name of the lead this opportunity belongs to
string
Rich-text HTML version of the note, wrapped in <body>...</body>.
string
required
ID of the opportunity status
string
required
Name of the user assigned to this opportunity
integer
required
Confidence percentage (0-100)
string
ID of the contact for this opportunity
string
required
string
required
string
required
Type of the opportunity status
string
required
Name of the contact for this opportunity
string
required
string
required
Label of the opportunity status
string ("one_time" | "monthly" | "annual")
required
Period for the value
array
Custom field values set on this object
Slug: CLOSE_MCP_CREATE_OPPORTUNITY_STATUS_TOOLCreate a new opportunity status.

Input Parameters

string ("won" | "lost" | "active")
required
Type of the opportunity status
string
required
Label for the opportunity status
string
required
ID of the pipeline to add the status to

Output

string
required
string ("won" | "lost" | "active")
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_CREATE_PIPELINECreate a new opportunity pipeline.Use the create_opportunity_status tool to add statuses to the pipeline.

Input Parameters

string
required
Name of the pipeline

Output

string
required
string
required
array
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_CREATE_SMS_TEMPLATECreate a new SMS template.Handling of attachments via this tool is currently unsupported.Use template tags as placeholders, for example: {{ organization.name }} to refer to the sender’s organization name. {{ user.first_name }} {{ user.last_name }} {{ user.email }} {{ user.phone }} to refer to the user sending the message. {{ lead.display_name }} to refer to the lead name (recipient’s name/company). {{ contact.first_name }} {{ contact.last_name }} to refer to the recipient.

Input Parameters

string
required
string
required
boolean
Share this template with the organization (required for use in workflows)

Output

string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_CREATE_TASKCreate a new task for a lead.A task represents a to-do item that can be assigned to a user and optionally associated with a contact.

Input Parameters

string
required
The task description
string
required
ID of the lead this task belongs to
string
Due date or datetime for the task. Can be a date (YYYY-MM-DD) or datetime (ISO 8601). If not provided, the task will be due immediately.
string
Task priority: ‘high’ or ‘medium’. Defaults to ‘medium’. Only set to high if the user explicitly says it’s a high priority task.
string
ID of the contact associated with this task. Must belong to the specified lead.
string
ID of the user to assign the task to. Defaults to the current user if not provided.
boolean
Send an email notification to the assigned user. Assume notifications should be sent unless the user explicitly tells you not to.

Output

string
required
Unique task identifier
string
required
Task text/instructions
string
required
ID of the lead this task belongs to
string
required
Due date: datetime if task has specific time, date if date-only, None if task has no due date
string ("high" | "medium")
required
Task priority level
string
required
Name of the lead this task belongs to
string
ID of the associated contact, if any
string
required
When the task was created
string
required
When the task was last updated
string
required
ID of the user assigned to task
boolean
required
Whether task has been completed
string
Name of the associated contact, if any
string
required
Full name of the assigned user
Slug: CLOSE_MCP_CREATE_WORKFLOWCreate a new workflow (a.k.a. sequence) with Draft status.

Input Parameters

string
required
Workflow name. Must be unique.
array
required
Steps in the workflow. The step_type of each step has to exactly match one of the defined types in the mapping.
string
The trigger that determines when and how the workflow fires. The trigger_type must exactly match one of the defined types. Use ‘contact-manual’ (the default) when the user does not specify a trigger.
object
Conditions that stop a workflow run early, before its remaining steps run. Any one of them stops the run; they are never AND-ed. Use the defaults when the user does not specify what should stop the workflow.

Output

string
required
string
required
array
required
string ("active" | "paused" | "draft")
required
Slug: CLOSE_MCP_CUSTOMIZED_BUILTIN_LABELSReturn the customized builtin labels.Only renamed labels are returned - an empty result means the default names apply.

Output

array
required
Slug: CLOSE_MCP_DELETE_ADDRESSDelete an address from an existing lead (company) if there is an exact match.

Input Parameters

string
required
City
string
required
Label for the address
string
required
State or province
string
required
Country code (ISO 3166-1 alpha-2)
string
required
ID of the lead to delete the address from
string
required
ZIP or postal code
string
required
Address line 1
string
Address line 2

Output

string
required
string
required
string
required
array
required
string
required
string
string
required
string
string
required
string
string
required
array
Custom field values set on this object
string
ID of the lead’s primary contact (its first contact), if any.
Slug: CLOSE_MCP_DELETE_CALL_TASKDelete a call task. Does not affect sibling tasks.

Input Parameters

string
required
The ID of the call task to delete.
Slug: CLOSE_MCP_DELETE_CONTACTPermanently delete an existing contact.This will remove the contact from its lead including its email addresses, phone numbers, and URLs will be removed. Activities on the lead are not affected.This action cannot be undone.ONLY call this if the user specifically instructed you to delete the contact.

Input Parameters

string
required
ID of the contact to delete
Slug: CLOSE_MCP_DELETE_CUSTOM_ACTIVITY_INSTANCEPermanently delete an existing custom activity instance.This action cannot be undone.ONLY call this if the user specifically instructed you to delete the custom activity instance.

Input Parameters

string
required
ID of the custom activity instance to delete
Slug: CLOSE_MCP_DELETE_CUSTOM_OBJECT_INSTANCEPermanently delete an existing custom object instance.A custom object instance is a record of a custom object type, attached to a lead and holding the custom field values defined by that type. This action cannot be undone.ONLY call this if the user specifically instructed you to delete the custom object instance.

Input Parameters

string
required
ID of the custom object instance to delete
Slug: CLOSE_MCP_DELETE_EMAIL_TEMPLATEPermanently delete an email template.If the template is used in any workflows (sequences), it cannot be deleted.

Input Parameters

string
required
ID of the email template to delete
Slug: CLOSE_MCP_DELETE_LEADPermanently delete an existing lead (company) by ID including all of its addresses, contacts, opportunities, tasks, and activities.ONLY call this if the user specifically instructed you to delete the lead, and you confirmed what the deletion will entail and that it cannot be reversed.

Input Parameters

string
required
ID of the lead to delete
Slug: CLOSE_MCP_DELETE_LEAD_SMART_VIEWPermanently delete a lead smart view (saved search).

Input Parameters

string
required
ID of the lead smart view to delete
Slug: CLOSE_MCP_DELETE_LEAD_STATUSPermanently delete a lead status.Cannot delete if it’s the last lead status in the organization or there are leads currently using this status.

Input Parameters

string
required
ID of the lead status to delete
Slug: CLOSE_MCP_DELETE_NOTEPermanently delete an existing note.This action cannot be undone.ONLY call this if the user specifically instructed you to delete the note.

Input Parameters

string
required
ID of the note to delete
Slug: CLOSE_MCP_DELETE_OPPORTUNITYPermanently delete an opportunity.This action cannot be undone. All data associated with the opportunity will be removed.

Input Parameters

string
required
ID of the opportunity to delete
Slug: CLOSE_MCP_DELETE_OPPORTUNITY_STATUS_TOOLPermanently delete an opportunity status.Cannot delete if it’s the last opportunity status in the organization or there are opportunities currently using this status.

Input Parameters

string
required
ID of the opportunity status to delete
Slug: CLOSE_MCP_DELETE_PIPELINEPermanently delete an opportunity pipeline.A pipeline can only be deleted if it has no statuses. The last pipeline cannot be deleted.

Input Parameters

string
required
ID of the pipeline to delete
Slug: CLOSE_MCP_DELETE_SMS_TEMPLATEPermanently delete an SMS template.If the template is used in any workflows (sequences), it cannot be deleted.

Input Parameters

string
required
ID of the SMS template to delete
Slug: CLOSE_MCP_DELETE_TASKPermanently delete an existing task by ID.This action cannot be undone.ONLY call this if the user specifically instructed you to delete the task.

Input Parameters

string
required
ID of the task to delete
Slug: CLOSE_MCP_ENRICH_FIELDUse AI to determine and set the value of a field on a lead or contact.The field is enriched using available data on the object and external sources, and the enriched value is written back to the object. By default the value is only written if the field is currently empty; set overwrite_existing_value to True to replace an existing value.Returns the enriched value along with the model’s reasoning and confidence.

Input Parameters

string
required
The ID of the field to enrich. This may be a built-in field name or a custom field ID.
string
required
The ID of the lead or contact to enrich (e.g. ‘lead_xxx’ or ‘cont_xxx’).
string ("lead" | "contact")
required
The type of object whose field should be enriched.
boolean
Whether to overwrite an existing value. When False, the field is only written if it is currently empty.

Output

string
required
The enriched value.
string
required
string
required
string
required
Explanation of how the value was determined.
string ("high" | "medium" | "low")
required
The model’s confidence in the enriched value.
string ("lead" | "contact")
required
Slug: CLOSE_MCP_FETCH_CALLFetch a single call activity by ID.Returns the call’s direction, outcome, participants, and (if available) its transcript.

Input Parameters

string
required
The ID of the call to fetch.

Output

string
required
string
Call note (may contain HTML)
string
string
required
string
string
Duration in seconds
string ("inbound" | "outbound")
required
Direction of a phone call or an SMS message. If you want to use this for a new activity, consider more generic CommunicationDirection instead.
string
string
string
string
required
string
ID of the outcome logged on the call, if any
string
Full recording transcript text
string
required
string
required
string
string
string
Close-side phone number on the call
string
string
Lead/contact-side phone number on the call
string
URL to the call recording, if one is available
string
URL to the voicemail recording, if one was left
string
Voice agent that placed the call. Non-null identifies a voice-agent-driven call.
string
Name of the voice agent that placed the call
string
Recording duration in seconds
Slug: CLOSE_MCP_FETCH_CALL_TASKFetch a single call task by ID.

Input Parameters

string
required
The ID of the call task to fetch.

Output

string
required
string
Call task text/instructions
boolean
required
string
ID of the associated Call activity, if any
string
required
ID of the lead this call task belongs to
string
required
Date and time of the scheduled call (ISO 8601)
string
required
Name of the lead this call task belongs to
string
required
ID of the associated contact
string
required
string
required
string
required
string
ID of the user assigned to this call task (None when assigned to an agent)
boolean
required
Whether the call task has been completed
string
required
Name of the associated contact
string
Full name of the assigned user (None when assigned to an agent)
string
ID of the voice agent config (non-null when assigned to a voice agent)
string
Name of the voice agent (non-null when assigned to a voice agent)
string
required
Slug: CLOSE_MCP_FETCH_COMMENTFetch a single comment by ID.Returns the comment’s rich-text (HTML) body, the thread and lead it belongs to, its @-mentions, and the resolved author and last-editor names.

Input Parameters

string
required
ID of the comment to fetch.

Output

string
required
string
required
string
required
array
required
string
required
string
required
string
required
string
required
string
required
string
Full name of the user who wrote the comment.
string
Full name of the user who last edited the comment.
Slug: CLOSE_MCP_FETCH_CONTACTFetch an existing contact by ID.Returns the contact’s details including name, title, email addresses, phone numbers, and URLs.

Input Parameters

string
required
ID of the contact to fetch

Output

string
required
string
array
string
array
array
string
required
string
required
string
string
required
string
string
required
array
Custom field values set on this object
Slug: CLOSE_MCP_FETCH_CUSTOM_ACTIVITY_INSTANCEFetch an existing custom activity instance by ID.A custom activity instance is an activity of a custom activity type, holding the custom field values defined by that type. Returns the full instance, including its custom field values and the resolved lead, contact, and user names.

Input Parameters

string
required
ID of the custom activity instance to fetch

Output

string
required
Unique identifier of the custom activity instance
boolean
required
Whether the custom activity is pinned to the top of the lead’s timeline
string ("draft" | "published")
required
Whether the custom activity is published or draft; draft instances skip required custom-field validation
string
required
ID of the lead this custom activity belongs to
string
ID of the user the custom activity is attributed to (its owner; may differ from the creator)
string
Name of the lead this custom activity belongs to
string
When the custom activity was pinned, or null if it is not pinned
string
Full name of the user the custom activity is attributed to
string
ID of the contact on the lead this custom activity is associated with, if any
string
required
When the custom activity was created
string
ID of the user who created the custom activity
string
required
When the custom activity was last updated
string
ID of the user who last updated the custom activity
string
required
When the activity occurred; may be backdated and differ from the creation time
string
Name of the associated contact, if any
array
Custom field values set on this object
string
Full name of the user who created the custom activity
string
Full name of the user who last updated the custom activity
string
When the custom activity was last published, or null if it has only ever been a draft
string
required
ID of the custom activity type that defines this instance’s shape and custom fields
string
Name of the custom activity type that defines this instance’s shape and custom fields
Slug: CLOSE_MCP_FETCH_CUSTOM_OBJECT_INSTANCEFetch an existing custom object instance by ID.A custom object instance is a record of a custom object type, attached to a lead and holding the custom field values defined by that type. Returns the full instance, including its custom field values and the resolved lead, custom object type, and creator/updater names.

Input Parameters

string
required
ID of the custom object instance to fetch

Output

string
required
Unique identifier of the custom object instance
string
Display name of the custom object instance
string
required
ID of the lead this custom object belongs to
string
Name of the lead this custom object belongs to
string
required
When the custom object was created
string
ID of the user who created the custom object
string
required
When the custom object was last updated
string
ID of the user who last updated the custom object
array
Custom field values set on this object
string
Full name of the user who created the custom object
string
Full name of the user who last updated the custom object
string
required
ID of the custom object type that defines this instance’s shape and custom fields
string
Name of the custom object type this instance belongs to
Slug: CLOSE_MCP_FETCH_CUSTOM_OBJECT_TYPEFetch a single custom object type by its ID.A custom object type defines the shape of a category of custom objects, including the custom fields its instances hold. Returns the type with its custom fields.

Input Parameters

string
required
ID of the custom object type to fetch.

Output

string
required
Unique identifier of the custom object type (e.g. ‘cotype_abc123’).
string
required
Singular display name of the custom object type.
array
required
Custom fields defined on this custom object type.
string
required
What this custom object type is used for.
string
required
Plural display name of the custom object type.
Slug: CLOSE_MCP_FETCH_EMAIL_TEMPLATEFetch an email template by ID.Returns the complete email template with all its details.

Input Parameters

string
required
ID of the email template to fetch

Output

array
required
string
required
array
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_INVOICEFetch one of the organization’s billing invoices by id.

Input Parameters

string
required

Output

string
required
Close invoice id.
string
required
Invoice date (UTC ISO 8601); null if unset.
string ("plan" | "usage_credit" | "usage_overview" | "ai_usage_tier_switch" | "ai_usage" | "chloe-beta" | "metronome_ai_usage" | "metronome_ai_usage_top_up")
required
The type of invoices we generate.
string
required
Invoice status: due or paid.
string
required
Authenticated redirect to the invoice PDF.
string
required
Authenticated redirect to the invoice web page.
string
required
Human-readable amount; empty when there is no amount.
Slug: CLOSE_MCP_FETCH_LEADFetch an existing lead (company) by ID.

Input Parameters

string
required
ID of the lead to fetch

Output

string
required
string
required
string
required
array
required
string
required
string
string
required
string
string
required
string
string
required
array
Custom field values set on this object
string
ID of the lead’s primary contact (its first contact), if any.
Slug: CLOSE_MCP_FETCH_LEAD_SMART_VIEWFetch a lead smart view (saved search) by ID.

Input Parameters

string
required
ID of the lead smart view to fetch

Output

string
required
string
required
string
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_LEAD_STATUSFetch a lead status by ID.

Input Parameters

string
required
ID of the lead status to fetch

Output

string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_MEETING_TRANSCRIPTFetch a meeting’s Notetaker transcript(s) by meeting activity ID.Returns the meeting’s speaker breakdown, summary, and full speaker-labeled transcript text. Only covers Notetaker (meeting) transcripts; call transcripts are served by fetch_call.

Input Parameters

string
required
The ID of the meeting activity to fetch transcripts for.

Output

string
required
string
required
array
required
string
required
string
Slug: CLOSE_MCP_FETCH_MEMBERSHIPFetch one of the organization’s members by user id.

Input Parameters

string
required
The id of the user whose membership to fetch.

Output

object
required
object
required
boolean
required
string
required
string
required
string
required
Last time the membership was made inactive, in UTC.
string
required
Last time the membership was made active, in UTC.
Slug: CLOSE_MCP_FETCH_NOTEFetch an existing note by ID.Returns the full note details including title, text, and metadata.

Input Parameters

string
required
ID of the note to fetch

Output

string
required
string
required
Plaintext note content
string
boolean
string
required
string
string
string
Rich-text (HTML) note content
string
string
string
required
string
required
string
required
string
boolean
Slug: CLOSE_MCP_FETCH_OPPORTUNITYFetch a specific opportunity by ID.Returns the complete opportunity with all its details.

Input Parameters

string
required
ID of the opportunity to fetch

Output

string
required
string
Plaintext version of the note.
string
Value in cents
string
required
ID of the lead this opportunity belongs to
string
required
ID of the user assigned to this opportunity
string
Date the opportunity is expected to close (if active), or date the opportunity was won or lost.
string
required
Name of the lead this opportunity belongs to
string
Rich-text HTML version of the note, wrapped in <body>...</body>.
string
required
ID of the opportunity status
string
required
Name of the user assigned to this opportunity
integer
required
Confidence percentage (0-100)
string
ID of the contact for this opportunity
string
required
string
required
string
required
Type of the opportunity status
string
required
Name of the contact for this opportunity
string
required
string
required
Label of the opportunity status
string ("one_time" | "monthly" | "annual")
required
Period for the value
array
Custom field values set on this object
Slug: CLOSE_MCP_FETCH_OPPORTUNITY_STATUSFetch an opportunity status by ID.

Input Parameters

string
required
ID of the opportunity status to fetch

Output

string
required
string ("won" | "lost" | "active")
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_PIPELINE_AND_OPPORTUNITY_STATUSESFetch an opportunity pipeline, including its opportunity statuses, by ID.

Input Parameters

string
required
ID of the pipeline to fetch

Output

string
required
string
required
array
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_ROLEFetch one of the organization’s roles by id, with every permission it grants.Use list_roles to resolve a role name to its id.

Input Parameters

string
required
The id of the role to fetch.

Output

string
required
string
required
boolean
required
Whether this is one of Close’s built-in roles. Distinguishes a built-in from a custom role that shares its name.
array
required
Every permission the role grants, alphabetically.
Slug: CLOSE_MCP_FETCH_SMS_TEMPLATEFetch an SMS template by ID.Returns the complete SMS template with all its details.

Input Parameters

string
required
ID of the SMS template to fetch

Output

string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_FETCH_TASKFetch an existing task by ID.Returns the task’s details including the associated lead, contact, assignee, due date, priority, and completion status.

Input Parameters

string
required
ID of the task to fetch

Output

string
required
Unique task identifier
string
required
Task text/instructions
string
required
ID of the lead this task belongs to
string
required
Due date: datetime if task has specific time, date if date-only, None if task has no due date
string ("high" | "medium")
required
Task priority level
string
required
Name of the lead this task belongs to
string
ID of the associated contact, if any
string
required
When the task was created
string
required
When the task was last updated
string
required
ID of the user assigned to task
boolean
required
Whether task has been completed
string
Name of the associated contact, if any
string
required
Full name of the assigned user
Slug: CLOSE_MCP_FIND_CALL_OUTCOMESList all outcomes applicable to calls available in the organization.

Output

array
required
Slug: CLOSE_MCP_FIND_CALL_TASKSFind call tasks based on various filters. You can filter by lead, contact, assignee (a user or a voice agent), completion state, and scheduled/created/updated dates.

Input Parameters

string
Pagination cursor, give only when more results are requested.
string
Filter by lead ID
string
Filter by the scheduled call date range
string
Filter by contact ID
string
Filter by call task creation date range
string
Filter by call task last updated date range
string
Filter by the ID of the user the call task is assigned to
string
Filter by completion status. If not provided, both complete and incomplete call tasks are returned.
string
Filter by the ID of the voice agent the call task is dispatched to

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_CONTACT_CUSTOM_FIELDSList all contact custom fields defined for the organization.Includes both contact-specific fields and shared fields associated with contacts. Returns each field’s ID, name, description, type, allowed choices (for choice fields), whether multiple values are accepted, and whether it is a shared field. Useful for deciding which custom field to read or write when working with contacts.

Output

array
required
Slug: CLOSE_MCP_FIND_CUSTOM_ACTIVITIESList all active (non-archived) Custom Activity Types in the organization, along with the custom fields defined on each type.Call this before creating a workflow with a “custom-activity-event” trigger so you can look up the correct Custom Activity Type ID.

Output

array
required
Slug: CLOSE_MCP_FIND_CUSTOM_ACTIVITY_INSTANCESFind a lead’s custom activity instances based on various filters.A custom activity instance is an activity of a custom activity type, holding the custom field values defined by that type. Always scoped to a single lead; optionally filter by attributed user, one or more custom activity types, or activity date. Results are sorted by most recent activity first and are cursor-paginated.

Input Parameters

string
Pagination cursor for retrieving the next page
string
required
The lead whose custom activity instances to find
string
Filter custom activity instances by the user they are attributed to (their owner)
string
Filter custom activity instances by their activity date range
string
Filter by the custom activity types the instances belong to. Provide one or more type IDs to match instances of any of them.

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_CUSTOM_OBJECT_INSTANCESFind a lead’s custom object instances.A custom object instance is a record of a custom object type, attached to a lead and holding the custom field values defined by that type. Always scoped to a single lead; optionally filter to a single custom object type. Results are ordered by creation date (oldest first) and are cursor-paginated.

Input Parameters

string
Pagination cursor for retrieving the next page
string
required
The lead whose custom object instances to find
string
Filter to instances of a single custom object type. Use the find_custom_object_types tool to look up the available types.

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_CUSTOM_OBJECT_TYPESList all custom object types in the organization, along with the custom fields defined on each type.

Output

array
required
Slug: CLOSE_MCP_FIND_EMAIL_TEMPLATESList or find email templates

Input Parameters

string
Pagination cursor, give only when more results are requested.
string ("all" | "private" | "sharedWithUser" | "archived")
Use all to return all except archived.
Template name case-insensitive contains search

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_FORMSList all web forms in the organization.Call this before creating a workflow with a “form-submission-event” trigger so you can look up the correct Form ID.

Output

array
required
Slug: CLOSE_MCP_FIND_GROUPSList all groups in the organization.

Output

array
required
Slug: CLOSE_MCP_FIND_INVOICESFind the organization’s billing invoices, newest first.Invoices without a date sort first.

Input Parameters

integer
integer

Output

array
required
Slug: CLOSE_MCP_FIND_LEAD_CUSTOM_FIELDSList all lead custom fields defined for the organization.Returns each field’s ID, name, description, type, allowed choices (for choice fields), whether multiple values are accepted, and whether it is a shared field. Useful for deciding which custom field to read or write when working with leads.

Output

array
required
Slug: CLOSE_MCP_FIND_LEAD_SMART_VIEWSList lead smart views (saved searches).

Input Parameters

string
Pagination cursor, give only when more results are requested.
string ("pinned" | "all")
Filter to show only pinned smart views (those shown in the sidebar), or all available smart views. When the user asks about smart views you should filter for pinned smart views unless the user is requesting to see all views or searches by name.
string
Smart view name case-insensitive contains search. When using name search you should filter by all smart views.

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_LEAD_STATUSESList or find lead statuses for the organization

Output

array
required
Slug: CLOSE_MCP_FIND_MEETING_OUTCOMESList all outcomes applicable to meetings available in the organization.

Output

array
required
Slug: CLOSE_MCP_FIND_MEMBERSHIPSList the organization’s members with each member’s role name, whether the role is built-in or custom, active/inactive status, and join date. Richer than org_users — prefer this unless you only need a name or email. Most recent members first.

Input Parameters

boolean
If true, also return deactivated members.

Output

array
required
Slug: CLOSE_MCP_FIND_NOTESFind notes based on various filters.

Input Parameters

string
Pagination cursor for retrieving the next page
string
Filter notes by lead ID
string
Filter notes by the user who created them
string
Filter notes by associated contact ID
string
Filter notes by activity date range
string
Filter notes by creation date range

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_OPPORTUNITIESFind opportunities by status (active/won/lost), owner, lead, or close-date range, optionally only those needing attention, sorted by soonest close, largest value, or highest confidence. Returns each opportunity with resolved lead, contact, owner, and status names; cursor-paginated.

Input Parameters

string
Pagination cursor, give only when more results are requested.
string
string
Order the results; this does not filter them. Ordering by closing_soonest still returns far-out deals, so to restrict to a time window (e.g. ‘closing soon’) also set close_at.
string
Filter by when the opportunity is expected to close (the won or lost date for closed deals). Use this to answer time-bounded questions such as ‘closing soon’ or ‘closing this month’ by passing a date window. Sorting alone does not restrict the range: to only return deals closing within a period, set this filter.
string
string
string
string
string
string
string
Filter by opportunities that may be stalled and need attention. To see why the an opportunity is stalled, direct the user to the opportunities pipeline page.

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_OPPORTUNITY_CUSTOM_FIELDSList all opportunity custom fields defined for the organization.Includes both opportunity-specific fields and shared fields associated with opportunities. Returns each field’s ID, name, description, type, allowed choices (for choice fields), whether multiple values are accepted, and whether it is a shared field. Useful for deciding which custom field to read or write when working with opportunities.

Output

array
required
Slug: CLOSE_MCP_FIND_PIPELINES_AND_OPPORTUNITY_STATUSESList all opportunity pipelines and their opportunity statuses in the organization.

Output

array
required
Slug: CLOSE_MCP_FIND_SMS_TEMPLATESList or find SMS templates

Input Parameters

string
Pagination cursor, give only when more results are requested.
string ("all" | "private" | "sharedWithUser" | "archived")
Use all to return all except archived.
string
Template name case-insensitive contains search

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_TASKSFind tasks based on various filters. You can filter by lead, assignee, completion state, and due/created/ updated dates.

Input Parameters

string
Pagination cursor, give only when more results are requested.
string
Filter by lead ID
string
Filter by task due date range
string
Filter by task creation date range
string
Filter by task last updated date range
string
Filter by the ID of the user the task is assigned to
string
Filter by completion status. If not provided, both complete and incomplete tasks are returned.

Output

string
array
required
string
Slug: CLOSE_MCP_FIND_VOICE_AGENTSList all voice agents configured for the organization. Voice agents are AI callers that place outbound calls to leads’ contacts on the user’s behalf.Returns each voice agent’s ID and name. Use this to find the right voice agent ID when scheduling a call or assigning a call step in a workflow.Users may refer to voice agents as “voice agents”, “Chloe”, or by their configured name. When more than one agent exists, pick the most appropriate one based on the name.

Output

array
required
Slug: CLOSE_MCP_FIND_WORKFLOWSList or find workflows

Input Parameters

string
Pagination cursor, give only when more results are requested.
string ("all" | "active" | "paused" | "draft")
string
Workflow name case-insensitive contains search

Output

string
array
required
string
Slug: CLOSE_MCP_GET_AI_CREDIT_USAGEAI credit usage for the billing account, broken down by feature.Reports total credits used and a per-feature breakdown. Credits are the billing unit for AI features. Usage covers the whole billing account, not a single organization. Omit start/end for the current billing period; the result’s start/end report the window actually measured. Explicit ranges must be timezone-aware and span at most 366 days. Older ranges may return empty or partial data — zero usage for an old range does not mean no activity. On a rate-limited error, retry after retry_after seconds.

Input Parameters

string
End of the period. Timezone-aware; seconds are ignored. Provide both start and end, or neither; omit both for the current billing period.
string
Start of the period. Timezone-aware; seconds are ignored. Provide both start and end, or neither; omit both for the current billing period.

Output

string
required
End of the measured period: the requested end, or the billing period end if the range was omitted. The queried window is minute-aligned.
string
required
Start of the measured period: the requested start, or the billing period start if the range was omitted. The queried window is minute-aligned.
array
required
integer
required
Slug: CLOSE_MCP_GET_BILLING_SUMMARYBilling summary for the organization’s billing account.Reports the subscription plan, billing status with the trial end date, seat counts, and AI usage availability, tier, and credit allowance for the current billing cycle. Whether the account is on trial is status, not anything under ai_usage. Use get_ai_credit_usage for the credits actually used.

Output

string ("paying" | "canceled" | "trial" | "trial_expired" | "fake" | "archived")
required
Billing status of the account, and the only signal for whether it is on trial: trial is an active trial, trial_expired a lapsed one, paying a converted account. The rest are inactive. AI usage can be blocked during a trial, so this is independent of ai_usage.availability_status.
string
required
AI usage availability, tier, and total credit allowance. Null only when the account has no AI usage status record.
string
required
Name of the subscription plan.
integer
required
Version of the plan lineup the plan belongs to; plans with the same name can differ across versions.
string
required
When the trial ends or ended (UTC). Null if the account never had a trial.
integer
required
Number of seats granted to the account for free and not charged for.
integer
required
Number of seats the account is charged for. Excludes free seats and non-billable users.
Slug: CLOSE_MCP_GET_FIELDSUse this tool ONLY to get a list of fields for the aggregation tool.
Slug: CLOSE_MCP_GET_VOICE_AGENT_OVERVIEW_REPORTCross-agent rollup for the Voice Agents list page.Returns one row per active agent — agents with completed calls in date_range or queued upcoming calls. Cumulative funnel counts (answered, engaged, objective_met) plus total_calls. upcoming_calls is the agent’s queued (not yet completed) calls and is not bound by date_range — open tasks are open regardless of when scheduled (so an agent with only upcoming calls still appears). Use this to compare agents; for one agent’s outcomes, sentiment, or time saved use get_voice_agent_performance_report. For an inventory of all configured voice agents regardless of activity, use find_agent_configs.The Voice Agents list (Agents tab) shows all-time stats, so leave date_range at its default (all_time) unless the user asks for a specific window. (The Upcoming and Recent tabs are call lists, not this rollup — search Calls for those.)Rows are sorted server-side per the sort field (default most_calls); pass a different mode rather than re-sorting in your reply. Set reverse=True to invert (e.g. sort=most_calls, reverse=True for least active first) — necessary to surface the bottom of the ordering, since rows are capped before they reach you. truncated and total_agent_count flag in-scope active agents; dormant_agent_count reports in-scope agents with neither completed calls in the date range nor queued upcoming calls (not included in rows).

Input Parameters

string ("most_calls" | "agent_name" | "most_recently_used" | "most_answered" | "most_engaged" | "most_objective_met")
boolean
string ("yesterday" | "last_week" | "last_month" | "last_quarter" | "last_year" | "today" | "this_week" | "this_month" | "this_quarter" | "this_year" | "tomorrow" | "next_week" | "next_month" | "next_quarter" | "next_year" | "all_time")
string

Output

array
required
boolean
required
integer
required
integer
required
Slug: CLOSE_MCP_GET_VOICE_AGENT_PERFORMANCE_REPORTPerformance metrics for one voice agent.Returns the numbers shown on the Performance tab of a Voice Agent detail page. Passing multiple agent_config_ids pools metrics into a single aggregate (not a per-agent breakdown — for that, use get_voice_agent_overview_report). For per-call drill-down, search Calls filtered by agent_config_id.When the user is on a Voice Agent page, pull date_range from page_context.date_range so the numbers match the UI.Percentages: *_pct is over total_calls; engaged_over_answered_pct and objective_met_over_answered_pct are over answered (tier-to-tier conversion). For any other denominator, compute from *_count.funnel_previous_period_deltas is null when the date range has no defined previous period (e.g. all_time).

Input Parameters

string ("yesterday" | "last_week" | "last_month" | "last_quarter" | "last_year" | "today" | "this_week" | "this_month" | "this_quarter" | "this_year" | "tomorrow" | "next_week" | "next_month" | "next_quarter" | "next_year" | "all_time")
array
required

Output

array
required
number
required
integer
required
number
required
integer
required
integer
required
string
required
integer
required
number
required
integer
required
integer
required
integer
required
array
required
number
required
string
required
number
required
Slug: CLOSE_MCP_GET_VOICE_AGENTSReturn detailed configuration for one or more voice agents.Includes each agent’s objective, user instructions, and which skills are enabled. Use this as the follow-up to find_voice_agents once one or more agent IDs have been selected.

Input Parameters

array
required
IDs of the voice agents (AgentConfig) to fetch details for. Up to 30 IDs per call. Use find_voice_agents to discover available agent IDs.

Output

array
required
Slug: CLOSE_MCP_LEAD_SEARCHPerform a simple lead search and return the initial set of results.Use this to retrieve all leads, most recent leads, search leads by keyword, or filter by lead status and smart view. For more complex searches use the search tool instead.Leads will be returned by last updated first.

Input Parameters

string
Search lead name or contact name
string
Full text search
string
Filter by smart view
string
Filter by lead status

Output

object
required
string
required
string
required
Slug: CLOSE_MCP_LIST_MEMBERSHIP_REQUESTSList pending requests to join the current organization.Each entry includes the requesting user’s name and email, the request id, and when the request was created.

Output

array
required
Slug: CLOSE_MCP_LIST_ROLESList the roles that can be assigned in the organization.Covers Close’s built-in roles plus any custom roles the org defines. Use this to resolve a role name to its id, or to see which roles grant organization management access.

Output

array
required
Slug: CLOSE_MCP_ORG_INFOReturn general information about the organization and the user.

Output

object
required
object
required
Slug: CLOSE_MCP_ORG_USERSReturn active users (memberships) which are part of the current org.

Output

array
required
Slug: CLOSE_MCP_PAGINATE_SEARCHPaginate a search to retrieve more results.Provide exactly one of:
  • search_id: a share_* id from a previous search or shared entry, or
  • smart_view_id: a save_* Smart View (saved search) id the user is viewing.

Input Parameters

string
Pagination cursor
string
Shared-entry/search id (share_*) to paginate
string
Smart View (saved search) id (save_*) to paginate

Output

string
array
required
string
Slug: CLOSE_MCP_PROPOSE_VOICE_AGENT_UPDATEPropose a voice agent configuration update from natural-language feedback.This tool does not apply changes to the voice agent. It returns a short behavioral summary and proposal ID when the requested edit is clear. If the feedback is ambiguous, it returns clarification questions instead of making a proposal. Use apply_voice_agent_update with the proposal ID only after the user approves the proposal.

Input Parameters

string
required
Natural-language feedback describing how the voice agent should change.
string
Existing proposal ID to refine. Omit when creating a new proposal.
string
required
ID of the voice agent to update.

Output

string ("proposal" | "clarification")
required
string
string
Slug: CLOSE_MCP_SCHEDULE_VOICE_AGENT_CALLSchedule a voice agent to call a lead’s contact.Creates a call task assigned to the voice agent. The voice agent will place the call automatically at the scheduled time, or as soon as the queue picks it up when no time is given.Use find_voice_agents first to discover which voice agents are available in this organization.

Input Parameters

string
required
ID of the lead to call.
string
Optional contact to call. If omitted, the first contact on the lead that has a phone number will be selected.
string
When the call should be made. ISO 8601 datetime, timezone-aware. If omitted, the call is scheduled to run as soon as the voice agent queue picks it up (ASAP).
string
required
ID of the voice agent (AgentConfig) that should make the call. Use find_voice_agents to discover available agents.

Output

string
required
ID of the created call task.
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_SEARCHPerform a natural language search for leads or contacts.If a more specific search tool (like lead_search or activity_search) satisfies the request, use that tool instead.You can reference related objects like activities (such as calls, emails, meetings, notes, custom activities, etc.), opportunities, tasks as long as they are part of a lead query.Example queries:
  • leads not contacted in the past week
  • leads assigned to me with uncompleted tasks
  • leads with an active opportunity over $500
  • contacts with CTO title
Each returned result will contain a title label, preview text, object ID, and URL.The initial set of results, total count of all results, and a URL to open the results in Close is returned. To retrieve more results, use the returned cursor and call the paginate_search tool using the cursor and search ID returned in this response.

Input Parameters

string
required

Output

string
required
string
string ("partial" | "success")
required
array
required
string
string
required
string
required
string
Slug: CLOSE_MCP_UPDATE_CALL_TASKUpdate a call task.Only fields that are provided will be updated. Reassigning to a user or voice agent (agent_config_id) affects only this task. Completing a call task also completes every sibling task sharing its deduplication key.

Input Parameters

string
required
The ID of the call task to update.
string
Updated call task text.
string
Updated due date or datetime for the call task. Can be a date (YYYY-MM-DD) or datetime (ISO 8601).
string
Resolution to set when completing the call task, e.g. ‘skipped’.
string
Reassign the call task to this user. Mutually exclusive with agent_config_id.
string
Mark the call task as complete (true) or reopen it (false). Completing a call task also completes every sibling task sharing its deduplication key.
string
Reassign (dispatch) the call task to this voice agent. Mutually exclusive with assigned_to.

Output

string
required
string
Call task text/instructions
boolean
required
string
ID of the associated Call activity, if any
string
required
ID of the lead this call task belongs to
string
required
Date and time of the scheduled call (ISO 8601)
string
required
Name of the lead this call task belongs to
string
required
ID of the associated contact
string
required
string
required
string
required
string
ID of the user assigned to this call task (None when assigned to an agent)
boolean
required
Whether the call task has been completed
string
required
Name of the associated contact
string
Full name of the assigned user (None when assigned to an agent)
string
ID of the voice agent config (non-null when assigned to a voice agent)
string
Name of the voice agent (non-null when assigned to a voice agent)
string
required
Slug: CLOSE_MCP_UPDATE_CONTACTUpdate an existing contact.You can update a contact’s name, title, email addresses, phone numbers, and URLs. Only fields that are provided will be updated.

Input Parameters

string
required
ID of the contact to update
string
Name of the contact
string
When providing this field, you must provide the full updated list of URLs for the contact.
string
Job title of the contact
string
When providing this field, you must provide the full updated list of email addresses for the contact.
string
When providing this field, you must provide the full updated list of phone numbers for the contact.
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
array
string
array
array
string
required
string
required
string
string
required
string
string
required
array
Custom field values set on this object
Slug: CLOSE_MCP_UPDATE_CUSTOM_ACTIVITY_INSTANCEUpdate an existing custom activity instance.A custom activity instance is an activity of a custom activity type, holding the custom field values defined by that type.Only fields that are provided will be updated. For custom fields, only the custom fields included are modified; pass null to clear one. Pass ‘clear’ for contact_id to detach the contact.

Input Parameters

string
required
ID of the custom activity instance to update
string
Whether to pin the custom activity to the top of the lead’s timeline
string
New status of the custom activity. Publishing a draft validates required custom fields; leave unset to keep the current status.
string
ID of the contact to associate with the custom activity; must belong to the same lead. Pass ‘clear’ to remove the existing contact.
string
When the custom activity occurred
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
Unique identifier of the custom activity instance
boolean
required
Whether the custom activity is pinned to the top of the lead’s timeline
string ("draft" | "published")
required
Whether the custom activity is published or draft; draft instances skip required custom-field validation
string
required
ID of the lead this custom activity belongs to
string
ID of the user the custom activity is attributed to (its owner; may differ from the creator)
string
Name of the lead this custom activity belongs to
string
When the custom activity was pinned, or null if it is not pinned
string
Full name of the user the custom activity is attributed to
string
ID of the contact on the lead this custom activity is associated with, if any
string
required
When the custom activity was created
string
ID of the user who created the custom activity
string
required
When the custom activity was last updated
string
ID of the user who last updated the custom activity
string
required
When the activity occurred; may be backdated and differ from the creation time
string
Name of the associated contact, if any
array
Custom field values set on this object
string
Full name of the user who created the custom activity
string
Full name of the user who last updated the custom activity
string
When the custom activity was last published, or null if it has only ever been a draft
string
required
ID of the custom activity type that defines this instance’s shape and custom fields
string
Name of the custom activity type that defines this instance’s shape and custom fields
Slug: CLOSE_MCP_UPDATE_CUSTOM_OBJECT_INSTANCEUpdate an existing custom object instance.A custom object instance is a record of a custom object type, attached to a lead and holding the custom field values defined by that type.Only fields that are provided will be updated. For custom fields, only the custom fields included are modified; pass null to clear one.

Input Parameters

string
required
ID of the custom object instance to update
string
New display name for the custom object instance; leave unset to keep the current name.
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
Unique identifier of the custom object instance
string
Display name of the custom object instance
string
required
ID of the lead this custom object belongs to
string
Name of the lead this custom object belongs to
string
required
When the custom object was created
string
ID of the user who created the custom object
string
required
When the custom object was last updated
string
ID of the user who last updated the custom object
array
Custom field values set on this object
string
Full name of the user who created the custom object
string
Full name of the user who last updated the custom object
string
required
ID of the custom object type that defines this instance’s shape and custom fields
string
Name of the custom object type this instance belongs to
Slug: CLOSE_MCP_UPDATE_DRAFT_EMAILUpdate an existing draft email.Only draft emails can be updated; sent or scheduled emails are rejected. Only fields that are provided are changed. When the body is replaced the sender’s saved email signature is appended again. This never sends the email.

Input Parameters

string
List of CC email addresses
string
required
ID of the draft email to update
string
List of recipient email addresses
string
List of BCC email addresses
string
Email address of a connected sending identity, including aliases. Must match an available sender for the current user.
string
Subject line of the email
string
Draft body as Close rich text (HTML). Wrap the whole content in a single <body> tag and put each line/paragraph in a block-level tag. Supported tags include <p>, <h1>-<h6>, <ul>/<ol> with <li>, <blockquote>, <hr>, <a href=…>,
, and inline formatting <strong>/<b>, <em>/<i>, <u>, <s>, <code>, <span>. Escape literal ampersands as ’&’. Example: <body><p>Hi <strong>Jane</strong>,</p><p>Following up on our call.</p></body>. Do not include a signature block (name, title, company, contact details); the sender’s saved email signature is appended automatically. A short closing line such as ‘Best,’ is fine.
string
Plaintext body content. Prefer body_html; if only one of body_html/body_text is provided the other is derived automatically.
string
ID of the contact this draft email is addressed to

Output

array
string
required
array
array
string
string
required
string
string
string
string
Rich-text (HTML) body content
string
Plaintext body content
string
string
required
string
required
Slug: CLOSE_MCP_UPDATE_EMAIL_TEMPLATEUpdate an existing email template.Only fields that are provided and not None will be updated.Handling of attachments and unsubscribe links via this tool is currently unsupported.Email template body should be HTML formatted.Use template tags as placeholders, for example: {{ organization.name }} to refer to the sender’s organization name. {{ user.first_name }} {{ user.last_name }} {{ user.email }} {{ user.phone }} to refer to the user sending the email. {{ lead.display_name }} to refer to the lead name (recipient’s name/company). {{ contact.first_name }} {{ contact.last_name }} to refer to the recipient.

Input Parameters

string
string
required
ID of the email template to update
string
string
string
string
string
string

Output

array
required
string
required
array
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_LEADUpdate an existing lead (company).Only fields that are provided and not None will be updated.

Input Parameters

string
required
ID of the lead to update
string
URL of the lead’s website
string
Name of the lead
string
ID of the lead status
string
Description of the lead
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
required
string
required
array
required
string
required
string
string
required
string
string
required
string
string
required
array
Custom field values set on this object
string
ID of the lead’s primary contact (its first contact), if any.
Slug: CLOSE_MCP_UPDATE_LEAD_SMART_VIEWUpdate a lead smart view (saved search).Only fields that are provided and not None will be updated.

Input Parameters

string
required
ID of the lead smart view to update
string
New name for the smart view
string
New description for the smart view

Output

string
required
string
required
string
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_LEAD_STATUSUpdate the label of an existing lead status.

Input Parameters

string
required
ID of the lead status to update
string
required
New label for the lead status

Output

string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_NOTEUpdate an existing note.Only fields that are provided will be updated. Note content is provided as rich text (HTML) via note_html; the plaintext note is automatically derived.

Input Parameters

string
required
ID of the note to update
string
Title of the note. Pass an empty string to remove the existing title.
string
Whether to pin the note to the top of the lead
string
Updated note content as Close rich text (HTML). Must be a valid Close rich-text document: wrap the whole content in a single <body> tag and put each line/paragraph in a block-level tag. Supported tags include <p>, <h1>-<h6>, <ul>/<ol> with <li>, <blockquote>, <hr>, <a href=…>,
, and inline formatting <strong>/<b>, <em>/<i>, <u>, <s>, <code>, <span>. Escape literal ampersands as ’&’. Example: <body><p>Spoke with <strong>Jane</strong> about pricing.</p><ul><li>Wants a demo</li><li>Budget approved</li></ul></body>
string
ID of the contact to associate with the note. Pass ‘clear’ to remove the existing contact.
string
When the note activity occurred

Output

string
required
string
required
Plaintext note content
string
boolean
string
required
string
string
string
Rich-text (HTML) note content
string
string
string
required
string
required
string
required
string
boolean
Slug: CLOSE_MCP_UPDATE_OPPORTUNITYUpdate an existing opportunity.Only fields that are provided will be updated. The value should be specified in cents (e.g., $100.00 = 10000).

Input Parameters

string
required
ID of the opportunity to update
string
Plaintext version of the note.
string
Value in cents. Pass clear to clear an existing value.
string
ID of the user assigned to this opportunity
string
Expected close date. Pass clear to clear an existing date.
string
Rich-text HTML version of the note, wrapped in <body>...</body> (e.g. <body><p>text with <strong>bold</strong></p></body>). When set, note is automatically derived from it, overriding any note value passed in the same request.
string
ID of the opportunity status
string
Confidence percentage (0-100)
string
ID of the primary contact for this opportunity
string
Period for the value
array
Custom field values to set on this object. Only the custom fields included are modified; omitted fields are left unchanged.

Output

string
required
string
Plaintext version of the note.
string
Value in cents
string
required
ID of the lead this opportunity belongs to
string
required
ID of the user assigned to this opportunity
string
Date the opportunity is expected to close (if active), or date the opportunity was won or lost.
string
required
Name of the lead this opportunity belongs to
string
Rich-text HTML version of the note, wrapped in <body>...</body>.
string
required
ID of the opportunity status
string
required
Name of the user assigned to this opportunity
integer
required
Confidence percentage (0-100)
string
ID of the contact for this opportunity
string
required
string
required
string
required
Type of the opportunity status
string
required
Name of the contact for this opportunity
string
required
string
required
Label of the opportunity status
string ("one_time" | "monthly" | "annual")
required
Period for the value
array
Custom field values set on this object
Slug: CLOSE_MCP_UPDATE_OPPORTUNITY_STATUS_TOOLUpdate the label of an existing opportunity status.

Input Parameters

string
required
ID of the opportunity status to update
string
required
New label for the opportunity status

Output

string
required
string ("won" | "lost" | "active")
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_PIPELINEUpdate an existing opportunity pipeline.Only fields that are provided will be updated.

Input Parameters

string
required
ID of the pipeline to update
string
New name for the pipeline

Output

string
required
string
required
array
required
string
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_SMS_TEMPLATEUpdate an existing SMS template.Only fields that are provided will be updated. Fields that are not provided will remain unchanged.Handling of attachments via this tool is currently unsupported.Use template tags as placeholders, for example: {{ organization.name }} to refer to the sender’s organization name. {{ user.first_name }} {{ user.last_name }} {{ user.email }} {{ user.phone }} to refer to the user sending the message. {{ lead.display_name }} to refer to the lead name (recipient’s name/company). {{ contact.first_name }} {{ contact.last_name }} to refer to the recipient.

Input Parameters

string
required
ID of the SMS template to update
string
string
string
string

Output

string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
string
required
boolean
required
string
required
string
required
string
required
Slug: CLOSE_MCP_UPDATE_TASKUpdate an existing task.Only fields that are provided will be updated. Pass ‘clear’ for contact_id or due_date to clear those values.

Input Parameters

string
required
ID of the task to update
string
Updated task description. Cannot be blank.
string
Due date or datetime for the task. Can be a date (YYYY-MM-DD) or datetime (ISO 8601). Pass ‘clear’ to make the task dateless (due immediately).
string
Task priority: ‘high’ or ‘medium’. Only set to ‘high’ if the user explicitly says it’s a high priority task.
string
ID of the contact associated with this task. Must belong to the task’s lead. Pass ‘clear’ to remove the existing contact.
string
ID of the user to assign the task to. Tasks must always have an assignee, so this cannot be cleared.
string
Mark the task as complete (true) or reopen it (false).

Output

string
required
Unique task identifier
string
required
Task text/instructions
string
required
ID of the lead this task belongs to
string
required
Due date: datetime if task has specific time, date if date-only, None if task has no due date
string ("high" | "medium")
required
Task priority level
string
required
Name of the lead this task belongs to
string
ID of the associated contact, if any
string
required
When the task was created
string
required
When the task was last updated
string
required
ID of the user assigned to task
boolean
required
Whether task has been completed
string
Name of the associated contact, if any
string
required
Full name of the assigned user