# Intercom — how to use (mcp.ai)

Intercom provides live chat, messaging, and customer engagement tools, enabling businesses to drive conversions, handle support, and personalize communication at scale

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_intercom?ms=1781541720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `intercom_add_subscription_to_a_contact`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/intercom`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/intercom/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/intercom/add/subscription/to/a/contact` — You can add a specific subscription to a contact. in intercom, we have two different subscription types based on user consent - opt-out and opt-in: 1.attaching a contact to an opt-out subscription typ
  - body: { id: string, contact_id: string, consent_type: string }
- `POST https://api.mcp.ai/api/intercom/add/tag/to/a/contact` — You can tag a specific contact. this will return a tag object for the tag that was added to the contact.
  - body: { id: string, contact_id: string }
- `POST https://api.mcp.ai/api/intercom/assign/conversation` — Assigns a conversation to a specific admin or team in intercom
  - body: { team_id?: string, admin_id?: string, assignee_id?: string, conversation_id: string }
- `POST https://api.mcp.ai/api/intercom/attach/a/contact/to/a/company` — You can attach a company to a single contact.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/close/conversation` — Closes a conversation in intercom, marking it as resolved
  - body: { body?: string, admin_id: string, conversation_id: string }
- `POST https://api.mcp.ai/api/intercom/create/a/collection` — You can create a new collection by making a post request to `https://api.intercom.io/help center/collections.`
  - body: { name: string, parent_id?: string, description?: string, help_center_id?: integer, translated__content__type?: string, translated__content__ar__name?: string, translated__content__ar__type?: string, translated__content__bg__name?: string, translated__content__bg__type?: string, translated__content__bs__name?: string, translated__content__bs__type?: string, translated__content__ca__name?: string, translated__content__ca__type?: string, translated__content__cs__name?: string, translated__content__cs__type?: string, translated__content__da__name?: string, translated__content__da__type?: string, translated__content__de__name?: string, translated__content__de__type?: string, translated__content__el__name?: string, translated__content__el__type?: string, translated__content__en__name?: string, translated__content__en__type?: string, translated__content__es__name?: string, translated__content__es__type?: string, translated__content__et__name?: string, translated__content__et__type?: string, translated__content__fi__name?: string, translated__content__fi__type?: string, translated__content__fr__name?: string, translated__content__fr__type?: string, translated__content__he__name?: string, translated__content__he__type?: string, translated__content__hr__name?: string, translated__content__hr__type?: string, translated__content__hu__name?: string, translated__content__hu__type?: string, translated__content__id__name?: string, translated__content__id__type?: string, translated__content__it__name?: string, translated__content__it__type?: string, translated__content__ja__name?: string, translated__content__ja__type?: string, translated__content__ko__name?: string, translated__content__ko__type?: string, translated__content__lt__name?: string, translated__content__lt__type?: string, translated__content__lv__name?: string, translated__content__lv__type?: string, translated__content__mn__name?: string, translated__content__mn__type?: string, translated__content__nb__name?: string, translated__content__nb__type?: string, translated__content__nl__name?: string, translated__content__nl__type?: string, translated__content__pl__name?: string, translated__content__pl__type?: string, translated__content__pt__name?: string, translated__content__pt__type?: string, translated__content__ro__name?: string, translated__content__ro__type?: string, translated__content__ru__name?: string, translated__content__ru__type?: string, translated__content__sl__name?: string, translated__content__sl__type?: string, translated__content__sr__name?: string, translated__content__sr__type?: string, translated__content__sv__name?: string, translated__content__sv__type?: string, translated__content__tr__name?: string, translated__content__tr__type?: string, translated__content__vi__name?: string, translated__content__vi__type?: string, translated__content__pt__BR__name?: string, translated__content__pt__BR__type?: string, translated__content__zh__CN__name?: string, translated__content__zh__CN__type?: string, translated__content__zh__TW__name?: string, translated__content__zh__TW__type?: string, translated__content__ar__description?: string, translated__content__bg__description?: string, translated__content__bs__description?: string, translated__content__ca__description?: string, translated__content__cs__description?: string, translated__content__da__description?: string, translated__content__de__description?: string, translated__content__el__description?: string, translated__content__en__description?: string, translated__content__es__description?: string, translated__content__et__description?: string, translated__content__fi__description?: string, translated__content__fr__description?: string, translated__content__he__description?: string, translated__content__hr__description?: string, translated__content__hu__description?: string, translated__content__id__description?: string, translated__content__it__description?: string, translated__content__ja__description?: string, translated__content__ko__description?: string, translated__content__lt__description?: string, translated__content__lv__description?: string, translated__content__mn__description?: string, translated__content__nb__description?: string, translated__content__nl__description?: string, translated__content__pl__description?: string, translated__content__pt__description?: string, translated__content__ro__description?: string, translated__content__ru__description?: string, translated__content__sl__description?: string, translated__content__sr__description?: string, translated__content__sv__description?: string, translated__content__tr__description?: string, translated__content__vi__description?: string, translated__content__pt__BR__description?: string, translated__content__zh__CN__description?: string, translated__content__zh__TW__description?: string }
