MCP tool

list_accounts

List connected accounts

Reads only · changes nothing, and needs no approval.

What it does

List the connected social accounts (ref, id, platform, username, status). USE ref WHEN POSTING — it is the readable name for the account ("x:someone") and it is what a person sees on the card they have to approve before anything is created; the uuid tells them nothing. ref is always sendable as it comes back, including the rare account whose ref is its uuid because two accounts share one username. Each account also carries limits and can — what THIS connection will publish. limits: caption_chars (the ceiling), caption_chars_available (the same ceiling minus the project's signature, which is the room your words actually have — write to this one), max_media (attachments that survive; extras are dropped or the post is refused), media_required (true where a text-only post is refused outright) and video_seconds. can: placements (surfaces besides the feed — reels, stories), first_comment, people_tags, reel_music, documents (PDF), and mixed_media (false where photos and video cannot both go out in one post). Read them BEFORE writing, and write to the tightest one in the send — the caption is shared across every account unless you give a platform its own in platform_configurations. Several depend on how the account was connected rather than on the platform, so check the account you are actually posting to; they are what the wire does, not what the platform advertises. AN EMPTY LIST IS AN ANSWER, and it comes with connect_message and connect_url. Say what the message says and hand over the link: nothing can be posted anywhere until they connect an account, and the person cannot see our dashboard from here, so you are the only thing that can tell them.

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": "list_accounts",
  "arguments": {}
}

The other tools

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