Tools - Ordinal Docs

Overview

Once connected, your assistant has access to the tools below. You don’t need to call them by hand — just ask in plain language (“draft a LinkedIn post for Friday,” “show me last month’s engagement”) and the assistant picks the right tool.

Always start with workspaces. If this is a new session, ask the assistant to “list my Ordinal workspaces” first. It needs to know which workspace you want before it can do anything else.

Discovery

Tool	What it does
`ordinal_get_workspace_context`	Lists your workspaces, then (once you pick one) returns the profiles, labels, and users the assistant needs to do everything else. The assistant requests only the sections it needs and can filter profiles by channel or name, so large workspaces stay within response limits.

Posts and ideas

Tool	What it does
`ordinal_search_content`	Searches posts or ideas — by status, labels, campaigns, or date — and can fetch a single post with its comments.
`ordinal_create_post`	Creates a post with LinkedIn, X, Instagram, TikTok, and/or YouTube Shorts content, optionally with a workflow status.
`ordinal_create_idea`	Creates an idea (a draft without a scheduled publish time).
`ordinal_manage_post`	Updates, archives, or unarchives a post, including changing its workflow status.
`ordinal_manage_idea`	Updates, archives, unarchives, or adds an idea to the calendar.
`ordinal_list_post_versions`	Lists saved versions of a post’s draft per channel, with the author and timestamp of each.
`ordinal_get_post_version_content`	Reads the copy of a single saved version, so the assistant can diff two revisions or study how a draft evolved.

Post statuses

ordinal_create_post and ordinal_manage_post accept a status of Tentative, ToDo, InProgress, ForReview, or Scheduled, so the assistant can move posts through the same workflow statuses you use in the app. New posts default to ToDo. Posted can’t be set through MCP because Ordinal applies it only after a post publishes. For example, ask “move my draft about the pricing launch to For Review” and the assistant calls ordinal_manage_post with status: "ForReview".

Media

Tool	What it does
`ordinal_create_upload`	Uploads an image or video from a URL, or prepares signed credentials so a local file can be uploaded.
`ordinal_get_upload`	Checks whether an upload is ready.

For a local file, the assistant calls ordinal_create_upload with filename, mimetype, and size, POSTs the file to the returned uploadUrl with params and signature, then polls ordinal_get_upload until status is ready.

Analytics

Tool	What it does
`ordinal_get_analytics`	Fetches post performance or follower growth for LinkedIn, X, Instagram, or Facebook.

Collaboration

Tool	What it does
`ordinal_list_approvals`	Shows who needs to approve a post and whether they’ve approved yet.
`ordinal_manage_approvals`	Requests or cancels approvals on a post.
`ordinal_list_subscribers`	Lists who’s subscribed to notifications on a post.
`ordinal_manage_subscribers`	Adds or removes subscribers.
`ordinal_manage_comments`	Adds a comment to a post or deletes one of your own.

Team engagements

Tool	What it does
`ordinal_list_engagements`	Lists team likes, comments, and reposts attached to a post.
`ordinal_manage_engagements`	Creates, updates, or removes team engagements.

Slack boosts

Tool	What it does
`ordinal_list_slack_boosts`	Lists Slack broadcasts attached to a post.
`ordinal_manage_slack_boosts`	Creates, updates, or deletes Slack boosts.

Amplify

Tool	What it does
`ordinal_list_amplify_links`	Lists published Amplify campaign links (live or completed) with their titles, dates, and short link URLs. Drafts are omitted.
`ordinal_list_amplify_engagers`	Lists the people who completed actions on a published Amplify link — one entry per person with their name, headline, LinkedIn profile URL, and every like, comment, repost, or post they completed, each with a permalink.

Both tools are read-only and require Amplify to be enabled on your workspace. Like permalinks point at the campaign’s target post; comment, repost, and post permalinks point at the engager’s own content. ordinal_list_amplify_engagers is paginated (default 50 per page, max 100) and accepts an optional action filter. The filter only narrows which people are returned — each person’s list of actions still includes everything they completed on the link. For example, ask “who engaged with our launch Amplify link?” and the assistant calls ordinal_list_amplify_links to find the link, then ordinal_list_amplify_engagers to return names and permalinks your team can follow up on.

Labels

Tool	What it does
`ordinal_manage_labels`	Creates or deletes labels used to organize posts.

Platform utilities

Tool	What it does
`ordinal_get_linkedin_mention`	Looks up a LinkedIn user or company by username so it can be mentioned in a post.
`ordinal_get_linkedin_profile`	Fetches a LinkedIn profile by its URN.
`ordinal_search_instagram_locations`	Searches Instagram location tags to attach to posts.

Asking the assistant things

You don’t call these tools by name — you describe what you want. Examples:

“Create a LinkedIn post for next Tuesday about our new pricing, in the Launch campaign.”
“Archive the drafts I wrote last month that don’t have a label.”
“Show me which posts are waiting on approval from Sarah.”
“Give me the last 30 days of follower growth on LinkedIn.”
“Show me how the LinkedIn copy on this post changed between the last two saves.”
“List everyone who commented through our launch Amplify link, with links to their comments.”

The assistant picks the tools, fills in the arguments, and shows you the result.

​Overview

​Discovery

​Posts and ideas

​Post statuses

​Media

​Analytics

​Collaboration

​Team engagements

​Slack boosts

​Amplify

​Labels

​Platform utilities

​Asking the assistant things

Overview

Discovery

Posts and ideas

Post statuses

Media

Analytics

Collaboration

Team engagements

Slack boosts

Amplify

Labels

Platform utilities

Asking the assistant things