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. |
| 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). |
| 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.
