Home / Servers / X (Twitter) API / chat_media_upload_initialize

Initialize Chat Media Upload

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

Initialize Chat Media Upload Initializes an XChat media upload session. [POST /2/chat/media/upload/initialize]

Name on the gateway: x_api__chat_media_upload_initialize · may change things.

Parameters

NameTypeDescription
conversation_id requiredstringThe XChat conversation the upload belongs to.
total_bytes requiredintegerTotal size of the media upload in bytes.

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:

call_tool arguments
{
  "name": "x_api__chat_media_upload_initialize",
  "arguments": {
    "conversation_id": "…",
    "total_bytes": 0
  }
}

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"

Try asking

Use the initialize chat media upload tool with conversation_id set to ….

More from X (Twitter) API