- `POST https://api.mcp.ai/api/intercom/create/a/note` — You can add a note to a single contact.
  - body: { id: integer, body: string, admin_id?: string, contact_id?: string }
- `POST https://api.mcp.ai/api/intercom/create/an/article` — You can create a new article by making a post request to `https://api.intercom.io/articles`.
  - body: { body?: string, state?: string, title: string, author_id: integer, parent_id?: integer, description?: string, parent_type?: string, translated__content__type?: string, translated__content__ar__url?: string, translated__content__bg__url?: string, translated__content__bs__url?: string, translated__content__ca__url?: string, translated__content__cs__url?: string, translated__content__da__url?: string, translated__content__de__url?: string, translated__content__el__url?: string, translated__content__en__url?: string, translated__content__es__url?: string, translated__content__et__url?: string, translated__content__fi__url?: string, translated__content__fr__url?: string, translated__content__he__url?: string, translated__content__hr__url?: string, translated__content__hu__url?: string, translated__content__id__url?: string, translated__content__it__url?: string, translated__content__ja__url?: string, translated__content__ko__url?: string, translated__content__lt__url?: string, translated__content__lv__url?: string, translated__content__mn__url?: string, translated__content__nb__url?: string, translated__content__nl__url?: string, translated__content__pl__url?: string, translated__content__pt__url?: string, translated__content__ro__url?: string, translated__content__ru__url?: string, translated__content__sl__url?: string, translated__content__sr__url?: string, translated__content__sv__url?: string, translated__content__tr__url?: string, translated__content__vi__url?: string, translated__content__ar__body?: string, translated__content__ar__type?: string, translated__content__bg__body?: string, translated__content__bg__type?: string, translated__content__bs__body?: string, translated__content__bs__type?: string, translated__content__ca__body?: string, translated__content__ca__type?: string, translated__content__cs__body?: string, translated__content__cs__type?: string, translated__content__da__body?: string, translated__content__da__type?: string, translated__content__de__body?: string, translated__content__de__type?: string, translated__content__el__body?: string, translated__content__el__type?: string, translated__content__en__body?: string, translated__content__en__type?: string, translated__content__es__body?: string, translated__content__es__type?: string, translated__content__et__body?: string, translated__content__et__type?: string, translated__content__fi__body?: string, translated__content__fi__type?: string, translated__content__fr__body?: string, translated__content__fr__type?: string, translated__content__he__body?: string, translated__content__he__type?: string, translated__content__hr__body?: string, translated__content__hr__type?: string, translated__content__hu__body?: string, translated__content__hu__type?: string, translated__content__id__body?: string, translated__content__id__type?: string, translated__content__it__body?: string, translated__content__it__type?: string, translated__content__ja__body?: string, translated__content__ja__type?: string, translated__content__ko__body?: string, translated__content__ko__type?: string, translated__content__lt__body?: string, translated__content__lt__type?: string, translated__content__lv__body?: string, translated__content__lv__type?: string, translated__content__mn__body?: string, translated__content__mn__type?: string, translated__content__nb__body?: string, translated__content__nb__type?: string, translated__content__nl__body?: string, translated__content__nl__type?: string, translated__content__pl__body?: string, translated__content__pl__type?: string, translated__content__pt__body?: string, translated__content__pt__type?: string, translated__content__ro__body?: string, translated__content__ro__type?: string, translated__content__ru__body?: string, translated__content__ru__type?: string, translated__content__sl__body?: string, translated__content__sl__type?: string, translated__content__sr__body?: string, translated__content__sr__type?: string, translated__content__sv__body?: string, translated__content__sv__type?: string, translated__content__tr__body?: string, translated__content__tr__type?: string, translated__content__vi__body?: string, translated__content__vi__type?: string, translated__content__ar__state?: string, translated__content__ar__title?: string, translated__content__bg__state?: string, translated__content__bg__title?: string, translated__content__bs__state?: string, translated__content__bs__title?: string, translated__content__ca__state?: string, translated__content__ca__title?: string, translated__content__cs__state?: string, translated__content__cs__title?: string, translated__content__da__state?: string, translated__content__da__title?: string, translated__content__de__state?: string, translated__content__de__title?: string, translated__content__el__state?: string, translated__content__el__title?: string, translated__content__en__state?: string, translated__content__en__title?: string, translated__content__es__state?: string, translated__content__es__title?: string, translated__content__et__state?: string, translated__content__et__title?: string, translated__content__fi__state?: string, translated__content__fi__title?: string, translated__content__fr__state?: string, translated__content__fr__title?: string, translated__content__he__state?: string, translated__content__he__title?: string, translated__content__hr__state?: string, translated__content__hr__title?: string, translated__content__hu__state?: string, translated__content__hu__title?: string, translated__content__id__state?: string, translated__content__id__title?: string, translated__content__it__state?: string, translated__content__it__title?: string, translated__content__ja__state?: string, translated__content__ja__title?: string, translated__content__ko__state?: string, translated__content__ko__title?: string, translated__content__lt__state?: string, translated__content__lt__title?: string, translated__content__lv__state?: string, translated__content__lv__title?: string, translated__content__mn__state?: string, translated__content__mn__title?: string, translated__content__nb__state?: string, translated__content__nb__title?: string, translated__content__nl__state?: string, translated__content__nl__title?: string, translated__content__pl__state?: string, translated__content__pl__title?: string, translated__content__pt__state?: string, translated__content__pt__title?: string, translated__content__ro__state?: string, translated__content__ro__title?: string, translated__content__ru__state?: string, translated__content__ru__title?: string, translated__content__sl__state?: string, translated__content__sl__title?: string, translated__content__sr__state?: string, translated__content__sr__title?: string, translated__content__sv__state?: string, translated__content__sv__title?: string, translated__content__tr__state?: string, translated__content__tr__title?: string, translated__content__vi__state?: string, translated__content__vi__title?: string, translated__content__pt__BR__url?: string, translated__content__zh__CN__url?: string, translated__content__zh__TW__url?: string, translated__content__pt__BR__body?: string, translated__content__pt__BR__type?: string, translated__content__zh__CN__body?: string, translated__content__zh__CN__type?: string, translated__content__zh__TW__body?: string, translated__content__zh__TW__type?: string, translated__content__pt__BR__state?: string, translated__content__pt__BR__title?: string, translated__content__zh__CN__state?: string, translated__content__zh__CN__title?: string, translated__content__zh__TW__state?: string, translated__content__zh__TW__title?: string, translated__content__ar__author__id?: integer, translated__content__bg__author__id?: integer, translated__content__bs__author__id?: integer, translated__content__ca__author__id?: integer, translated__content__cs__author__id?: integer, translated__content__da__author__id?: integer, translated__content__de__author__id?: integer, translated__content__el__author__id?: integer, translated__content__en__author__id?: integer, translated__content__es__author__id?: integer, translated__content__et__author__id?: integer, translated__content__fi__author__id?: integer, translated__content__fr__author__id?: integer, translated__content__he__author__id?: integer, translated__content__hr__author__id?: integer, translated__content__hu__author__id?: integer, translated__content__id__author__id?: integer, translated__content__it__author__id?: integer, translated__content__ja__author__id?: integer, translated__content__ko__author__id?: integer, translated__content__lt__author__id?: integer, translated__content__lv__author__id?: integer, translated__content__mn__author__id?: integer, translated__content__nb__author__id?: integer, translated__content__nl__author__id?: integer, translated__content__pl__author__id?: integer, translated__content__pt__author__id?: integer, translated__content__ro__author__id?: integer, translated__content__ru__author__id?: integer, translated__content__sl__author__id?: integer, translated__content__sr__author__id?: integer, translated__content__sv__author__id?: integer, translated__content__tr__author__id?: integer, translated__content__vi__author__id?: integer, translated__content__ar__created__at?: integer, translated__content__ar__description?: string, translated__content__ar__updated__at?: integer, translated__content__bg__created__at?: integer, translated__content__bg__description?: string, translated__content__bg__updated__at?: integer, translated__content__bs__created__at?: integer, translated__content__bs__description?: string, translated__content__bs__updated__at?: integer, translated__content__ca__created__at?: integer, translated__content__ca__description?: string, translated__content__ca__updated__at?: integer, translated__content__cs__created__at?: integer, translated__content__cs__description?: string, translated__content__cs__updated__at?: integer, translated__content__da__created__at?: integer, translated__content__da__description?: string, translated__content__da__updated__at?: integer, translated__content__de__created__at?: integer, translated__content__de__description?: string, translated__content__de__updated__at?: integer, translated__content__el__created__at?: integer, translated__content__el__description?: string, translated__content__el__updated__at?: integer, translated__content__en__created__at?: integer, translated__content__en__description?: string, translated__content__en__updated__at?: integer, translated__content__es__created__at?: integer, translated__content__es__description?: string, translated__content__es__updated__at?: integer, translated__content__et__created__at?: integer, translated__content__et__description?: string, translated__content__et__updated__at?: integer, translated__content__fi__created__at?: integer, translated__content__fi__description?: string, translated__content__fi__updated__at?: integer, translated__content__fr__created__at?: integer, translated__content__fr__description?: string, translated__content__fr__updated__at?: integer, translated__content__he__created__at?: integer, translated__content__he__description?: string, translated__content__he__updated__at?: integer, translated__content__hr__created__at?: integer, translated__content__hr__description?: string, translated__content__hr__updated__at?: integer, translated__content__hu__created__at?: integer, translated__content__hu__description?: string, translated__content__hu__updated__at?: integer, translated__content__id__created__at?: integer, translated__content__id__description?: string, translated__content__id__updated__at?: integer, translated__content__it__created__at?: integer, translated__content__it__description?: string, translated__content__it__updated__at?: integer, translated__content__ja__created__at?: integer, translated__content__ja__description?: string, translated__content__ja__updated__at?: integer, translated__content__ko__created__at?: integer, translated__content__ko__description?: string, translated__content__ko__updated__at?: integer, translated__content__lt__created__at?: integer, translated__content__lt__description?: string, translated__content__lt__updated__at?: integer, translated__content__lv__created__at?: integer, translated__content__lv__description?: string, translated__content__lv__updated__at?: integer, translated__content__mn__created__at?: integer, translated__content__mn__description?: string, translated__content__mn__updated__at?: integer, translated__content__nb__created__at?: integer, translated__content__nb__description?: string, translated__content__nb__updated__at?: integer, translated__content__nl__created__at?: integer, translated__content__nl__description?: string, translated__content__nl__updated__at?: integer, translated__content__pl__created__at?: integer, translated__content__pl__description?: string, translated__content__pl__updated__at?: integer, translated__content__pt__created__at?: integer, translated__content__pt__description?: string, translated__content__pt__updated__at?: integer, translated__content__ro__created__at?: integer, translated__content__ro__description?: string, translated__content__ro__updated__at?: integer, translated__content__ru__created__at?: integer, translated__content__ru__description?: string, translated__content__ru__updated__at?: integer, translated__content__sl__created__at?: integer, translated__content__sl__description?: string, translated__content__sl__updated__at?: integer, translated__content__sr__created__at?: integer, translated__content__sr__description?: string, translated__content__sr__updated__at?: integer, translated__content__sv__created__at?: integer, translated__content__sv__description?: string, translated__content__sv__updated__at?: integer, translated__content__tr__created__at?: integer, translated__content__tr__description?: string, translated__content__tr__updated__at?: integer, translated__content__vi__created__at?: integer, translated__content__vi__description?: string, translated__content__vi__updated__at?: integer, translated__content__pt__BR__author__id?: integer, translated__content__zh__CN__author__id?: integer, translated__content__zh__TW__author__id?: integer, translated__content__pt__BR__created__at?: integer, translated__content__pt__BR__description?: string, translated__content__pt__BR__updated__at?: integer, translated__content__zh__CN__created__at?: integer, translated__content__zh__CN__description?: string, translated__content__zh__CN__updated__at?: integer, translated__content__zh__TW__created__at?: integer, translated__content__zh__TW__description?: string, translated__content__zh__TW__updated__at?: integer }
