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.

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. Every post and idea it returns includes its notes.
`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.

Notes

ordinal_create_post, ordinal_create_idea, ordinal_manage_post, and ordinal_manage_idea can write a post’s or idea’s notes, and ordinal_search_content returns them, so the assistant can read the internal context your team left on a draft. Posts and ideas without notes return null, and setting notes to null with a manage tool clears them.

Notes don’t support mentions. If the assistant writes a mention into a note, Ordinal keeps the person’s name as plain text.

For example, ask “what notes did we leave on the pricing launch post?” and the assistant calls ordinal_search_content to fetch the post and read its notes.

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, video, or PDF from a URL, or prepares signed credentials so a local file can be uploaded. PDFs are LinkedIn-only and publish as document (carousel) posts.
`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.