Home / Servers / X (Twitter) API / get_direct_messages_events_by_conversation_id

Get DM Events by Conversation ID

An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.

Get DM Events by Conversation ID Retrieves direct message events for a specific conversation by its ID. [GET /2/dm_conversations/{id}/dm_events]

Name on the gateway: x_api__get_direct_messages_events_by_conversation_id · read-only.

Parameters

Name	Type	Description
`id` required	`string`	id parameter
`max_results`	`integer`	max_results parameter
`pagination_token`	`string`	A base32hex-encoded pagination token.
`event_types`	`array`	event_types parameter
`dm_event.fields`	`array`	A comma separated list of DmEvent fields to display.
`expansions`	`array`	A comma separated list of fields to expand.
`user.fields`	`array`	A comma separated list of User fields to display.
`post.fields`	`array`	A comma separated list of Post fields to display.
`media.fields`	`array`	A comma separated list of Media fields to display.

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "x_api__get_direct_messages_events_by_conversation_id",
  "arguments": {
    "id": "…"
  }
}

Or connect the X (Twitter) API server directly, which lists 258 tools including this one:

Run in your terminal

claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the get dm events by conversation id tool with id set to ….