- `POST https://api.mcp.ai/api/intercom/create/conversation` — Creates a new conversation in intercom
  - body: { body: string, subject?: string, from_user_id?: string, message_type?: string, from_admin_id?: string, from_contact_id?: string }
- `POST https://api.mcp.ai/api/intercom/create/or/update/a/company` — You can create or update a company. companies will be only visible in intercom when there is at least one associated user. companies are looked up via `company id` in a `post` request, if not found vi
  - body: { name?: string, plan?: string, size?: integer, website?: string, industry?: string, company_id?: string, monthly_spend?: integer, custom_attributes?: object, remote_created_at?: integer }
- `POST https://api.mcp.ai/api/intercom/delete/a/collection` — You can delete a single collection by making a delete request to `https://api.intercom.io/collections/<id>`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/delete/a/company` — You can delete a single company.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/delete/a/contact` — You can delete a single contact.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/delete/an/article` — You can delete a single article by making a delete request to `https://api.intercom.io/articles/<id>`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/detach/a/contact/from/a/company` — You can detach a company from a single contact.
  - body: { id: string, contact_id: string }
- `POST https://api.mcp.ai/api/intercom/get/a/contact` — You can fetch the details of a single contact.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/get/conversation` — Retrieves a specific conversation by id with all messages and details
  - body: { display_as?: string, conversation_id: string }
- `POST https://api.mcp.ai/api/intercom/identify/an/admin` — You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology). > 🚧 single sign on > > if you are building a custom "log in with intercom" flow f
- `POST https://api.mcp.ai/api/intercom/list/all/activity/logs` — You can get a log of activities by all admins in an app.
  - body: { created_at_after: string, created_at_before?: string }
