Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AYRSHARE_API_KEY | Yes | Your Ayrshare Primary Profile API key | |
| AYRSHARE_PROFILE_KEY | No | Default Profile Key for user profile operations (Business plan) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_post | Publish or schedule a social media post to one or more platforms. Supports text, images, videos, scheduling, and auto-scheduling. |
| get_post | Get details of a specific post by its Ayrshare Post ID. Returns status, content, platform-specific post IDs and URLs. |
| get_post_history | List post history with optional filters. Returns posts with their status, content, platforms, and scheduling info. |
| delete_post | Delete a post from social platforms. Can delete a single post, multiple posts in bulk, or all scheduled posts. |
| create_profile | Create a new user profile for managing separate social media accounts. Returns the profile key needed for subsequent operations. Requires Business plan. |
| list_profiles | List all user profiles with their linked social accounts. Supports filtering and pagination. Requires Business plan. |
| update_profile | Update an existing user profile's settings. Requires Business plan. |
| upload_media | Upload an image or video to Ayrshare's media library. Accepts either a public URL (which will be downloaded and uploaded) or base64-encoded data. Files are stored for 90 days. Max 30MB. Requires Premium plan. |
| post_comment | Post a comment on a social media post. Supports text and image comments across multiple platforms. Requires Premium plan. |
| get_comments | Get comments on a social media post. Can retrieve by Ayrshare Post ID, Social Post ID, or Social Comment ID. Requires Premium plan. |
| delete_comment | Delete a comment from a social media post. Uses the Social Comment ID from the platform. Supported on Facebook, Instagram, TikTok, X/Twitter, and YouTube. Requires Premium plan. |
| send_message | Send a direct message on a social platform. Supports text and media messages on Facebook, Instagram, and X/Twitter. Requires Business plan. |
| get_messages | Get messages and conversations from a social platform. Supports listing all conversations or getting a specific conversation's messages. Requires Business plan. |
| get_post_analytics | Get engagement analytics for a specific post (likes, views, shares, impressions, comments). Returns real-time metrics across all platforms the post was published to. Note: TikTok/YouTube can take 24-48h to update. Requires Premium plan. |
| get_social_analytics | Get account-level analytics for social profiles (follower count, demographics, impressions, engagement rates). Requires Premium plan. |
| set_auto_schedule | Create or update an auto-posting schedule with predefined times and days. Posts created with autoSchedule enabled will be queued to the next available time slot. Requires Premium plan. |
| list_auto_schedules | List all configured auto-posting schedules with their times, days, and last scheduled dates. Requires Premium plan. |
| delete_auto_schedule | Delete an auto-posting schedule by its title. Requires Premium plan. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |