list_dm_conversations

mcp:readread-only

List the X direct-message conversations the user is tracking for outreach. Each has the person, the messages logged so far, and draftText: the next message drafted in the user's voice. status 'your_turn' means they replied and the user owes an answer; 'waiting' means the user sent the last message, and followUpDue is true once it's been a few days.

Filter with status 'open' (default), 'your_turn', 'waiting', 'follow_up_due', 'closed' or 'all'. X DMs are end-to-end encrypted, so AdVentur.ai can't read or send them: the user logs messages with update_dm_conversation and sends drafts themselves via sendOnXUrl.

Input

• statusstring

  one of open, your_turn, waiting, follow_up_due, closed, all · default "open"

Permission

Needs the mcp:read scope: view your workspace. It only reads, so assistants can call it without asking.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_dm_conversations",
    "arguments": {}
  }
}

Same action over the REST API

The tool runs GET /v1/orgs/{orgId}/dms as the signed-in user, with the same validation, approval rules and limits. See it in the X DMs API reference.