> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Modem MCP

> Modem MCP lets authorized agents search synthesized customer feedback, run durable Modem Agent conversations, and manage topics, people, and companies.

![Modem MCP logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/modem_mcp.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=3e71f427400470346aca87de1aa218bf)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `MODEM_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Add people to company
>
> **Slug:** `MODEM_MCP_ADD_PEOPLE_TO_COMPANY`
>
> Associate one or more people with a company. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **companyId** `string` *required*
>
> **personIds** `array` *required*

> [accordion] Bulk update topics
>
> **Slug:** `MODEM_MCP_BULK_UPDATE_TOPICS`
>
> Update multiple topics at once (e.g. archive or re-prioritize a set of topics). Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **archived** `boolean`
>
> Set to true to archive topics, false to unarchive them.
>
> **priority** `string ("very_low" | "low" | "default" | "high" | "very_high")`
>
> Update all topics to this priority. Valid values: very\_low, low, default, high, very\_high.
>
> **topicIds** `array` *required*
>
> **archivedReason** `string`
>
> Optional reason for archiving. Only used when archived=true.

> [accordion] Create companies
>
> **Slug:** `MODEM_MCP_CREATE_COMPANIES`
>
> Create one or more companies in the organization. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **companies** `array` *required*

> [accordion] Merge companies
>
> **Slug:** `MODEM_MCP_MERGE_COMPANIES`
>
> Merge one or more source companies into a target company. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **targetCompanyId** `string` *required*
>
> **sourceCompanyIds** `array` *required*

> [accordion] Merge people
>
> **Slug:** `MODEM_MCP_MERGE_PEOPLE`
>
> Merge one or more source people into a target person. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **targetPersonId** `string` *required*
>
> **sourcePersonIds** `array` *required*

> [accordion] Merge topics
>
> **Slug:** `MODEM_MCP_MERGE_TOPICS`
>
> Merge one or more source topics into a target topic. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **targetTopicId** `string` *required*
>
> ID of the topic to merge into. Must not be in the sourceTopicIds array.
>
> **sourceTopicIds** `array` *required*
>
> IDs of topics to merge into the target. Must not include the target topic ID.

> [accordion] Modem agent cancel run
>
> **Slug:** `MODEM_MCP_MODEM_AGENT_CANCEL_RUN`
>
> Cooperatively cancel one exact durable Modem agent run. Completed external actions are not reversed.
>
> #### Input Parameters
>
> **run\_id** `string` *required*
>
> Run ID returned by modem\_agent\_invoke or modem\_agent\_send\_message.
>
> **conversation\_id** `string` *required*
>
> Conversation ID returned by modem\_agent\_invoke.

> [accordion] Modem agent get run
>
> **Slug:** `MODEM_MCP_MODEM_AGENT_GET_RUN`
>
> Get the current status and terminal result of a durable Modem agent run.
>
> #### Input Parameters
>
> **run\_id** `string` *required*
>
> Run ID returned by modem\_agent\_invoke or modem\_agent\_send\_message.
>
> **conversation\_id** `string` *required*
>
> Conversation ID returned by modem\_agent\_invoke.

> [accordion] Modem agent invoke
>
> **Slug:** `MODEM_MCP_MODEM_AGENT_INVOKE`
>
> Start a durable Modem agent conversation. Returns immediately with conversation\_id and run\_id; poll modem\_agent\_get\_run for the result. Before your first call, read the skill: `modem_skills({ name: "agent-runs" })`.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Natural-language prompt for the Modem agent.
>
> **idempotency\_key** `string` *required*
>
> Stable retry key. Reuse only for the exact same prompt.

> [accordion] Modem agent send message
>
> **Slug:** `MODEM_MCP_MODEM_AGENT_SEND_MESSAGE`
>
> Start a durable follow-up turn in an existing MCP conversation.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Follow-up prompt for the Modem agent.
>
> **conversation\_id** `string` *required*
>
> Existing MCP conversation ID.
>
> **idempotency\_key** `string` *required*
>
> Stable retry key for this follow-up.

> [accordion] Modem skills
>
> **Slug:** `MODEM_MCP_MODEM_SKILLS`
>
> Skills that teach you how to use THIS Modem MCP server's tools. Call before your first `search_modem`, `modem_agent_invoke`, or write-tool call, or when unsure which Modem tool to use. Pass `name` for the full skill, one of `search-modem`, `agent-runs`, `write-tools`. Omit `name` to list them with descriptions. This is not the Skills page in dashboard settings.
>
> #### Input Parameters
>
> **name** `string`
>
> A skill from this server's catalog, e.g. "search-modem". Not a path or an outside skill name. Omit to list the catalog.

> [accordion] Search modem
>
> **Slug:** `MODEM_MCP_SEARCH_MODEM`
>
> Answer a natural-language question about your Modem data and get matching rows back. Read-only. It does not run the full Modem agent or spend agent credits. Send a `question`, or send only the `cursor` from a previous result to fetch its next page. Topic `priority` in the rows is an integer: very\_low (-100), low (-50), default (0), high (50), very\_high (100). Before your first call, read the skill: `modem_skills({ name: "search-modem" })`.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Page size. When set, the engine pages the result server-side and returns a cursor when more rows exist.
>
> **cursor** `string`
>
> Opaque continuation token from a previous response. Fetches the next page of the same result set without re-running the search.
>
> **columns** `array`
>
> Requested row shape — the columns each returned row must carry, validated against them (see the schema field on the result). Without it the engine returns a sensible default shape for the question — consistent for common intents, but not validated or guaranteed; pass this whenever you need a SPECIFIC, validated, and stable shape. A cursor continuation reuses the first page’s columns, so it stays stable regardless.
>
> **question** `string`
>
> Natural-language data question. Required unless cursor is provided. Returns matching rows without invoking the paid Modem agent.

> [accordion] Update companies
>
> **Slug:** `MODEM_MCP_UPDATE_COMPANIES`
>
> Update fields on one or more existing companies. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **companies** `array` *required*

> [accordion] Update people
>
> **Slug:** `MODEM_MCP_UPDATE_PEOPLE`
>
> Update fields on one or more existing people. Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **people** `array` *required*

> [accordion] Update topic
>
> **Slug:** `MODEM_MCP_UPDATE_TOPIC`
>
> Update a single topic (priority, lifecycle state, archived status, issue type, or keywords). Before your first call, read the skill: `modem_skills({ name: "write-tools" })`.
>
> #### Input Parameters
>
> **topicId** `string` *required*
>
> **archived** `boolean`
>
> Set to true to archive the topic, false to unarchive it.
>
> **keywords** `array`
>
> Replace the topic keywords/categories. Provide the full list of keywords.
>
> **priority** `string ("very_low" | "low" | "default" | "high" | "very_high")`
>
> Update the topic priority. Valid values: very\_low, low, default, high, very\_high.
>
> **issueType** `string`
>
> Update the topic issue type classification. Valid values: bug\_report, feature\_request, complaint, praise, or null to clear.
>
> **archivedReason** `string`
>
> Optional reason for archiving. Only used when archived=true.
>
> **lifecycleState** `string ("open" | "in_progress" | "completed" | "dismissed")`
>
> Update the topic lifecycle state. Valid values: open, in\_progress, completed, dismissed. The unknown state is AI-assessed and cannot be set directly.
