Tools

Reference of every tool the Ordinal MCP server exposes for posts, ideas, approvals, comments, analytics, media, Slack boosts, Amplify, and LinkedIn monitoring.

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.

LinkedIn Monitoring

Tool	What it does
ordinal_list_linkedin_monitoring_posts	Lists inbox posts with unresolved comment counts, or fetches a single post’s metadata by ID.
ordinal_list_linkedin_monitoring_comments	Returns paginated root comments (with their replies) on an inbox post.
ordinal_manage_linkedin_monitoring_comments	Replies to a comment, reacts to it on LinkedIn, or resolves and unresolves it in the inbox.
ordinal_list_linkedin_monitoring_mentions	Lists inbound @mentions of your connected pages, or fetches a single mention by ID.
ordinal_manage_linkedin_monitoring_mentions	Comments on a mentioning post, reacts to it, or resolves and unresolves the mention.

These tools appear only for workspaces where LinkedIn Monitoring is enabled, and they act on the same inbox you see in the app. Comments are paginated 10 roots per page by default (max 50); posts and mentions are 20 per page (max 50). Replies and reactions are posted from a scheduling profile — get the profileId from ordinal_get_workspace_context.

Replying to a comment automatically resolves that comment. Replying to a reply still posts on the thread root. Commenting on a mention does not auto-resolve it — resolve separately when you’re done. LinkedIn reactions accept Like, Celebrate, Love, Insightful, Support, or Funny; sending the same reaction again removes it.

For example, ask “triage today’s LinkedIn comments — reply to anything from a customer and resolve the rest” and the assistant lists unresolved posts, pages through comments, replies where needed, and marks the others resolved.

ordinal_get_linkedin_mention under Platform utilities is different: it looks up a LinkedIn user or company URN to mention in post copy, not an inbox notification.

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.”
• “Reply to any unresolved LinkedIn comments on our launch post, then resolve the rest.”

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