MCP Tool Catalog

The Ayrshare MCP Server exposes 27 tools, grouped below by domain. Each tool is dispatched in-process through the real Ayrshare API chain.

Scope

Every tool is either Profile or Account scope:

Profile — the tool accepts a profileKey argument to target a sub-profile.
Account — the tool takes no profileKey; it operates at the account level.

The six tools that take no profileKey argument are: create_profile, list_profiles, explain_error, validate_media, generate_post, and recommend_hashtags. All other tools accept a profileKey; generate_jwt_social_linking_url requires one. Note: recommend_hashtags takes no profileKey argument but still reads the connection’s Profile-Key header to pick whose linked TikTok account it draws on, so its results are profile-specific. When both a per-call profileKey argument and a Profile-Key header are present, the argument wins. See Connect & Setup for the precedence rules.

Posts

Tool	Scope	Purpose
`create_post`	Profile	Publish to one or more linked platforms.
`validate_post`	Profile	Dry-run validation, same input as `create_post`.
`get_post`	Profile	Fetch a post by Ayrshare Post ID.
`update_post`	Profile	Update a scheduled or awaiting-approval post.
`retry_post`	Profile	Re-submit a failed post.

History

Tool	Scope	Purpose
`get_post_history`	Profile	Posts sent via Ayrshare.
`get_platform_history`	Profile	Posts and analytics direct from the network, including non-Ayrshare posts. For an X/Twitter `userId`/`userName` lookup, use the account API key only; a `profileKey` argument or `Profile-Key` header there returns Error 400.

Analytics

Tool	Scope	Purpose
`get_post_analytics`	Profile	Per-post metrics by Ayrshare Post ID.
`get_post_analytics_by_social_id`	Profile	Per-post metrics by native Social Post ID.
`get_social_network_analytics`	Profile	Account-wide analytics and demographics for a connected social account. For an X/Twitter `userId`/`userName` lookup, use the account API key only; a `profileKey` argument or `Profile-Key` header there returns Error 400.

Comments

Tool	Scope	Purpose
`get_comments`	Profile	Read comments on a post.
`add_comment`	Profile	Top-level comment.
`reply_comment`	Profile	Reply to a comment.

Messages / DMs

Tool	Scope	Purpose
`get_messages`	Profile	Fetch DMs for a platform.
`send_message`	Profile	Send a DM.
`get_auto_response`	Profile	Read DM auto-response settings.
`set_auto_response`	Profile	Configure DM auto-response.

Profiles

Tool	Scope	Purpose
`list_profiles`	Account	List sub-profiles.
`create_profile`	Account	Create a sub-profile.
`generate_jwt_social_linking_url`	Profile	Mint a JWT social-linking URL (requires `profileKey`).

Media

Tool	Scope	Purpose
`validate_media`	Account	HEAD-check a media URL is reachable; returns `contentType`.

Generate

Tool	Scope	Purpose
`generate_post`	Account	AI-draft post copy.
`recommend_hashtags`	Account	Hashtag suggestions from TikTok view-count data. Uses the linked TikTok account on the profile set by the `Profile-Key` header; takes no per-call `profileKey`.

Webhooks

Tool	Scope	Purpose
`register_webhook`	Profile	Register a webhook.
`unregister_webhook`	Profile	Unregister a webhook.
`list_webhooks`	Profile	List registered webhooks.

Errors

Tool	Scope	Purpose
`explain_error`	Account	Decode an Ayrshare error code into cause, classification, and fix.

This catalog is verified against the live server’s tools/list. More tools are planned (e.g. Links tools). If in doubt, query tools/list for the authoritative set. The catalog is maintained by the MCP server team.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Scope

Posts

History

Analytics

Comments

Messages / DMs

Profiles

Media

Generate

Webhooks

Errors

​Scope

​Posts

​History

​Analytics

​Comments

​Messages / DMs

​Profiles

​Media

​Generate

​Webhooks

​Errors

Scope

Posts

History

Analytics

Comments

Messages / DMs

Profiles

Media

Generate

Webhooks

Errors