- `POST https://api.mcp.ai/api/intercom/list/all/admins` — You can fetch a list of admins for a given workspace.
- `POST https://api.mcp.ai/api/intercom/list/all/articles` — You can fetch a list of all articles by making a get request to `https://api.intercom.io/articles`. > 📘 how are the articles sorted and ordered? > > articles will be returned in descending order on t
- `POST https://api.mcp.ai/api/intercom/list/all/collections` — You can fetch a list of all collections by making a get request to `https://api.intercom.io/help center/collections`. collections will be returned in descending order on the `updated at` attribute. th
- `POST https://api.mcp.ai/api/intercom/list/all/companies` — You can list companies. the company list is sorted by the `last request at` field and by default is ordered descending, most recently requested first. note that the api does not include companies who 
  - body: { page?: integer, order?: string, per_page?: integer }
- `POST https://api.mcp.ai/api/intercom/list/all/help/centers` — You can list all help centers by making a get request to `https://api.intercom.io/help center/help centers`.
- `POST https://api.mcp.ai/api/intercom/list/all/notes` — You can fetch a list of notes that are associated to a contact.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/list/attached/companies/for/contact` — You can fetch a list of companies that are associated to a contact.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/list/attached/contacts` — You can fetch a list of all contacts that belong to a company.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/list/attached/segments/for/companies` — You can fetch a list of all segments that belong to a company.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/list/attached/segments/for/contact` — You can fetch a list of segments that are associated to a contact.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/intercom/list/conversations` — Lists conversations from intercom with filtering and pagination support
  - body: { state?: string, per_page?: integer, display_as?: string, assignee_id?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/intercom/list/subscriptions/for/a/contact` — You can fetch a list of subscription types that are attached to a contact. these can be subscriptions that a user has 'opted-in' to or has 'opted-out' from, depending on the subscription type. this wi
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/intercom/list/tags/attached/to/a/contact` — You can fetch a list of all tags that are attached to a specific contact.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/intercom/merge/a/lead/and/a/user` — You can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.
  - body: { from?: string, into?: string }
