Home / Servers / X (Twitter) API / get_direct_messages_events_by_participant_id
Get DM Events by Participant ID
An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.
Get DM Events by Participant ID Retrieves direct message events for the one-to-one conversation between the authenticated user and a specific participant. [GET /2/dm_conversations/with/{participant_id}/dm_events]
Name on the gateway: x_api__get_direct_messages_events_by_participant_id · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
participant_id required | string | participant_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. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "x_api__get_direct_messages_events_by_participant_id",
"arguments": {
"participant_id": "…"
}
}Or connect the X (Twitter) API server directly, which lists 258 tools including this one:
claude mcp add --transport http hj-x-api https://mcp.hjlabs.in/mcp/x-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the get dm events by participant id tool with participant_id set to ….