Tools reference - OnlySocial API

Your assistant discovers these tools by itself when it connects. You never call them by name; this page is for knowing what to ask for, and why a tool might be missing.

You only see the tools your role and plan allow. Sales inbox tools appear only where your plan includes the sales inbox, and each one hides itself if your team role cannot open that area in the dashboard. Almost every tool takes a workspace uuid from list-workspaces.

Publishing

Workspaces and accounts

Tool	What it does
`list-workspaces`	The workspaces you can use here, most recently updated first. With a sign-in connection, just the one you picked.
`get-workspace`	One workspace: name, colour, your role and approval rights, and counts of accounts, posts and members.
`list-accounts`	The social accounts connected to a workspace, with the numeric IDs `create-post` needs.
`get-account`	One account: provider, username, authorisation status, profile link and metrics.

Posts

Tool	What it does
`list-posts`	Posts, newest first. Filter by account, status, tag, keyword and date ranges.
`get-post`	One post: status, times, tags, the accounts it targets with live links or publish errors, and every content version.
`create-post`	Create a post, and optionally schedule or publish it.
`update-post`	Change a post’s content, accounts, tags or schedule.
`update-post-version`	Change one account’s version of a post and leave the others alone.
`duplicate-post`	Copy a post as a new draft.
`schedule-post`	Schedule a post for a date and time, or publish it now.
`add-post-to-queue`	Put a post in the next free slot of the workspace’s posting schedule.
`delete-post`	Move a post to the trash, delete it for good, or also remove it from the social networks.
`restore-post`	Bring a post back from the trash as a draft.
`attach-tags-to-post`	Add tags to a post.
`detach-tags-from-post`	Remove tags from a post.

Tags and media

Tool	What it does
`list-tags`	The workspace’s post tags.
`get-tag`	One post tag.
`create-tag`	Create a post tag.
`update-tag`	Rename or recolour a post tag.
`list-media`	Images, GIFs and videos in the media library.
`get-media`	One media file: type, URLs, alt text and source.
`upload-media-by-url`	Add a file to the library from a public URL. Large files download in the background.
`get-media-upload-status`	Progress of a background download started by `upload-media-by-url`.

Sales inbox

Overview and lookups

Tool	What it does
`get-workspace-overview`	A snapshot of the business: timezone, connected channels, contact usage, what is waiting in the inbox and today’s bookings. The best first call.
`get-reference`	The exact statuses, field names, approved WhatsApp templates and automation step types this workspace uses.
`list-channels`	Connected messaging channels and whether each can send right now.
`list-segments`	Saved audiences, with how many contacts match each.
`list-pipeline-stages`	The sales pipeline’s stages, in board order, with contact counts.

Contacts

Tool	What it does
`search-contacts`	Find people by name, phone, email or handle, and filter by stage, tag, segment or date.
`get-contact`	Everything about one contact: profile, stage, tags, custom fields, channels, notes and upcoming meetings.
`create-contact`	Add a person. Refuses a phone number that already belongs to a contact.
`update-contact`	Change a contact’s details, custom fields or pipeline stage. Only the fields you pass change.
`tag-contact`	Add a contact tag (not a post tag). Can start automations that listen for that tag.
`untag-contact`	Remove a contact tag.
`add-contact-note`	Write an internal note on a contact.

Conversations and messages

Tool	What it does
`list-conversations`	The inbox, most recent first, with unread counts and assignees. Filter by open or done, unread, platform or name.
`get-conversation`	The message thread with one contact, as a transcript.
`assign-conversation`	Assign a conversation to a teammate, or unassign it.
`close-conversation`	Mark a conversation as done. It can start the workspace’s conversation-closed automation, so it needs `confirm: true`.
`send-message`	Send a text message to one contact. Needs `confirm: true`.
`send-template-message`	Send an approved WhatsApp template, including outside the 24-hour window. Needs `confirm: true`.

Broadcasts

Tool	What it does
`preview-broadcast`	Work out exactly who a broadcast would reach and freeze that list. Nothing is sent.
`submit-broadcast`	Create the broadcast for the previewed audience, awaiting approval in the dashboard. Needs `confirm: true`.

Automations

Tool	What it does
`list-automations`	The workspace’s automations: trigger, channel, whether each is live, and runs in flight or failed.
`get-automation-flow`	The steps inside one automation.
`get-automation-runs`	Recent runs and why each one stopped.
`create-automation`	Create an automation as an unpublished draft.
`save-automation-flow`	Replace a draft’s steps. Customers keep getting the published version until someone presses Publish.
`set-automation-state`	Switch an automation on or off.

Appointments

Tool	What it does
`list-appointments`	The meetings calendar.
`find-available-slots`	Bookable slots for a meeting type over a date window, honouring its hours, buffers and connected calendar.
`book-appointment`	Book a contact into a slot.
`reschedule-appointment`	Move a booking.
`cancel-appointment`	Cancel a booking.

Resources

Apps that read MCP resources also get four reference documents, the same content as get-reference: what this connection can do, the contact field names, the automation step types and the approved WhatsApp templates.

​Publishing

​Workspaces and accounts

​Posts

​Tags and media

​Sales inbox

​Overview and lookups

​Contacts

​Conversations and messages

​Broadcasts

​Automations

​Appointments

​Resources

Publishing

Workspaces and accounts

Posts

Tags and media

Sales inbox

Overview and lookups

Contacts

Conversations and messages

Broadcasts

Automations

Appointments

Resources