- `POST https://api.mcp.ai/api/intercom/remove/subscription/from/a/contact` — You can remove a specific subscription from a contact. this will return a subscription type model for the subscription type that was removed from the contact.
  - body: { id: string, contact_id: string }
- `POST https://api.mcp.ai/api/intercom/remove/tag/from/a/contact` — You can remove tag from a specific contact. this will return a tag object for the tag that was removed from the contact.
  - body: { id: string, contact_id: string }
- `POST https://api.mcp.ai/api/intercom/reopen/conversation` — Reopens a closed conversation in intercom
  - body: { body?: string, admin_id: string, conversation_id: string }
- `POST https://api.mcp.ai/api/intercom/reply/to/conversation` — Sends a reply to an existing conversation in intercom
  - body: { admin_id?: string, message_body: string, message_type?: string, attachment_urls?: string[], conversation_id: string }
- `POST https://api.mcp.ai/api/intercom/retrieve/a/collection` — You can fetch the details of a single collection by making a get request to `https://api.intercom.io/help center/collections/<id>`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/retrieve/a/company/by/id` — You can fetch a single company.
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/retrieve/a/help/center` — You can fetch the details of a single help center by making a get request to `https://api.intercom.io/help center/help center/<id>`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/retrieve/an/admin` — You can retrieve the details of a single admin.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/retrieve/an/article` — You can fetch the details of a single article by making a get request to `https://api.intercom.io/articles/<id>`.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/intercom/retrieve/companies` — You can fetch a single company by passing in `company id` or `name`. `https://api.intercom.io/companies?name={name}` `https://api.intercom.io/companies?company id={company id}` you can fetch all compa
  - body: { name?: string, page?: integer, tag_id?: string, per_page?: integer, company_id?: string, segment_id?: string }
- `POST https://api.mcp.ai/api/intercom/scroll/over/all/companies` — The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. the scroll api provides an efficient mechanism for it
  - body: { scroll_param?: string }
- `POST https://api.mcp.ai/api/intercom/search/conversations` — Searches for conversations using query string with support for filtering and sorting
  - body: { query: string, per_page?: integer, sort_field?: string, sort_order?: string, starting_after?: string }
- `POST https://api.mcp.ai/api/intercom/search/for/articles` — You can search for articles by making a get request to `https://api.intercom.io/articles/search`.
  - body: { state?: string, phrase?: string, highlight?: boolean, help_center_id?: integer }
- `POST https://api.mcp.ai/api/intercom/set/an/admin/to/away` — You can set an admin as away for the inbox.
  - body: { id: integer, away_mode_enabled?: boolean, away_mode_reassign?: boolean }
