otherapi_key

Ayrshare

Ayrshare provides a Social Media API that enables developers to programmatically manage and automate social media posts, analytics, and interactions across multiple platforms.

Verdict

Ayrshare lets your team schedule and manage social media posts across platforms from inside Switchy. @mention it to queue content to multiple networks at once, retrieve performance metrics on past posts, or set up recurring posting schedules. Marketing teams use it to coordinate campaigns without leaving the AI workspace. Designers and copywriters can draft, schedule, and track posts in the same Space where they collaborate. Note that deleting published Instagram and TikTok posts isn't supported by the platform itself — only scheduled or draft posts can be removed.

Common use cases

  • Schedule campaign posts across all channels
  • Review last week's social performance metrics
  • Set up recurring Monday morning announcements
  • Delete a scheduled post before it goes live
  • Queue product launch content in one batch

Integration

Vendor
Ayrshare
Category
other
Auth
API_KEY
Tools
4
Composio slug
ayrshare

Tools

  • Create Auto Schedule

    Tool to create a new auto-post schedule with specified times and optional weekday filters. use when setting up recurring posting plans.

  • Delete a previously published Ayrshare post
    destructive

    Tool to delete an ayrshare post. use when you need to remove a published or scheduled post by its ayrshare post id, after confirming the correct id. note: instagram and tiktok published posts cannot be deleted via api; set `mark manual dele

  • Get Post History

    Tool to retrieve ayrshare post history with metrics. use when you need to fetch and filter past posts by date, status, or record count.

  • Set Auto Schedule

    Tool to set up an auto-post schedule with specified times and optional weekday filters. use when scheduling posts around a recurring pattern.

Setup

Setup guide

  1. 11. In Switchy, open Settings and navigate to the MCP Integrations tab. 2. Click 'Add Integration' and select Ayrshare from the list. 3. You'll be prompted to enter an Ayrshare API key — generate one by logging into your Ayrshare dashboard, navigating to API Keys under your account settings, and copying the key. 4. Paste the key into Switchy and click 'Connect'. 5. Switchy will verify the key and confirm the connection. 6. To test it, open any Space and type '@Ayrshare get post history from the last 7 days' — you should see a list of recent posts with engagement metrics. 7. From there, you can schedule new posts, set up recurring schedules, or delete queued content by referencing the post ID returned in the history.

What teammates see: by default, memories from Ayrshare are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Review Recent Posts

@Ayrshare get post history from the last 30 days. Show me the top 5 posts by engagement and flag any that got zero clicks.
Open in a Space →

Schedule Campaign Launch

@Ayrshare schedule these three posts: one for Twitter at 9am tomorrow, one for LinkedIn at 11am, and one for Facebook at 2pm. Use the copy I pasted above.
Open in a Space →

Set Weekly Reminder

@Ayrshare set up an auto schedule to post 'Weekly team update' every Monday at 8am Pacific. Apply it to Twitter and LinkedIn.
Open in a Space →

Delete Queued Post

@Ayrshare delete the post with ID abc123. Confirm it's the one scheduled for tomorrow at 3pm before removing it.
Open in a Space →

Audit Last Quarter

@Ayrshare get post history from January 1 to March 31. Group results by platform and show average engagement per post.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Ayrshare show me the last 10 posts we published across all platforms, including engagement metrics for each one.

Output

Retrieved 10 recent posts from your Ayrshare history. The most recent post (LinkedIn, published 2 days ago) received 47 likes and 3 comments. Your Twitter thread from last week got 12 retweets and 89 likes. Instagram carousel from 5 days ago shows 203 likes, 18 comments. The data includes post IDs, platforms, timestamps, and engagement counts for each entry. Note that metrics refresh on different schedules per platform—LinkedIn and Twitter update hourly, Instagram every 6 hours.

Notes

This example demonstrates the read capability for post history and metrics. Requires API key with read permissions. Engagement data lags behind real-time by platform-specific intervals. The MCP returns structured data that the AI can summarize or compare across time periods.

Prompt

@Ayrshare delete the post with ID 'ayr_post_12345' that we scheduled for tomorrow—we're pivoting the campaign direction.

Output

Successfully deleted post ID 'ayr_post_12345' from your Ayrshare schedule. This post was queued for LinkedIn and Twitter, scheduled for tomorrow at 10:00 AM EST. The content has been removed from both platforms' queues. Note: if this were a published Instagram or TikTok post, deletion would not be possible due to platform API restrictions—only scheduled posts can be removed from those networks.

Notes

This write-action example shows the deletion tool in practice. Critical limitation: Instagram and TikTok published posts cannot be deleted via API, only scheduled ones. Always verify the post ID before deletion—there's no undo. Requires API key with write permissions. Use this when campaign priorities shift or content needs last-minute changes.

Prompt

@Ayrshare set up an auto-schedule to post every weekday at 9 AM and 3 PM EST, skipping weekends entirely.

Output

Created a new auto-post schedule in Ayrshare with two daily time slots: 09:00 and 15:00 EST, active Monday through Friday only. This schedule will now govern when queued posts go live across your connected platforms. Any posts added to your Ayrshare queue without explicit timestamps will automatically publish at the next available slot in this pattern. You can modify or delete this schedule later if posting cadence needs adjustment.

Notes

This synthesis example pairs the MCP's scheduling tool with strategic planning. The auto-schedule feature is powerful but requires understanding the queue model—posts without explicit times inherit the schedule. Weekday filtering is optional; omitting it posts 7 days a week. Requires API key with schedule-management permissions. Useful for teams maintaining consistent posting rhythms without manual timestamp entry.

Use-case deep-dives

Weekly content calendar for consultants

When Ayrshare fits solo consultants posting 3-5x per week

A solo consultant or 2-person agency posting LinkedIn updates three times a week can use Ayrshare's auto-schedule tools to batch-write content on Mondays and let the MCP handle the rest. The four-tool scope is narrow—create schedule, set times, pull history, delete posts—but that's enough if your workflow is "write five posts, queue them for Tuesday/Thursday/Saturday at 9am, check metrics Friday". The API key auth means anyone on the team can run the same prompts without OAuth friction. This breaks down when you need platform-specific previews, A/B testing, or approval workflows; Ayrshare doesn't surface those levers in the MCP. If you're posting daily or managing clients across six platforms, you'll hit the tool ceiling fast. For the consultant posting a few times a week to one or two channels, it's a clean fit.

Post-mortem analysis for campaign teams

Using post history to audit what actually shipped

A three-person growth team running a product launch wants to pull every post published in the last 30 days and compare planned vs. actual timing. The "Get Post History" tool filters by date range and status, so you can ask the MCP "show me all posts that went live between March 1 and March 15" and get metrics in one query. This is faster than logging into Ayrshare's dashboard if you're already working in Switchy and want to paste the output into a retro doc. The limit: you can't edit posts or reschedule them through the MCP, only view and delete. If your retro uncovers a mistake, you'll delete the bad post via MCP and recreate it manually. That's fine for a monthly audit; it's clunky if you're doing daily QA. Use this when you need read-heavy reporting, not real-time campaign management.

Event promotion cleanup for nonprofits

When bulk deletion saves time after a fundraiser ends

A four-person nonprofit team promoted a fundraising event with 12 scheduled posts across Facebook, LinkedIn, and Twitter. The event ended early, and now they need to cancel the remaining posts before they go live. The "Delete a previously published Ayrshare post" tool lets you remove posts by ID, so you can ask the MCP "delete all scheduled posts with 'fundraiser' in the title" if you've already pulled the history. The catch: Instagram and TikTok posts can't be deleted once published, per Ayrshare's API limits, so this only works for pre-publish cleanup or platforms that allow retroactive deletion. If your event calendar changes weekly and you're constantly rescheduling, the lack of an "edit post" tool will frustrate you. For the nonprofit that runs three big campaigns a year and needs fast teardown after each, it's a time-saver.

Frequently asked

What does the Ayrshare MCP do in Switchy?

It lets your team schedule, publish, and delete social media posts across multiple platforms through Ayrshare's API. You can set up recurring auto-post schedules, retrieve post history with engagement metrics, and manage published content. Think of it as programmatic control over your Ayrshare account without opening their dashboard.

Do I need an Ayrshare API key to connect this MCP?

Yes. This MCP uses API key authentication, so you'll need an active Ayrshare account and a valid API key from their settings. Whoever connects it in Switchy needs access to that key — typically your social media manager or whoever runs your Ayrshare account. No OAuth flow; just paste the key during setup.

Can the Ayrshare MCP delete posts after they're published?

Mostly. You can delete scheduled posts and most published posts using the post ID Ayrshare assigns. The exception: Instagram and TikTok published posts can't be deleted through the API due to platform restrictions. For those, you'll still need to remove them manually in the native apps or Ayrshare dashboard.

How is this different from just using Ayrshare's web app?

The MCP is for automation and bulk operations. If you're manually scheduling five posts a week, use Ayrshare's UI. If you're building workflows that auto-schedule content based on triggers, pull analytics into reports, or let AI agents manage posting cadence, the MCP saves you from clicking through their interface repeatedly.

Who on my team should connect the Ayrshare MCP?

Whoever already manages your Ayrshare account and has the API key. That's usually your social media lead or marketing ops person. They'll need to trust Switchy with posting permissions, so make sure they understand the MCP can publish and delete content on your connected social accounts through Ayrshare.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.