Retrieve follower counts over time for a connected LinkedIn profile, as one data point per recorded day. Use listschedulingprofiles to find the profile ID. For per-post engagement instead, use getlinkedinpost_analytics. Not paginated.
Retrieve per-post LinkedIn metrics for a connected profile: impressions, reactions, comments, shares, clicks, video views, engagement rate, and earned media value. Each row links back to its Ordinal post when it was published from Ordinal. Use listschedulingprofiles for the profile ID.
Retrieve follower counts over time for a connected X profile, as one data point per recorded day. Use listschedulingprofiles to find the profile ID. For per-post engagement instead, use getxpost_analytics. Not paginated.
Retrieve per-post X metrics for a connected profile: impressions, likes, replies, retweets, quotes, bookmarks, engagement rate, and earned media value. Each row links back to its Ordinal post when it was published from Ordinal. Use listschedulingprofiles for the profile ID.
Read the workspace's cost-per-mille values per platform. These are the multiplier behind the emv figure on every post-analytics row (impressions / 1000 * CPM), so read this to know what an earned-media-value number assumes.
Set the workspace's cost-per-mille values, one or more platforms at a time. This retroactively changes the emv figure reported by getlinkedinpostanalytics and getxpostanalytics for every post, so read getanalyticscpm first.
List the approval requests on a post, showing who was asked, who has signed off, and which requests block publishing. Use list_posts to find post IDs. Not paginated.
Ask one or more workspace members to approve a post, optionally with a note, due date, and a blocking flag that stops publishing until they sign off. Call listusers for userIds and listposts for the postId. Members who already have an open request come back under existingApprovals.
Withdraw an approval request from a post. If it was blocking, the post can publish again. Use listpostapprovals to find approval IDs.
List the team's comments on a post, oldest first, with who wrote each one. These are internal review comments, not comments on the published social post. For comments anchored to specific draft text, use listpostinline_comments. Not paginated.
Add an internal comment to a post for the team to see. To notify someone, mention them as '@Display Name' using an ID from listusers. Use listposts to find post IDs. This does not comment on the published social post.
Delete an internal comment from a post. Use listpostcomments to find comment IDs.
List inline comment threads on a post, each anchored to a highlighted piece of draft copy, with its replies and whether it is resolved. Filter by channel or resolved state. For post-level comments instead, use listpostcomments. Not paginated.
List every workspace in the company. Requires a company API key, not a workspace key. Returns the workspace IDs that getcompanyworkspace, listworkspaceapikeys, and createworkspaceapikey take. Not paginated.
Create a new workspace in the company, optionally seeding it with members. Requires a company API key. Returns the new workspace ID, which createworkspaceapi_key takes to mint a workspace key for it.
Retrieve one workspace in the company by ID, including its timezone. Requires a company API key. Use listcompanyworkspaces to find workspace IDs.
List the API keys issued for one workspace, with their names and last-used times. The key values are never returned, only a masked hint. Requires a company API key. Use listcompanyworkspaces to find workspace IDs. Not paginated.
Mint a new API key for one workspace. Requires a company API key. The key value is returned once here and never again, so store it immediately. Use listcompanyworkspaces to find workspace IDs.
List the likes, comments, and reposts queued on a post for teammates' profiles to perform after it publishes, with their delays. Use list_posts to find post IDs. Not paginated.
Queue likes, comments, or reposts that teammates' profiles perform automatically after a post publishes. Call listengagementprofiles for profileIds, a different set from the scheduling profiles. Comment and Repost need copy and delaySeconds; Like must omit both, and may set reactionType on LinkedIn only.
Change a queued engagement's comment text, delay, profile, or LinkedIn reaction. Only the fields you pass change. Use listpostengagements to find engagement IDs and listengagementprofiles for profileIds.
Remove a queued engagement so that profile will not like, comment, or repost when the post publishes. Use listpostengagements to find engagement IDs.
List unscheduled ideas, newest first. Filters by channel, profile, label, and creation date are applied by Ordinal. Ideas have copy but no publish time. Use addideatocalendar to turn one into a post. Cursor-paginated via pageinfo.
Create an unscheduled idea with copy for LinkedIn, X, TikTok, or YouTube Shorts. Ideas have no publish time; use addideatocalendar to schedule one. Call listschedulingprofiles for profileIds and listlabels for labelIds. Returns the new idea ID.
Retrieve one idea with its per-channel copy and media. Use list_ideas to find idea IDs.
Update an idea's title, labels, campaign, notes, or per-channel copy. Only the fields you pass change. Use listideas to find idea IDs, listschedulingprofiles for profileIds, and listlabels for labelIds.
Archive an idea, moving it out of the idea list into the trash. Use unarchiveidea to restore it, and listideas to find idea IDs.
Restore an archived idea back to the idea list. Use list_ideas to find idea IDs.
Promote an idea to a calendar post on a given date, carrying its copy across. Returns the new post ID, which getpost and schedulepost take. This does not publish the post. Use list_ideas to find idea IDs.
List workspace invitations that have not been accepted yet, with who sent each one. For members who have already joined, use list_users instead. Not paginated.
Invite someone to the workspace by email. Ordinal emails them immediately, so only call this for a real teammate. Check listinvites and listusers first to avoid a duplicate invitation.
Revoke a pending workspace invitation so the link stops working. Use list_invites to find invite IDs.
List the labels defined in the workspace, with their IDs and colors. Call this before createpost, updatepost, createidea, or a labelIds filter on listposts, since label IDs are workspace-specific and cannot be guessed. Not paginated.
Create a workspace label that can then be assigned to posts and ideas. Returns the new label ID for use as a labelIds value. Check list_labels first so you do not duplicate an existing label.
Delete a workspace label. It is removed from every post and idea that carried it. Use list_labels to find label IDs.
Resolve a LinkedIn vanity name into the '@Name' string LinkedIn post copy needs to tag a person or company. Call this before writing copy with an @ mention, since the URN cannot be guessed. A vanity name may match a person, a company, or neither, so both fields can be null.
Look up a LinkedIn person or company by URN and get their display name, vanity name, and avatar. Use getlinkedinmention_format when you have a vanity name and need the URN, which is the reverse of this lookup.
Search Instagram locations by name for the pageId that tagging a location on an Instagram Feed or Reel post needs, e.g. 'Ferry Building San Francisco'. There is no other way to obtain a pageId.
List posts on the Ordinal calendar, newest first. Filters by status, channel, profile, label, publish date, and creation date are applied by Ordinal. Use this to browse or filter; use getpost for one post's full content. Cursor-paginated via pageinfo.
Create a post with copy for one or more channels. Call listschedulingprofiles for profileIds, listlabels for labelIds, and uploadfilefromurl for media assetIds first. Use getlinkedinmentionformat for '@Name' mentions. Returns the new post ID. The echo is partial: labels, publishAt, notes and the channel profile may read back empty, so treat getpost as authoritative.
Retrieve one post with its full per-channel copy, media, labels, and schedule. Use listposts to find post IDs. For a post's draft history instead, use listpost_versions.
Update a post's title, publish time, status, labels, notes, or per-channel copy. Only the fields you pass change. Use listposts to find post IDs, listschedulingprofiles for profileIds, and listlabels for labelIds. Labels are not echoed back: confirm them with list_posts and a labelIds filter.
Archive a post, moving it off the calendar into the trash without publishing it. Use unarchivepost to restore it, and listposts to find post IDs.
Restore an archived post back onto the calendar. Its schedule is not restored, so follow with schedulepost if it should publish. Use listposts to find post IDs.
Queue a post to publish, optionally at a new time. This makes the post go live on the connected social accounts at that time. Use unschedulepost to pull it back to a draft, and listposts to find post IDs.
Remove a post from the publishing queue and return it to a draft status. The copy is kept. Use schedulepost to queue it again, and listposts to find post IDs.
List saved draft versions of a post's copy, grouped by channel, with who edited each one. Returns metadata only, so it is far cheaper than reading every version. Pass a version ID to getpostversion for the text. Pagination is per channel, so send the same channel with a cursor.
Read the plain-text copy of one saved draft version for one channel. Use listpostversions to find version IDs and which channels have history. Cheaper than get_post when you only need the text of a past draft.
List the connected social accounts posts can publish from, with the profile IDs that createpost, updatepost, create_idea, and the analytics tools require. Call this first when composing a post: profile IDs are workspace-specific and cannot be guessed. Not paginated.
List the connected social accounts that can like, comment, and repost on behalf of the team, with the profile IDs createpostengagements and updateengagement require. These are a different set from listscheduling_profiles. Not paginated.
List the Slack channels connected to the workspace, with the slackWebhookId values createslackboost and updateslackboost require, and whether each notifies by default. Call this before creating a boost. Not paginated.
List the Slack notifications queued on a post, which channel each goes to, and whether Ordinal added it automatically. Use list_posts to find post IDs. Not paginated.
Queue a Slack notification asking a channel to go engage with a post when it publishes. Call listslackwebhooks for slackWebhookId and list_posts for the postId. Returns the new boost ID.
Retrieve one Slack boost with its message text and target channel. Use listpostslack_boosts to find boost IDs.
Change a Slack boost's message text or move it to a different channel. Only the fields you pass change. Use listpostslackboosts to find boost IDs and listslack_webhooks for slackWebhookId values.
Remove a Slack boost so no notification is sent for the post. Use listpostslack_boosts to find boost IDs.
List the workspace members subscribed to notifications about a post, and who added each of them. Use list_posts to find post IDs. Not paginated.
Subscribe workspace members to notifications about a post. Call listusers for userIds and listposts for the postId. Read BOTH result lists: a member already subscribed comes back under existingSubscribers with createdSubscribers empty, which is common because the post's creator is auto-subscribed.
Unsubscribe a member from a post's notifications. Use listpostsubscribers to find subscriber record IDs, which are not the same as user IDs.
Import an image or video from a public URL so it can be attached to a post. Returns an upload job, not an asset: poll getuploadstatus until the status is 'ready', then use the assetId it returns in a channel's assets array on createpost or updatepost.
Reserve an upload slot and get signed credentials for sending local file bytes to Ordinal yourself, as a multipart POST to the returned uploadUrl. It does not transfer any file. When the media already lives at a URL, use uploadfilefrom_url instead, which needs no second request.
Check an upload job and read its assetId once processing finishes. Status is 'pending' or 'processing' while Ordinal works, 'ready' when the assetId is available for a post, and 'failed' or 'expired' otherwise. Use the ID from uploadfilefromurl or preparefile_upload.
Validate the Ordinal API key with one lightweight read. Checks a workspace key against the workspace endpoint, or a company key against the company workspace list.
List the webhooks configured in the workspace, with their delivery URLs and subscribed event topics. Use get_webhook for one webhook's custom headers. Not paginated.
Create a webhook that POSTs Ordinal events to a URL. Subscribe to topics such as post.published, post.publishfailed, post.approval.requested, or invite.accepted. Returns the new webhook ID. Check listwebhooks first so you do not duplicate an existing subscription.
Retrieve one webhook with its delivery URL, subscribed topics, and custom headers. Use list_webhooks to find webhook IDs.
Change a webhook's name, delivery URL, subscribed topics, description, or custom headers. Passing topics or headers replaces the whole list, it does not merge. Use list_webhooks to find webhook IDs.
Delete a webhook so Ordinal stops delivering events to it. Use list_webhooks to find webhook IDs.
Retrieve the workspace this API key belongs to: name, slug, and the IANA timezone that publishDate values and the calendar are expressed in. Read this before interpreting or setting publish dates.
List workspace members with the user IDs that createapprovals, addpostsubscribers, and '@Name' comment mentions require. For people who have been invited but have not joined, use listinvites. Not paginated.
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
