Ayrshare Unofficial

An unofficial MCP server that executes Ayrshare API calls for posts, profiles, media, comments, messages, analytics, and auto-scheduling.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yardz-ayrshare-unofficial-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ayrshare-unofficial-mcp"
      ],
      "env": {
        "AYRSHARE_API_KEY": "YOUR_API_KEY",
        "AYRSHARE_PROFILE_KEY": "YOUR_PROFILE_KEY"
      }
    }
  }
}

You can run the Ayrshare Unofficial MCP Server to execute Ayrshare API calls through an MCP client. This server lets you publish posts, manage profiles, upload media, handle comments, send messages, view analytics, and configure auto-scheduling by making real API calls on your behalf, all via MCP commands.

How to use

Install or run one of the supported MCP configurations, then point your MCP client to the server using the provided command. You will supply your Ayrshare API key so the server can authenticate requests. Use the available tools to perform actions such as creating posts, updating profiles, uploading media, managing comments, sending messages, retrieving analytics, and setting up auto-scheduling.

How to install

Prerequisites you need before installing the MCP server:

Node.js 18.0.0 or newer
An Ayrshare account with an API Key

Install using npx (recommended)

{
  "mcpServers": {
    "ayrshare": {
      "command": "npx",
      "args": ["-y", "ayrshare-unofficial-mcp"],
      "env": {
        "AYRSHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Install using Claude Code

Use the Claude Code snippet to add Ayrshare MCP to your configuration by including the API key in the command. This shows how the MCP entry can be created through Claude’s MCP features.

claude mcp add ayrshare -e AYRSHARE_API_KEY=your-api-key-here -- npx -y ayrshare-unofficial-mcp

Build from source and run locally

If you prefer building from source, clone the project, install dependencies, and build. After building, run the local index to start the MCP server, supplying your API key.

git clone https://github.com/yardz/ayrshare-unofficial-mcp.git
cd ayrshare-unofficial-mcp
npm install
npm run build

Then configure your MCP client to start the built server locally using Node and the built index.

{
  "mcpServers": {
    "ayrshare": {
      "command": "node",
      "args": ["/absolute/path/to/ayrshare-unofficial-mcp/build/index.js"],
      "env": {
        "AYRSHARE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available tools

create_post

Publish or schedule a post to one or more platforms with optional media and scheduling.

get_post

Retrieve details for a specific post by its Ayrshare ID.

get_post_history

List post history with optional filters like platform, status, and time range.

delete_post

Delete a post or scheduled posts across platforms.

create_profile

Create a new user profile to manage multiple social accounts.

list_profiles

List all user profiles with their linked social accounts.

update_profile

Update an existing profile's settings.

upload_media

Upload an image or video to the media library.

post_comment

get_comments

Retrieve comments for a post.

delete_comment

Delete a comment from a post.

send_message

Send a direct message on a social platform.

get_messages

Retrieve messages and conversations from a platform.

get_post_analytics

Get engagement analytics for a specific post.

get_social_analytics

Get account-level analytics across platforms.

set_auto_schedule

Create or update an auto-posting schedule.

list_auto_schedules

List all configured auto-posting schedules.

delete_auto_schedule

Delete an auto-posting schedule by title.