Tools reference

Every tool the squidX MCP server can expose, grouped by the permission that unlocks it.

Tool names carry the squidx_ prefix so they sort together in a client's list. Arguments mirror the REST parameters of the same name; the Posts reference explains each one. A tool answers with one JSON text block, and a failure sets isError with the same { error, message } shape as the API.

readwriteconfirmread changes nothing · write changes the queue · confirm reaches X or deletes, and needs confirm: true

Workspace workspace:read

Tool	Arguments	Does
`squidx_get_workspace`read	none	Name, plan, timezone, weekly posting slots, X Communities, writing preferences, automation defaults and the connected X account. Call it first.

Posts: read posts:read

Tool	Arguments	Does
`squidx_list_posts`read	status[], limit, offset	Drafts, the queue and the published record, filtered by status, with metrics on posted rows.
`squidx_get_post`read	id	One post by id.
`squidx_get_next_slot`read	none	The next free weekly posting slot, where queueNext would land.

Posts: write posts:write

Tool	Arguments	Does
`squidx_create_post`write	segments[], status, scheduledAt, queueNext, exactTime, communityId, shareWithFollowers, autoReply, autoRetweet	Create a draft, or queue a post with scheduledAt or queueNext.
`squidx_update_post`write	id, segments[], scheduledAt, queueNext, exactTime, communityId, shareWithFollowers, autoReply, autoRetweet	Edit a draft, queued or failed post. Only the fields passed change.
`squidx_schedule_post`write	id, scheduledAt, queueNext, exactTime	Put a draft or failed post in the queue, or move a queued post to a new time.
`squidx_unschedule_post`write	id	Take a queued post out of the queue. It becomes a draft again.
`squidx_delete_post`confirm	id, confirm	Delete a post that is not on X, with its attachments.

Posts: publish posts:publish

Tool	Arguments	Does
`squidx_publish_post`confirm	id, confirm	Send a draft, queued or failed post to X immediately.

Analytics analytics:read

Tool	Arguments	Does
`squidx_get_analytics`read	range, series	Followers, posts, impressions and engagements over a window, with deltas and the posting streak.
`squidx_list_top_posts`read	range, sort, limit, offset	The account's own posts with their public metrics, best first.

Leads leads:read

Tool	Arguments	Does
`squidx_list_lists`read	none	The lead lists of the workspace.
`squidx_list_leads`read	listId, status, minRelevance, limit, offset	Qualified leads with score, reason and signals.

Mentions mentions:read

Tool	Arguments	Does
`squidx_list_mentions`read	kind, status, unanswered, limit, offset	Replies, quotes and mentions of the connected account.

Start with squidx_get_workspace

It returns the timezone, the posting slots and whether the X account can publish. An agent that reads it first schedules in the right timezone and never proposes a slot that does not exist.