--- title: "Ayrshare MCP server" url: "https://martechdb.com/vendors/ayrshare" markdown_url: "https://martechdb.com/vendors/ayrshare.md" api_url: "https://martechdb.com/api/v1/vendors/ayrshare.com" updated: "2026-10-28" --- # Ayrshare MCP server Yes. Ayrshare publishes an official MCP server at https://api.ayrshare.com/mcp. It's hosted. It offers 33 tools. We last checked it on 1 Nov 2026. MartechDB lists only servers the vendor publishes itself, never community servers. **Key facts:** As of 1 Nov 2026, Ayrshare's official MCP server scores 65/100 (provisional) on MartechDB's Agent Readiness Index (v1.1). It lists 33 tools. - Website: [ayrshare.com](https://ayrshare.com) - Categories: [Social media management](https://martechdb.com/categories/social-media-management.md) ## Review Ayrshare's Ayrshare MCP Server scores 65/100 on MartechDB's Agent Readiness Index: easy to connect an AI agent to, with a few gaps. The good: - Hosted by Ayrshare: connect by URL, with nothing to install - Documented, with 33 tools known Not checked yet: how you sign in; what agent access costs. ## Agent Readiness Index: 65/100 (provisional) How friendly Ayrshare is to AI agents, from its best official MCP server. Anything not yet researched scores nothing, so this score may rise once it is. Methodology v1.1: https://martechdb.com/methodology. - Official MCP server: 30/30 (Published by the vendor) - Hosted by the vendor: 25/25 (Connect by URL, nothing to install) - OAuth sign-in: pending (Sign-in: see vendor docs) - Documented tools: 10/10 (A docs page, and its tools are known) - Free to start, pay as you go: 0/15 (Not stated by the vendor) ## Ayrshare MCP Server - Address: https://api.ayrshare.com/mcp - Runs: Hosted - Sign-in: Sign-in: see vendor docs (`unknown`) - Official MCP Registry: not listed - Documentation: https://www.ayrshare.com/docs/additional/mcp-action-server - How we know it's official: Documented on Ayrshare's own site, at www.ayrshare.com - First seen: 2026-10-28 - Last checked: 2026-11-01 - Recent checks: 4 of the last 4 reachable ### Tools (33) As the server lists them on 2026-11-01. Names and descriptions come from the vendor's server. - `explain_error`: Look 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. Requires a valid API key (same authentication as every other tool). - `create_post`: Publish 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). - `get_post`: Retrieve 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. - `update_post`: Update 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. - `retry_post`: Re-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. - `validate_post`: Dry-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 later is not blocked. - `validate_media`: Verify 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 for valid files. Pair with validate\_post for a full pre-publish sweep. - `get_post_history`: List 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 that originated OUTSIDE Ayrshare, use get\_platform\_history instead. Requires a valid API key (same authentication as every other tool). - `get_platform_history`: Fetch 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/Twitter) require API key only, no Profile-Key; skipAnalytics speeds up high-limit requests; use get\_post\_history for Ayrshare-originated posts. Requires a valid API key (same authentication as every other tool). - `get_post_analytics`: Get 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, use get\_post\_analytics\_by\_social\_id. Requires a valid API key (same authentication as every other tool). - `get_post_analytics_by_social_id`: Get 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 through Ayrshare where you have the Ayrshare Post ID, use get\_post\_analytics instead. Requires a valid API key (same authentication as every other tool). - `get_social_network_analytics`: Account-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 demographics need \>=100 engagements in 30 days; LinkedIn/TikTok may lag 24-48 h. userId/userName (X/Twitter) look up a specific user and must use the account API key only, with no profileKey. This is NOT analytics about an Ayrshare User Profile — for profiles use list\_profiles. Requires a valid API key (same authentication as every other tool). - `get_comments`: Read 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 to the most recent 1,000 comments. - `add_comment`: Add 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 on the first Tweet. - `reply_comment`: Reply to a comment using an Ayrshare Comment ID or Social Comment ID. Notes: When \`searchPlatformId\` is true, \`platforms\` must contain exactly one entry. \`commentUrn\` is required for LinkedIn Social Comment ID replies. \`videoId\` is required for TikTok Social Comment ID replies. \`mediaUrls\` supports one image URL on Facebook and LinkedIn only. Reddit is not supported for comment replies. - `get_messages`: Fetch direct messages or conversations for one messaging platform (facebook, instagram, whatsapp, twitter). Notes: responses are cached for 60 s, or 15 s on X/Twitter. Use conversationsOnly to list thread summaries, conversationId to scope to one thread, and limit + next for pagination. Every platform returns a bounded page of at most 100 messages or conversations with a meta.pagination cursor; follow next while hasMore is true. - `send_message`: Send 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 window. - `get_auto_response`: Return 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. - `set_auto_response`: Configure the account's direct-message auto-response (account-level, not platform-scoped). Notes: At least one of autoResponseActive, autoResponseMessage, or autoResponseWaitSeconds is required. Do NOT send autoResponseMessage as "": it does not reset the message. Sent alone the API returns code 101, and sent with another field it is silently ignored. Send the default text explicitly instead. To read the current settings use get\_auto\_response. - `list_profiles`: List 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. Requires a valid API key (same authentication as every other tool). - `create_profile`: Create 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). Notes: To invite a team member set \`team: true\` and supply \`email\`. Use \`disableSocial\` to block specific networks for this profile. Requires a valid API key (same authentication as every other tool). - `generate_jwt_social_linking_url`: Generate 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 returns a hosted linking page URL you hand to the end user, who opens it in a browser to OAuth their individual social accounts. Authentication: pass your account API key as \`Authorization: Bearer \\` and the TARGET sub-profile's key either as the \`profileKey\` argument or the \`Profile-Key\` header (the argument takes precedence). That Profile Key is REQUIRED and identifies whose linking page the URL opens. You do NOT supply a private key or a domain: nothing is signed, and the server resolves the account's own onboarding domain, so nothing secret enters the conversation. What you get back: \`token\` is an OPAQUE link-session token (not a JWT — do not try to decode it), and \`url\` carries it as \`?session=\\`. Th… - `generate_post`: Generate 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: \`hashtags\` defaults to true. Token usage is returned in the response. - `recommend_hashtags`: Get 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 include hashtags) rather than this tool. - `register_webhook`: Register 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. - `unregister_webhook`: Remove 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. - `list_webhooks`: List 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 manage subscriptions. - `list_ad_accounts`: List the ad accounts the linked account on this platform can spend from. Use the accountId values returned wherever an ads tool asks for accountId. Requires the Ads add-on; without it the call returns Error 403 (code 399). - `search_ad_targeting`: Search the platform's targeting options before boosting a post. kind 'interests' returns interest ids for audience targeting (search is required); 'regions' and 'cities' return location keys for geographic targeting. Each kind takes only its own arguments, marked in their descriptions. Requires the Ads add-on. - `list_ads`: List boosted ads, filtered by campaign, account, ad or post. At least one of campaignId, accountId, adId, postId or socialPostId is required. status only reliably filters post lookups, so check each ad's status in the result. Requires the Ads add-on. - `update_ad`: Change a boosted ad's state. This controls real ad spend: status PAUSED stops spending, ACTIVE resumes it, DELETED or ARCHIVED retires the ad. The same status is also set on the ad's ad set and campaign, so other ads in that ad set or campaign change with it, except a campaign or ad set the boost was attached to with attachTo, which keeps its own status. The ad runs only while the campaign and ad set above it are active. Use it when an ad is costing more than intended. Get adId from list\_ads. Requires the Ads add-on. - `get_ad_history`: Spend and performance history for boosted ads over a date window. Use it to see what an ad has actually cost. Requires the Ads add-on. - `boost_post`: Boost a published post as an ad. This spends real money from the ad account. Unless you say otherwise, the ad is active, starts now and has no end date: set status paused or schedule.end to limit it. Give schedule dates as ISO 8601 date-times, such as 2026-10-10T09:00:00Z. Supply postId (the Ayrshare post id) or socialPostId (the network's own id), and accountId from list\_ad\_accounts. Settings only one platform has go under platformOptions, keyed by platform. On facebook and instagram, platformOptions.\.adName and .bidAmount are required, for example { "facebook": { "adName": "Autumn sale", "bidAmount": 2 } }. With attachTo.adSetId, leave out budget, targeting and bidAmount: the existing ad set keeps its own. Send a new idempotencyKey (such as a UUID) with each boost, and retry with the same key and arguments: a retry returns the first response instead of paying for a second ad, or Error 409 while the first is still in progress; never retry with a new key. Use update\_ad with… ### Connect it Claude Code: ```sh claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp ``` - Add to Cursor: - Add to VS Code: - Claude.ai and Claude Desktop: Customize, Connectors, "+", Add custom connector, then paste https://api.ayrshare.com/mcp - ChatGPT: Settings, Apps, Advanced settings, turn on Developer mode, Create, then paste https://api.ayrshare.com/mcp (this usually works only with servers that use self-serve sign-in or none) JSON for Cursor, Windsurf and other clients that connect to hosted servers: ```json { "mcpServers": { "ayrshare": { "type": "http", "url": "https://api.ayrshare.com/mcp" } } } ``` ## Questions ### Does Ayrshare have an official MCP server? Yes. Ayrshare publishes its MCP server itself. Ayrshare's own documentation describes it. MartechDB only lists servers a vendor publishes, never community copies. ### What is the Ayrshare MCP server URL? The address is https://api.ayrshare.com/mcp. ### How do I connect Ayrshare MCP to Claude, ChatGPT or Cursor? In Claude, add https://api.ayrshare.com/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp ### What can the Ayrshare MCP server do? It offers 33 tools, including explain\_error, create\_post, get\_post, update\_post and retry\_post (as listed on 1 Nov 2026). ### Is the Ayrshare MCP server in the official MCP Registry? No. Ayrshare hasn't published it to the official MCP Registry. ### Is the Ayrshare MCP server working? Yes. It answered our most recent check. We last checked it on 1 Nov 2026. ### What are the alternatives to Ayrshare's MCP server? In Social media management, the most agent-friendly alternatives with an official MCP server are ContentStudio (100/100), SocialChamp (98/100), Buffer (95/100), Taplio (95/100) and Brandwise (95/100). Ayrshare scores 65/100 on the same index. ## Change history - 2026-10-28: Added to MartechDB with Ayrshare MCP Server ## Alternatives to Ayrshare's MCP server In Social media management, the most agent-friendly first: - [ContentStudio](https://martechdb.com/vendors/contentstudio.md) (contentstudio.io), Agent Readiness Index 100/100 - [SocialChamp](https://martechdb.com/vendors/socialchamp.md) (socialchamp.com), Agent Readiness Index 98/100 - [Buffer](https://martechdb.com/vendors/buffer.md) (buffer.com), Agent Readiness Index 95/100 - [Taplio](https://martechdb.com/vendors/taplio.md) (taplio.com), Agent Readiness Index 95/100 - [Brandwise](https://martechdb.com/vendors/brandwise.md) (brandwise.ai), Agent Readiness Index 95/100 ## Get this data - API: `curl https://martechdb.com/api/v1/vendors/ayrshare.com` - MCP: `claude mcp add --transport http martechdb https://martechdb.com/mcp`, then ask about Ayrshare. - Web page: https://martechdb.com/vendors/ayrshare