- `POST https://api.mcp.ai/api/intercom/update/a/collection` — You can update the details of a single collection by making a put request to `https://api.intercom.io/collections/<id>`.
  - body: { id: integer, name?: string, parent_id?: string, description?: string, translated__content__type?: string, translated__content__ar__name?: string, translated__content__ar__type?: string, translated__content__bg__name?: string, translated__content__bg__type?: string, translated__content__bs__name?: string, translated__content__bs__type?: string, translated__content__ca__name?: string, translated__content__ca__type?: string, translated__content__cs__name?: string, translated__content__cs__type?: string, translated__content__da__name?: string, translated__content__da__type?: string, translated__content__de__name?: string, translated__content__de__type?: string, translated__content__el__name?: string, translated__content__el__type?: string, translated__content__en__name?: string, translated__content__en__type?: string, translated__content__es__name?: string, translated__content__es__type?: string, translated__content__et__name?: string, translated__content__et__type?: string, translated__content__fi__name?: string, translated__content__fi__type?: string, translated__content__fr__name?: string, translated__content__fr__type?: string, translated__content__he__name?: string, translated__content__he__type?: string, translated__content__hr__name?: string, translated__content__hr__type?: string, translated__content__hu__name?: string, translated__content__hu__type?: string, translated__content__id__name?: string, translated__content__id__type?: string, translated__content__it__name?: string, translated__content__it__type?: string, translated__content__ja__name?: string, translated__content__ja__type?: string, translated__content__ko__name?: string, translated__content__ko__type?: string, translated__content__lt__name?: string, translated__content__lt__type?: string, translated__content__lv__name?: string, translated__content__lv__type?: string, translated__content__mn__name?: string, translated__content__mn__type?: string, translated__content__nb__name?: string, translated__content__nb__type?: string, translated__content__nl__name?: string, translated__content__nl__type?: string, translated__content__pl__name?: string, translated__content__pl__type?: string, translated__content__pt__name?: string, translated__content__pt__type?: string, translated__content__ro__name?: string, translated__content__ro__type?: string, translated__content__ru__name?: string, translated__content__ru__type?: string, translated__content__sl__name?: string, translated__content__sl__type?: string, translated__content__sr__name?: string, translated__content__sr__type?: string, translated__content__sv__name?: string, translated__content__sv__type?: string, translated__content__tr__name?: string, translated__content__tr__type?: string, translated__content__vi__name?: string, translated__content__vi__type?: string, translated__content__pt__BR__name?: string, translated__content__pt__BR__type?: string, translated__content__zh__CN__name?: string, translated__content__zh__CN__type?: string, translated__content__zh__TW__name?: string, translated__content__zh__TW__type?: string, translated__content__ar__description?: string, translated__content__bg__description?: string, translated__content__bs__description?: string, translated__content__ca__description?: string, translated__content__cs__description?: string, translated__content__da__description?: string, translated__content__de__description?: string, translated__content__el__description?: string, translated__content__en__description?: string, translated__content__es__description?: string, translated__content__et__description?: string, translated__content__fi__description?: string, translated__content__fr__description?: string, translated__content__he__description?: string, translated__content__hr__description?: string, translated__content__hu__description?: string, translated__content__id__description?: string, translated__content__it__description?: string, translated__content__ja__description?: string, translated__content__ko__description?: string, translated__content__lt__description?: string, translated__content__lv__description?: string, translated__content__mn__description?: string, translated__content__nb__description?: string, translated__content__nl__description?: string, translated__content__pl__description?: string, translated__content__pt__description?: string, translated__content__ro__description?: string, translated__content__ru__description?: string, translated__content__sl__description?: string, translated__content__sr__description?: string, translated__content__sv__description?: string, translated__content__tr__description?: string, translated__content__vi__description?: string, translated__content__pt__BR__description?: string, translated__content__zh__CN__description?: string, translated__content__zh__TW__description?: string }
