- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 114
- Triggers: 0
- Slug:
CLOSE_MCP - Version: 20261018_00
Tools
Activity search
Activity search
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
Output
Aggregation
Aggregation
Apply voice agent update
Apply voice agent update
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
Output
Close product knowledge search
Close product knowledge search
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
- “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
Output
Create address
Create address
Create call task
Create call task
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
Output
Create comment
Create comment
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
, 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>Output
Create contact
Create contact
Create custom activity instance
Create custom activity instance
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
Output
Create custom object instance
Create custom object instance
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
Output
Create draft email
Create draft email
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
, 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.
Output
Create email template
Create email template
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
Output
Create lead
Create lead
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
Output
Create lead status
Create lead status
Create note
Create note
Create opportunity
Create opportunity
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
<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.Output
Create opportunity status tool
Create opportunity status tool
Create pipeline
Create pipeline
Create sms template
Create sms template
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
Output
Create task
Create task
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
Output
Create workflow
Create workflow
CLOSE_MCP_CREATE_WORKFLOWCreate a new workflow (a.k.a. sequence) with Draft status.Input Parameters
step_type of each step has to exactly match one of the defined types in the mapping.trigger_type must exactly match one of the defined types. Use ‘contact-manual’ (the default) when the user does not specify a trigger.Output
Customized builtin labels
Customized builtin labels
Delete address
Delete address
Delete call task
Delete call task
Delete contact
Delete contact
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
Delete custom activity instance
Delete custom activity instance
Delete custom object instance
Delete custom object instance
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
Delete email template
Delete email template
Delete lead
Delete lead
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
Delete lead smart view
Delete lead smart view
Delete lead status
Delete lead status
Delete note
Delete note
Delete opportunity
Delete opportunity
Delete opportunity status tool
Delete opportunity status tool
Delete pipeline
Delete pipeline
Delete sms template
Delete sms template
Delete task
Delete task
Enrich field
Enrich field
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
Output
Fetch call
Fetch call
CLOSE_MCP_FETCH_CALLFetch a single call activity by ID.Returns the call’s direction, outcome, participants, and (if available) its transcript.Input Parameters
Output
Fetch comment
Fetch comment
Fetch contact
Fetch contact
Fetch custom activity instance
Fetch custom activity instance
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
Output
Fetch custom object instance
Fetch custom object instance
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
Output
Fetch custom object type
Fetch custom object type
Fetch email template
Fetch email template
Fetch invoice
Fetch invoice
CLOSE_MCP_FETCH_INVOICEFetch one of the organization’s billing invoices by id.Input Parameters
Output
Fetch lead smart view
Fetch lead smart view
Fetch lead status
Fetch lead status
Fetch meeting transcript
Fetch meeting transcript
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
Output
Fetch membership
Fetch membership
Fetch note
Fetch note
Fetch opportunity
Fetch opportunity
Fetch opportunity status
Fetch opportunity status
Fetch pipeline and opportunity statuses
Fetch pipeline and opportunity statuses
Fetch role
Fetch role
Fetch sms template
Fetch sms template
Fetch task
Fetch task
Find call outcomes
Find call outcomes
Find call tasks
Find call tasks
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
Output
Find contact custom fields
Find contact custom fields
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
Find custom activities
Find custom activities
Find custom activity instances
Find custom activity instances
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
Output
Find custom object instances
Find custom object instances
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
Output
Find custom object types
Find custom object types
Find email templates
Find email templates
Find forms
Find forms
Find invoices
Find invoices
Find lead custom fields
Find lead custom fields
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
Find lead smart views
Find lead smart views
CLOSE_MCP_FIND_LEAD_SMART_VIEWSList lead smart views (saved searches).Input Parameters
Output
Find lead statuses
Find lead statuses
Find meeting outcomes
Find meeting outcomes
Find memberships
Find memberships
Find opportunities
Find opportunities
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
Output
Find opportunity custom fields
Find opportunity custom fields
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
Find pipelines and opportunity statuses
Find pipelines and opportunity statuses
Find scheduling links
Find scheduling links
Find sms templates
Find sms templates
Find tasks
Find tasks
Find voice agents
Find voice agents
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
Find workflows
Find workflows
Get ai credit usage
Get ai credit usage
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
Output
Get billing summary
Get billing summary
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
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.Get fields
Get fields
CLOSE_MCP_GET_FIELDSUse this tool ONLY to get a list of fields for the aggregation tool.Get voice agent overview report
Get voice agent overview report
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
Output
Get voice agent performance report
Get voice agent performance report
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
Output
Get voice agents
Get voice agents
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
find_voice_agents to discover available agent IDs.Output
Lead search
Lead search
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
Output
List membership requests
List membership requests
List roles
List roles
Org info
Org info
Org users
Org users
Paginate search
Paginate search
Propose voice agent update
Propose voice agent update
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
Output
Schedule voice agent call
Schedule voice agent call
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
find_voice_agents to discover available agents.Output
Search
Search
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
Input Parameters
Output
Update call task
Update call task
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
Output
Update contact
Update contact
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
Output
Update custom activity instance
Update custom activity instance
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
Output
Update custom object instance
Update custom object instance
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
Output
Update draft email
Update draft email
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
, 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.
Output
Update email template
Update email template
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
Output
Update lead
Update lead
Update lead smart view
Update lead smart view
Update lead status
Update lead status
Update note
Update note
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
, 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>
Output
Update opportunity
Update opportunity
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
<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.Output
Update opportunity status tool
Update opportunity status tool
Update pipeline
Update pipeline
Update sms template
Update sms template
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
Output
Update task
Update task
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.