Access, auth, and limits
Auth is an Ayrshare API key sent as a Bearer token, and because the server is stateless every call carries its own credentials rather than depending on a session established earlier. That is what makes it safe to drive from a serverless function or a cron job that may not live long enough to hold a connection.
The endpoint is api.ayrshare.com/mcp. Worth flagging if you set this up from an older note: the URL circulating in some directories is the documentation page at ayrshare.com/docs/mcp, which serves HTML and will fail in a client config. Ayrshare also publishes a Claude plugin repo on GitHub for clients that prefer a packaged install.
One thing TMB should have said sooner: this is not a cheap way to give an agent posting rights. Ayrshare prices per active social profile rather than per seat, starting at $149/month on Premium, $299 on Launch and from $599 on Business, with per-profile rates falling from $7.99 to $1.99 as you pass 500 profiles. MCP is not separately gated and rides the same API product, but "included at every tier" means something different here than it does at Buffer, where the entry point is free. Ayrshare is built for platforms embedding social publishing into their own product, and the pricing reflects that rather than solo use.
Where it works and what to build
Claude Code, Cursor and any custom agent connect the same way, over streamable HTTP with no session handling. Because MCP and REST share the same controllers, you can mix both freely: let an agent draft and validate over MCP, then publish from your own backend over REST, and the rate limits and validation behave identically.
The workflow worth building is the validation loop. Have the agent generate a post, run validate_post against every target network, repair whatever comes back, and only then publish. Platform rules differ enough between LinkedIn, X and TikTok that a single caption frequently passes on one and fails on another, and finding that out from a rejection after the fact costs you the slot. For platforms that require your own keys, such as X under the 2026 mandate, that is handled through the same profile layer.
Which AI clients can use Ayrshare MCP?
Not every AI assistant supports MCP natively. Per-client picture for Ayrshare:
| Client | Support | Notes |
|---|---|---|
| Claude Code | Native MCP | — |
| Cursor | Native MCP | — |
| n8n | Native MCP | — |
How to connect Ayrshare MCP to Claude Desktop
Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Cursor and Codex use a similar schema.
{
"mcpServers": {
"ayrshare": {
"command": "npx",
"args": ["mcp-remote", "<YOUR_MCP_URL>"]
}
}
}
// HTTP-transport MCP. Get your <YOUR_MCP_URL> from the vendor dashboard.
// Server source: https://api.ayrshare.com/mcp
// Claude Code (one-liner): claude mcp add ayrshare <YOUR_MCP_URL> --transport httpSome MCP servers require an API key. Check the source page for setup: api.ayrshare.com/mcp.
Does Ayrshare MCP cost extra?
Ayrshare ships an official MCP server that uses your existing subscription credentials.
- No separate MCP licence to buy. You pay for your Ayrshare plan, the MCP server queries that account.
- Whether it's gated to a specific tier wasn't extracted automatically — verify the access requirements on the MCP page or pricing docs.
Ayrshare also publishes a REST API
Ayrshare publishes an API, but per-tier gating wasn't extracted automatically.
What you can do with Ayrshare from an AI agent
Three shapes of agent workflow. Pick the row that matches how you actually use Claude / Cursor / Codex day to day.
Skip the dashboard, ask Claude
- "What changed this week?" answered in seconds
- Quick one-off questions without leaving the editor
- Pipe Ayrshare data into your personal notes / docs without writing a script
Run client analysis at agent speed
- Hand the MCP server to your team — every consultant can ask Claude about any client's Ayrshare account
- Multi-account workflows without context-switching the Ayrshare UI
- Reports you'd normally spend hours on, done before standup
Production agent workflows
- Embed in your internal Codex / Cursor agents that triage Ayrshare data daily
- Combine with other MCP servers in a multi-step agent chain
- Constrain agents to read-only roles to keep production Ayrshare safe
Limits and gotchas
- Official MCP server — published by Ayrshare themselves, so it should track product changes.
- Fallback: the REST API works for any flow the MCP server doesn't cover.
- Rate limits: MCP calls count against your underlying Ayrshare API quota. Burst usage from a curious agent can drain a daily allowance fast.
Agent-readiness verdict
The strongest social MCP I have looked at, and the pre-publish validation is why. Every tool call runs through the same authenticated, rate-limited, OpenAPI-validated controllers as the REST API, so an agent and your own code cannot drift apart.
Strong agent fit from an API-first company. Ayrshare runs an official action MCP server (api.ayrshare.com/mcp, 27 tools over streamable HTTP, key-authenticated) that drives the same API as REST, plus official Node, Python, and Flutter SDKs, webhooks with auto-retry, and a Claude Code plugin. So an agent can post, schedule, and read analytics across 13 networks either no-code over MCP or in code through a mature SDK. The one gap is a published OpenAPI spec, which it covers with a Postman collection instead.
Scored by Joonas (TMB).
Ayrshare MCP & API FAQ
Is the Ayrshare MCP server official?+
Can I use the Ayrshare MCP with Cursor or Codex?+
Does Ayrshare have a public API?+
Sources
- Ayrshare official site: https://www.ayrshare.com
- MCP server page: https://api.ayrshare.com/mcp
- API docs: https://www.ayrshare.com/docs/additional/mcp-action-server
Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.
10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.