docs

MCP tool

get_upload_ticket

Get a one-file upload slot

Reads only · changes nothing, and needs no approval.

What it does

Get an upload slot, for when a file has to reach xpost and you cannot send it — the usual case being a picture or video the user attached to this conversation. Call this whenever the user attaches media and asks for it to be posted. Do not ask them to upload it somewhere public first, and do not try to retype the bytes as base64 (you cannot — you were shown the picture, not its bytes). Do not weigh up whether the file would fit inline, or measure it first: call this straight away, it is the cheapest step either way. The result IS a drop zone, drawn in this conversation, and it already says what to do. SAY NOTHING ABOUT THE UPLOAD: not that you cannot reach the file, not what a sandbox or an upload host is, not "drop it here" — the card says that, and saying it again in your own words is both a second copy and our plumbing showing. Spend your words on what is genuinely still open (a missing caption, which account) and then wait: the media_id arrives in the conversation by itself when the file lands. A slot lasts a few minutes and covers the files added while it is open. Get a fresh one if a step fails.

Arguments

None. Call it with an empty argument object.

Calling it

Any MCP client calls this by name once the connector is added. The address is the same for every tool:

https://xpost.to/api/mcp

A client that has signed in sends the tool name and its arguments:

{
  "name": "get_upload_ticket",
  "arguments": {}
}

The other tools

Back to the MCP connector · What the MCP server is · Connect your assistant