Tool reference

What your assistant can call, and which of those calls change something.

Tools23

The catalogue

23 tools · 7 categories

Read-only tools never mutate state; destructive tools (publish, delete, disconnect) trigger explicit confirmation in clients that honour the destructiveHint annotation.

Identity & workspaces

Tool	Access	What it does
list_workspaces	Read	List the user's workspaces (with `isDefault`), the signed-in account with its plan and post quota, and the active workspace's connected accounts.
set_default_workspace	Write	Set or clear the default workspace so subsequent tools omit `workspace_id`.
create_workspace	Write	Create a new workspace owned by the authenticated user.
update_workspace	Destructive	Change the workspace name, website or logo, its timezone and preferred posting times, or outbound link tagging. Only the fields passed change; the result returns the workspace as saved.

Social accounts

Tool	Access	What it does
list_social_accounts	Read	All connected social accounts with health, expiry, and platform.
get_connection_urls	Read	OAuth URLs for connecting new social accounts.
disconnect_social_account	Destructive	Revoke a connected social account; tokens are deleted server-side.
fetch_platform_posts	Read	Read an account's recent posts straight from the platform, with their engagement.

Posts — read

Tool	Access	What it does
get_post_context	Read	One-call drafting bundle: workspace identity and settings (timezone, preferred posting times), the target account, and its recent posts with engagement. Call this before writing.
list_posts	Read	List drafts, scheduled, published and failed posts. Filter by status, keyword, platform, campaign, or date range; `group_by_day` lays them out as a calendar with a link to the calendar page.
get_post	Read	Single post with full payload (text, media, status, per-platform URLs, and an `editUrl` to the web composer).

Posts — write

Tool	Access	What it does
create_post	Write	Create a DRAFT post. Does not publish or schedule on its own — follow up with `schedule_post` or `publish_post`.
create_campaign	Write	Draft one idea across several accounts in one call, with separate copy per account. Each becomes its own post under a shared campaign.
update_post	Write	Edit a post's text, hashtags, media, schedule time or per-platform settings.
delete_post	Destructive	Soft-delete a post. For published posts also enqueues platform-side deletion when the connector supports it.

Posts — publishing

Tool	Access	What it does
publish_post	Destructive	Publish one post, several, or a whole campaign now, and wait once for the platforms' answer with the live URLs. A post whose publish failed is retried through the same checks.
schedule_post	Destructive	Schedule one post, several, or a whole campaign for a future time. A post that cannot be scheduled is reported on its own and the rest still go.

Analytics & planning

Tool	Access	What it does
get_performance	Read	Engagement per published post, per platform, for a given window. Totals are kept per platform, never summed across them.
get_engagement_history	Read	Per-day engagement across the workspace, or for one post with `post_id` (cumulative and daily columns).

Media

Tool	Access	What it does
list_media	Read	Workspace media library — images, video, PDFs.
add_media	Write	Add media to the library and to every listed post in one call, from exactly one source: a file attached in ChatGPT, a public URL, a one-time upload address for one curl from a shell or Claude's code execution sandbox (allow api.antwork.io), or items already in the library. Appends; nothing already on a post is removed.
attach_media	Write	Set a post's exact media list: reorder, remove, or clear with an empty list.
delete_media	Destructive	Soft-delete a media item; does not affect posts that already reference it.

Tool argument schemas are introspected from the server live — connect a client and call tools/list to see the canonical JSON Schemas with required fields and types.