get_post_history
Get Post History
Retrieve the history and status of posts sent via Ayrshare. Filter by platform, date range, status, or type. Returns detailed metadata for each post including content, platforms, status, and engagement URLs.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_post_history
Retrieve the history and status of posts sent via Ayrshare. Filter by platform, date range, status, or type. Returns detailed metadata for each post including content, platforms, status, and engagement URLs.
delete_feed
Remove an RSS feed subscription to stop auto-publishing from that feed.
get_messages
Retrieve direct message conversations from Facebook, Instagram, or X/Twitter. Can list all conversations or fetch messages from a specific conversation.
get_feeds
List all RSS feed subscriptions configured for the account.
post_comment
Post a new comment on a social media post. Supports posting to multiple platforms simultaneously and optionally includes an image attachment.
send_message
Send a direct message on Facebook, Instagram, or X/Twitter. Supports text messages and media attachments (images, videos, voice files).
create_post
Publish or schedule a post to one or multiple social networks simultaneously. Supports text, images, and video content. Posts can be sent immediately or scheduled for a future date. Supports platform-specific options, auto-hashtag generation, link shortening, and auto-reposting.
get_profiles
List user profiles with optional filtering by title, reference ID, or active social accounts. Supports pagination for large profile lists. Requires Business plan.
upload_media
Upload an image or video file to Ayrshare's media hosting. Returns a publicly accessible URL that can be used in post creation. Accepts Base64 Data URI encoded files.
add_feed
Subscribe to an RSS feed to automatically post new items to social networks. New feed items are detected and published to the specified platforms.
delete_post
Delete one or more posts from social networks. Supports deleting a single post by ID, bulk deletion of multiple posts, or clearing all scheduled posts.
get_comments
Retrieve comments on a post. Supports looking up by Ayrshare Post ID, Social Post ID, or Social Comment ID. Returns comment text, author, timestamps, like counts, and replies.
create_profile
Create a new user profile for managing social media accounts on behalf of a client. Returns a profile key that must be stored securely — it cannot be retrieved again via API. Requires Business plan.
get_post_analytics
Retrieve engagement analytics for a specific post across platforms. Returns metrics such as likes, comments, shares, impressions, reach, and platform-specific engagement data.
delete_profile
Permanently delete a user profile and all associated posts. This action is irreversible. Requires Business plan.
get_reviews
Retrieve reviews from Facebook Pages or Google Business Profile. Returns review text, ratings, reviewer info, and reply data.
delete_comment
Delete a comment from social media posts across specified platforms.
update_post
Update a scheduled or pending post. Can approve posts that require approval, update the schedule date, or pause/unpause scheduled posts.
generate_hashtags
Automatically generate and add relevant hashtags to post text using AI. Takes into account real-time hashtag popularity. Returns the post text with hashtags added.
get_social_analytics
Retrieve account-level analytics for linked social media accounts. Returns metrics like follower counts, impressions, engagement rates, and demographic breakdowns. Supports daily time-series data and quarterly aggregation.
validate_post
Validate post content before publishing. Runs technical and content checks and returns detailed error messages on how to correct any issues. Use this to verify content, character limits, and media compatibility before creating a post.
get_current_user
Get the current Ayrshare profile identity and its linked social accounts. Uses the configured user profile when a Profile Key is set.
retry_post
Request a retry for a failed post. Ayrshare queues the retry and returns a pending status; check get_post_history_by_id for the final result.
get_post_history_by_id
Retrieve one post by its Ayrshare Post ID, including publication status, social post IDs, URLs, errors, and scheduling details. Use this to check a scheduled or retried post.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Publish, schedule, and manage social media posts across 13 networks through Ayrshare. Check post history and publication status, retry failed posts, retrieve post and account analytics, retrieve, post, and delete comments, send and retrieve direct messages on Facebook, Instagram, and X/Twitter, and read reviews from Facebook Pages and Google Business Profile. Upload and host media, generate hashtags, shorten post links, and validate content before publishing. Manage user profiles and RSS feed subscriptions, and discover the current profile and its linked social accounts.
Common questions about connecting Ayrshare to AI agents with Metorial.