Home / Servers / X (Twitter) API / get_chat_conversations
Get Chat Conversations
An MCP tool from the X (Twitter) API server, hosted on mcp.hjlabs.in.
Get Chat Conversations Retrieves a list of Chat conversations for the authenticated user's inbox, newest first: the most recently active conversation comes first. The unread, last_read_event_id and newest_event_id fields… [GET /2/chat/conversations]
Name on the gateway: x_api__get_chat_conversations · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
max_results | integer | Conversations covered per page (1-1000, default 200). Filtered pages can… |
pagination_token | string | meta.next_token from the previous page. Send the same filters with it, or the… |
unread_only | boolean | Return only unread conversations. A page can be short; keep paging while… |
type | direct | group | Only direct (1:1) or only group conversations. Omit for both. |
is_archived | boolean | true: only archived; false: only not archived. Omit for both. |
is_muted | boolean | true: only muted; false: only not muted. Omit for both. |
participant_ids | array | Comma-separated numeric user IDs (1-10), all in the chat. Names or @handles… |
participant_query | string | Name or @username prefix (1-50 chars); keeps chats where any other participant… |
start_time | string | ISO 8601, e.g. 2026-10-16T00:00:00Z. Chats whose latest message is at or after… |
end_time | string | ISO 8601, e.g. 2026-10-17T00:00:00Z. Chats whose latest message is before this… |
chat_conversation.fields | array | A comma separated list of ChatConversation 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. |
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_chat_conversations",
"arguments": {}
}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 chat conversations tool with max_results set to ….