The full Social Loop, inside your AI Agents
Ayrshare is the social media API for AI agents: your agent learns a brand's voice, validates every post against each platform's rules, and publishes across 13+ networks in one call.
13+
networks, one call
30M+
API calls per day
27
MCP tools
Every post
validated before it ships
13+
networks, one call
30M+
API calls per day
27
MCP tools
Every post
validated before it ships
Publishing is where your agents often break
An agent can write a solid post in seconds. Publishing it is the part that breaks: each platform sets different limits on length, media, and formatting, and one wrong field can fail the post or ship it malformed. Ayrshare publishes across 13+ networks and keeps up with the rules, so your agent doesn't have to.
Four things an agent does, in one API
Posting is one piece. Ayrshare gives an agent the whole loop, and the two stages that make it safe to run on its own are learning from a brand's history and validating before publish.
one API
Learn
Act
Observe
Stay safe
Learn
HISTORY APIPull a brand's post history to match its voice from the first draft, and see what performed.
Act
Publish and schedule across 13+ networks in a single call.
Observe
Read back live analytics to see what worked, then feed it into the next post.
Stay Safe
VALIDATIONValidate every post against each platform's rules and confirm before anything goes live. The agent proposes, you approve.
Each profile includes
Posting & scheduling
Analytics & performance data
Moderation (comments, DMs, reviews)
An agent that learns the brand and validates every post
Learn from real post history
Your agent pulls a brand's full posting history to match its voice from the first draft and see what actually performed, instead of guessing.
Validation before publishing
Ayrshare checks a post against the target platform's rules and tells your agent what is wrong while it can still fix it. You can also call our Validation endpoint for pre-post content moderation, protecting your users from getting downranked or suspended. For platforms that require your own keys, like X under the 2026 mandate, that is handled too.
Multi-Tenant architecture
One API key, with an optional Profile-Key to scope any call to a specific managed account. Post on behalf of thousands of profiles, not just one brand.
From a single agent to thousands of client accounts
The same API backs a solo project and a multi-tenant platform. Three common builds:
Posting Inside Your AI Product
Give your users an agent that publishes to their own social accounts, with validation and approval built in, instead of maintaining a dozen platform integrations yourself.
An AI Social Media Manager
An agent that learns each client's voice from their history, drafts in-brand, validates, and schedules across networks, with a human approving before anything ships.
Client Onboarding at Volume
Mint social-linking URLs so each client connects their own accounts under a sub-profile, then scope every call to that client with a Profile-Key.
Connect Any MCP Client, or Call the REST API Directly
The MCP Server is hosted at https://api.ayrshare.com/mcp over Streamable HTTP, and it's stateless, so there's no session to manage. Claude Code, Cursor, or your own agent all connect the same way.
Every tool call runs through the same chain as the REST API:
Authenticates your API key.
Enforces your plan's rate limits and quota.
Validates each request against the OpenAPI spec.
Runs the same controllers that serve REST.
Same data, same rules, nothing new to learn or maintain.
# The REST call the MCP post tool runs underneathcurl -X POST https://api.ayrshare.com/api/post \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Profile-Key: CLIENT_PROFILE_KEY" \ -H "Content-Type: application/json" \ -d '{ "post": "Launch day. The API is live.", "platforms": ["linkedin", "x"] }'
27 tools, grouped by domain
Publishing
Post and schedule across 13+ networks.
Validation
Check a post against platform rules first.
History
Pull past posts to learn a brand's voice.
Analytics
Read back engagement and reach to see what worked.
Comments
Read and reply to comments.
Messages
Handle direct messages.
Profiles
Create and manage client profiles.
Media
Upload and reuse images and video.
Full list in the Tool Catalog.
Two Commands From Install to Published
Install the plugin, connect your key, and drive it in plain language. No per-platform branching on your side.
# 1. install the plugin$ claude plugin install github:ayrshare/ayrshare-social-media-api-claude-plugin # 2. connect your Ayrshare API key$ /ayrshare:setup ✓ Connected. Restart Claude Code to activate. # then just ask› draft a launch post in our brand voice, validate it, and publish to LinkedIn and X ✓ Matched voice from history · validated 2 platforms ✓ Published. Approve before send: on
One Command
Connect or rotate your API key, scoped global, local, or shared with your team.
Two Specialized Agents
social-manager and profile-manager drive publishing, scheduling, analytics, and client profiles in plain language.
Intent-Based Skills
Activate automatically, even when you don't name Ayrshare, and teach the agent the auth model, retry safety, and platform quirks.
The Full MCP Surface
Posting, history, analytics, comments, messages, profiles, media, generation, webhooks, and errors.
SAFE BY DEFAULT. The plugin validates and asks for confirmation before publishing. Your agent drafts, you approve. Nothing goes live that a network would reject.
FAQs about Ayrshare for AI Agents
Ayrshare is the social media API layer your agent calls to publish. Your agent handles the language; Ayrshare handles posting, scheduling, validation, history, and analytics across 13+ networks through one integration, so you never maintain a separate connection for each platform.
Before anything publishes, Ayrshare checks each post against the target platform's rules — length, media, and formatting limits — and tells your agent what is wrong while it can still fix it. You can also call the Validation endpoint for pre-post content moderation, so a user never gets downranked or suspended for a malformed or non-compliant post.
Yes. The History API pulls a brand's past posts across networks so your agent can match its voice from the first draft and see what actually performed, instead of guessing.
Either. The hosted MCP Server at https://api.ayrshare.com/mcp lets Claude Code, Cursor, or your own agent connect over Streamable HTTP with no session to manage. Every MCP tool call runs through the same authenticated, rate-limited, OpenAPI-validated controllers as the REST API, so you can mix both freely.
One API key plus an optional Profile-Key scopes any call to a specific managed account. Mint a social-linking URL so each client connects their own accounts under a sub-profile, then pass that client's Profile-Key on every request. The multi-tenant Business Plan is proven at 30M+ API calls a day.
By default the plugin validates and asks for confirmation before publishing — the agent drafts, you approve, and nothing goes live that a network would reject. You stay in control of what ships.
Give your Agent the Social Loop
AI content platforms are among Ayrshare's top customers. Start with two commands.