- `POST https://api.mcp.ai/api/intercom/update/a/company` — You can update a single company using the intercom provisioned `id`. {% admonition type="attention" name="using `company id`" %} when updating a company it is not possible to update `company id`. this
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/update/a/contact` — You can update an existing contact (ie. user or lead).
  - body: { id: string }
- `POST https://api.mcp.ai/api/intercom/update/an/article` — You can update the details of a single article by making a put request to `https://api.intercom.io/articles/<id>`.
  - body: { id: integer, body?: string, state?: string, title?: string, author_id?: integer, parent_id?: string, description?: string, parent_type?: string, translated__content__type?: string, translated__content__ar__url?: string, translated__content__bg__url?: string, translated__content__bs__url?: string, translated__content__ca__url?: string, translated__content__cs__url?: string, translated__content__da__url?: string, translated__content__de__url?: string, translated__content__el__url?: string, translated__content__en__url?: string, translated__content__es__url?: string, translated__content__et__url?: string, translated__content__fi__url?: string, translated__content__fr__url?: string, translated__content__he__url?: string, translated__content__hr__url?: string, translated__content__hu__url?: string, translated__content__id__url?: string, translated__content__it__url?: string, translated__content__ja__url?: string, translated__content__ko__url?: string, translated__content__lt__url?: string, translated__content__lv__url?: string, translated__content__mn__url?: string, translated__content__nb__url?: string, translated__content__nl__url?: string, translated__content__pl__url?: string, translated__content__pt__url?: string, translated__content__ro__url?: string, translated__content__ru__url?: string, translated__content__sl__url?: string, translated__content__sr__url?: string, translated__content__sv__url?: string, translated__content__tr__url?: string, translated__content__vi__url?: string, translated__content__ar__body?: string, translated__content__ar__type?: string, translated__content__bg__body?: string, translated__content__bg__type?: string, translated__content__bs__body?: string, translated__content__bs__type?: string, translated__content__ca__body?: string, translated__content__ca__type?: string, translated__content__cs__body?: string, translated__content__cs__type?: string, translated__content__da__body?: string, translated__content__da__type?: string, translated__content__de__body?: string, translated__content__de__type?: string, translated__content__el__body?: string, translated__content__el__type?: string, translated__content__en__body?: string, translated__content__en__type?: string, translated__content__es__body?: string, translated__content__es__type?: string, translated__content__et__body?: string, translated__content__et__type?: string, translated__content__fi__body?: string, translated__content__fi__type?: string, translated__content__fr__body?: string, translated__content__fr__type?: string, translated__content__he__body?: string, translated__content__he__type?: string, translated__content__hr__body?: string, translated__content__hr__type?: string, translated__content__hu__body?: string, translated__content__hu__type?: string, translated__content__id__body?: string, translated__content__id__type?: string, translated__content__it__body?: string, translated__content__it__type?: string, translated__content__ja__body?: string, translated__content__ja__type?: string, translated__content__ko__body?: string, translated__content__ko__type?: string, translated__content__lt__body?: string, translated__content__lt__type?: string, translated__content__lv__body?: string, translated__content__lv__type?: string, translated__content__mn__body?: string, translated__content__mn__type?: string, translated__content__nb__body?: string, translated__content__nb__type?: string, translated__content__nl__body?: string, translated__content__nl__type?: string, translated__content__pl__body?: string, translated__content__pl__type?: string, translated__content__pt__body?: string, translated__content__pt__type?: string, translated__content__ro__body?: string, translated__content__ro__type?: string, translated__content__ru__body?: string, translated__content__ru__type?: string, translated__content__sl__body?: string, translated__content__sl__type?: string, translated__content__sr__body?: string, translated__content__sr__type?: string, translated__content__sv__body?: string, translated__content__sv__type?: string, translated__content__tr__body?: string, translated__content__tr__type?: string, translated__content__vi__body?: string, translated__content__vi__type?: string, translated__content__ar__state?: string, translated__content__ar__title?: string, translated__content__bg__state?: string, translated__content__bg__title?: string, translated__content__bs__state?: string, translated__content__bs__title?: string, translated__content__ca__state?: string, translated__content__ca__title?: string, translated__content__cs__state?: string, translated__content__cs__title?: string, translated__content__da__state?: string, translated__content__da__title?: string, translated__content__de__state?: string, translated__content__de__title?: string, translated__content__el__state?: string, translated__content__el__title?: string, translated__content__en__state?: string, translated__content__en__title?: string, translated__content__es__state?: string, translated__content__es__title?: string, translated__content__et__state?: string, translated__content__et__title?: string, translated__content__fi__state?: string, translated__content__fi__title?: string, translated__content__fr__state?: string, translated__content__fr__title?: string, translated__content__he__state?: string, translated__content__he__title?: string, translated__content__hr__state?: string, translated__content__hr__title?: string, translated__content__hu__state?: string, translated__content__hu__title?: string, translated__content__id__state?: string, translated__content__id__title?: string, translated__content__it__state?: string, translated__content__it__title?: string, translated__content__ja__state?: string, translated__content__ja__title?: string, translated__content__ko__state?: string, translated__content__ko__title?: string, translated__content__lt__state?: string, translated__content__lt__title?: string, translated__content__lv__state?: string, translated__content__lv__title?: string, translated__content__mn__state?: string, translated__content__mn__title?: string, translated__content__nb__state?: string, translated__content__nb__title?: string, translated__content__nl__state?: string, translated__content__nl__title?: string, translated__content__pl__state?: string, translated__content__pl__title?: string, translated__content__pt__state?: string, translated__content__pt__title?: string, translated__content__ro__state?: string, translated__content__ro__title?: string, translated__content__ru__state?: string, translated__content__ru__title?: string, translated__content__sl__state?: string, translated__content__sl__title?: string, translated__content__sr__state?: string, translated__content__sr__title?: string, translated__content__sv__state?: string, translated__content__sv__title?: string, translated__content__tr__state?: string, translated__content__tr__title?: string, translated__content__vi__state?: string, translated__content__vi__title?: string, translated__content__pt__BR__url?: string, translated__content__zh__CN__url?: string, translated__content__zh__TW__url?: string, translated__content__pt__BR__body?: string, translated__content__pt__BR__type?: string, translated__content__zh__CN__body?: string, translated__content__zh__CN__type?: string, translated__content__zh__TW__body?: string, translated__content__zh__TW__type?: string, translated__content__pt__BR__state?: string, translated__content__pt__BR__title?: string, translated__content__zh__CN__state?: string, translated__content__zh__CN__title?: string, translated__content__zh__TW__state?: string, translated__content__zh__TW__title?: string, translated__content__ar__author__id?: integer, translated__content__bg__author__id?: integer, translated__content__bs__author__id?: integer, translated__content__ca__author__id?: integer, translated__content__cs__author__id?: integer, translated__content__da__author__id?: integer, translated__content__de__author__id?: integer, translated__content__el__author__id?: integer, translated__content__en__author__id?: integer, translated__content__es__author__id?: integer, translated__content__et__author__id?: integer, translated__content__fi__author__id?: integer, translated__content__fr__author__id?: integer, translated__content__he__author__id?: integer, translated__content__hr__author__id?: integer, translated__content__hu__author__id?: integer, translated__content__id__author__id?: integer, translated__content__it__author__id?: integer, translated__content__ja__author__id?: integer, translated__content__ko__author__id?: integer, translated__content__lt__author__id?: integer, translated__content__lv__author__id?: integer, translated__content__mn__author__id?: integer, translated__content__nb__author__id?: integer, translated__content__nl__author__id?: integer, translated__content__pl__author__id?: integer, translated__content__pt__author__id?: integer, translated__content__ro__author__id?: integer, translated__content__ru__author__id?: integer, translated__content__sl__author__id?: integer, translated__content__sr__author__id?: integer, translated__content__sv__author__id?: integer, translated__content__tr__author__id?: integer, translated__content__vi__author__id?: integer, translated__content__ar__created__at?: integer, translated__content__ar__description?: string, translated__content__ar__updated__at?: integer, translated__content__bg__created__at?: integer, translated__content__bg__description?: string, translated__content__bg__updated__at?: integer, translated__content__bs__created__at?: integer, translated__content__bs__description?: string, translated__content__bs__updated__at?: integer, translated__content__ca__created__at?: integer, translated__content__ca__description?: string, translated__content__ca__updated__at?: integer, translated__content__cs__created__at?: integer, translated__content__cs__description?: string, translated__content__cs__updated__at?: integer, translated__content__da__created__at?: integer, translated__content__da__description?: string, translated__content__da__updated__at?: integer, translated__content__de__created__at?: integer, translated__content__de__description?: string, translated__content__de__updated__at?: integer, translated__content__el__created__at?: integer, translated__content__el__description?: string, translated__content__el__updated__at?: integer, translated__content__en__created__at?: integer, translated__content__en__description?: string, translated__content__en__updated__at?: integer, translated__content__es__created__at?: integer, translated__content__es__description?: string, translated__content__es__updated__at?: integer, translated__content__et__created__at?: integer, translated__content__et__description?: string, translated__content__et__updated__at?: integer, translated__content__fi__created__at?: integer, translated__content__fi__description?: string, translated__content__fi__updated__at?: integer, translated__content__fr__created__at?: integer, translated__content__fr__description?: string, translated__content__fr__updated__at?: integer, translated__content__he__created__at?: integer, translated__content__he__description?: string, translated__content__he__updated__at?: integer, translated__content__hr__created__at?: integer, translated__content__hr__description?: string, translated__content__hr__updated__at?: integer, translated__content__hu__created__at?: integer, translated__content__hu__description?: string, translated__content__hu__updated__at?: integer, translated__content__id__created__at?: integer, translated__content__id__description?: string, translated__content__id__updated__at?: integer, translated__content__it__created__at?: integer, translated__content__it__description?: string, translated__content__it__updated__at?: integer, translated__content__ja__created__at?: integer, translated__content__ja__description?: string, translated__content__ja__updated__at?: integer, translated__content__ko__created__at?: integer, translated__content__ko__description?: string, translated__content__ko__updated__at?: integer, translated__content__lt__created__at?: integer, translated__content__lt__description?: string, translated__content__lt__updated__at?: integer, translated__content__lv__created__at?: integer, translated__content__lv__description?: string, translated__content__lv__updated__at?: integer, translated__content__mn__created__at?: integer, translated__content__mn__description?: string, translated__content__mn__updated__at?: integer, translated__content__nb__created__at?: integer, translated__content__nb__description?: string, translated__content__nb__updated__at?: integer, translated__content__nl__created__at?: integer, translated__content__nl__description?: string, translated__content__nl__updated__at?: integer, translated__content__pl__created__at?: integer, translated__content__pl__description?: string, translated__content__pl__updated__at?: integer, translated__content__pt__created__at?: integer, translated__content__pt__description?: string, translated__content__pt__updated__at?: integer, translated__content__ro__created__at?: integer, translated__content__ro__description?: string, translated__content__ro__updated__at?: integer, translated__content__ru__created__at?: integer, translated__content__ru__description?: string, translated__content__ru__updated__at?: integer, translated__content__sl__created__at?: integer, translated__content__sl__description?: string, translated__content__sl__updated__at?: integer, translated__content__sr__created__at?: integer, translated__content__sr__description?: string, translated__content__sr__updated__at?: integer, translated__content__sv__created__at?: integer, translated__content__sv__description?: string, translated__content__sv__updated__at?: integer, translated__content__tr__created__at?: integer, translated__content__tr__description?: string, translated__content__tr__updated__at?: integer, translated__content__vi__created__at?: integer, translated__content__vi__description?: string, translated__content__vi__updated__at?: integer, translated__content__pt__BR__author__id?: integer, translated__content__zh__CN__author__id?: integer, translated__content__zh__TW__author__id?: integer, translated__content__pt__BR__created__at?: integer, translated__content__pt__BR__description?: string, translated__content__pt__BR__updated__at?: integer, translated__content__zh__CN__created__at?: integer, translated__content__zh__CN__description?: string, translated__content__zh__CN__updated__at?: integer, translated__content__zh__TW__created__at?: integer, translated__content__zh__TW__description?: string, translated__content__zh__TW__updated__at?: integer }

## More
- Page: https://mcp.ai/intercom
- Agent spec (llms.txt): https://mcp.ai/intercom/llms.txt
- Postman collection: https://mcp.ai/intercom/postman.json