Ayrshare Tools
Use Ayrshare when an agent needs to publish or validate social posts; inspect post history and analytics; manage comments, DMs, profiles, social-account linking, and webhooks; validate media; generate draft copy; or explain provider errors across supported social networks. Choose this first-party 27-tool Action MCP for account-owned Ayrshare workflows. It supports immediate and scheduled publishing through create_post, but does not currently expose post deletion or separate auto-schedule configuration. A personal Ayrshare API key and the required provider plan entitlements are required. Ask before publishing, messaging, commenting, changing profiles, auto-responses, webhooks, or generating a client linking URL.
Category
Pricing and payment
- Pricing
- Free in Loadout. Provider charges may apply when using a personally connected account.
- Unified payment
- Not currently supported. Connect a provider account when required.
Use Ayrshare Tools with AI agents
Aident Loadout lets Claude Code, Codex, Cursor, and other supported agents call Ayrshare Tools. Choose from 27 supported Actions. Review each execution in Audit. Connect Ayrshare Tools once through Aident Vault. Your agent can use the supported Actions without receiving the underlying credential.
Included Actions
- Add CommentAdd a top-level comment to a published post using an Ayrshare Post ID or Social Post ID. Notes: When `searchPlatformId` is true, `platforms` must contain exactly one entry. `mediaUrls` supports one image URL on Facebook, LinkedIn, and X/Twitter only. Comments on an X Thread land…
- Create PostPublish a post to one or more linked social platforms in a single call. Notes: per-platform results are preserved (never collapsed to one boolean); to recover a failed post use `retry_post`, never re-call `create_post` (it would duplicate on the platforms that already succeeded).
- Create ProfileCreate a new User Profile under the caller's Primary Profile. Required: `title` (unique, shown on the social-account-linking page). Returns `profileKey` and `refId` — SENSITIVE values that must be securely stored (profileKey is only returned at creation time or via the dashboard…
- Explain ErrorLook up an Ayrshare error code and return a plain-English cause, classification, and resolution hint. Use this whenever a prior tool call returned a structured error code — explain the cause and propose a fix. Notes: `platform` narrows the explanation to a specific network. Requ…
- Generate Jwt Social Linking UrlGenerate a single sign-on (JWT) SOCIAL-ACCOUNT LINKING URL for one User Profile (sub-profile), so a client/customer can connect their own social networks (Facebook, Instagram, X, LinkedIn, TikTok, etc.) to that profile. This is the onboarding step after `create_profile`: it retu…
- Generate PostGenerate AI-written social post copy from a topic or media. Provide `text` (a topic/brief), `mediaUrls` (public image URLs to caption), or both — at least one is required. Returns DRAFT copy only — does NOT publish. Feed the result to validate_post, then create_post. Notes: `has…
- Get Auto ResponseReturn the account's current direct-message auto-response settings (account-level, not platform-scoped). Notes: Takes no parameters. Returns autoResponseActive, autoResponseMessage, and autoResponseWaitSeconds when configured. To update settings use set_auto_response.
- Get CommentsRead comments for a post using an Ayrshare Post ID, Social Post ID, or Social Comment ID. Notes: `platform` is required when `searchPlatformId` or `commentId` is true. Comment data refreshes every 10 minutes; X/Twitter uses exponential backoff. Facebook and Instagram return up t…
- Get MessagesFetch direct messages or conversations for one messaging platform (facebook, instagram, twitter). Notes: Facebook and Instagram responses are cached for 60 s; X/Twitter for 15 s. Use conversationsOnly to list thread summaries, conversationId to scope to one thread, and limit + n…
- Get Platform HistoryFetch posts and analytics DIRECTLY from a social network, including posts NOT created through Ayrshare. Returns native Social Post IDs (not Ayrshare Post IDs) — use these with get_comments or get_post_analytics_by_social_id. Notes: platform is required; userId/userName (X/Twitte…
- Get PostRetrieve a single post record by Ayrshare Post ID, returning per-platform postIds, status, payload, and timestamps. Notes: `id` is the top-level Ayrshare Post ID, not a platform-native ID; use get_post_history for filtered list lookups.
- Get Post AnalyticsGet real-time analytics (likes, impressions, views, reactions) for a post sent via Ayrshare. Notes: id is the Ayrshare Post ID (not the native social post ID); YouTube/TikTok need 24-48 h to populate; Pinterest impressions take 24-72 h. For posts NOT created through Ayrshare, us…
- Get Post Analytics By Social IdGet real-time analytics for a post identified by its NATIVE Social Post ID (the platform's own ID, not an Ayrshare Post ID). Notes: exactly one platform required; body is locked to {id, platforms:[platform], searchPlatformId:true} — no extra keys forwarded. For posts created thr…
- Get Post HistoryList posts sent via Ayrshare (most recent first). All parameters are optional query filters. Notes: use 'gmb' not 'googlebusiness'; deleted posts only returned when status='deleted'; lastDays ignored when startDate+endDate provided; results cached 1 min when limit>25. For posts…
- Get Social Network AnalyticsAccount-level analytics and demographics for a linked social network account (follower count, impressions, views, demographics). Notes: quarters 1-4 activates date filtering; daily and period60Days are incompatible; Facebook needs >=100 page likes for full analytics; Instagram d…
- List ProfilesList the User Profiles under the caller's Primary Profile (which is not itself included); all inputs are optional filters/pagination. Notes: Profile Keys are NOT returned for security — retrieve them from the dashboard.
- List WebhooksList webhook subscriptions for the authenticated account. Returns webhook records (action, url, source, timestamps) without secrets (those are write-only). Notes: without allWebhooks=true the list scopes to the current profile only; use register_webhook / unregister_webhook to m…
- Recommend HashtagsGet recommended hashtags for a keyword, sourced from TikTok view-count data. Required: `keyword`. A linked TikTok account is required (the API returns an error otherwise). Notes: To generate hashtags from a full post body instead of a single keyword, use generate_post (which can…
- Register WebhookRegister an HTTPS endpoint to receive Ayrshare event notifications for a given action. Returns the registered webhook record. Notes: re-registering the same (action, url, source) updates the existing record; secrets are write-only and never returned by list_webhooks.
- Reply CommentReply to a comment using an Ayrshare Comment ID or Social Comment ID. Notes: When `searchPlatformId` is true, `platforms` must contain exactly one entry. `videoId` is required for TikTok Social Comment ID replies. `mediaUrls` supports one image URL on Facebook and LinkedIn only.…
- Retry PostRe-submit a previously failed post (status 'error') for publishing. Notes: a post may be retried only ONCE; only use when the error indicates a transient failure — verify the post was not already published before retrying.
- Send MessageSend a direct message on facebook, instagram, or twitter. Notes: At least one of message or mediaUrls is required. At least one of recipientId or conversationId is required. Facebook and Instagram require recipientId and only accept messages within the platform's messaging windo…
- Set Auto ResponseConfigure the account's direct-message auto-response (account-level, not platform-scoped). Notes: At least one of autoResponseActive, autoResponseMessage, or autoResponseWaitSeconds is required. Send autoResponseMessage as "" to reset the message to the Ayrshare default. To read…
- Unregister WebhookRemove a previously registered webhook subscription for the given action. Returns confirmation of the removed subscription. Notes: only stops future deliveries; pass `profileKey` as an argument or via the `Profile-Key` header to target a sub-profile's subscription.
- Update PostUpdate a scheduled or awaiting-approval post's metadata (scheduleDate, approval, notes, disableComments, scheduledPause, or youTubeOptions). Notes: `id` plus at least one mutable field are required; other post fields cannot be changed — delete and repost instead.
- Validate MediaVerify a media URL is reachable and return its contentType. Use this before create_post whenever a post includes media to catch inaccessible URLs early. Notes: The check is a HEAD request — providers that block HEAD (e.g. some Cloudflare configurations) will return an error even…
- Validate PostDry-run validation for a post before publishing — same input shape as create_post. Notes: surfaces silent-failure classes (Instagram aspect ratio, Twitter media size, TikTok timing, duplicate content); the dedup hash is reported but NEVER written, so a real create_post seconds l…
Skills that use Ayrshare Tools
Related use cases
No verified related use cases are linked yet.