DOCS BLOG ABOUT TRY THE GATEWAY

// MCP TOOL REFERENCE

MCP SOCIALAPI TOOLS

75 tools from the Mcp Socialapi MCP Server, categorised by risk level.

View the Mcp Socialapi policy → Token cost: 11,590 tokens →

// ALL 75 MCP SOCIALAPI TOOLS

READ 39 tools

Read social_api_events_summary Get aggregated event counts for a time window. Returns total events, failure count broken down by error cat... Read social_api_exchange_oauth Complete an OAuth2 account connection by exchanging the authorization code received after the user authoriz... Read social_api_get_account_limits Get platform-specific API usage limits and quotas for a connected account, as reported by the platform itse... Read social_api_get_comment_replies List replies to a specific comment. The interaction_id must be a comment ID starting with sapi_cmt_ (from s... Read social_api_get_constraints Get platform-specific content constraints for post creation. Returns per-platform limits including max text... Read social_api_get_conversation Get details for a single DM conversation including participant info, unread count, status (active/archived)... Read social_api_get_creator_info Fetch creator-facing profile details for a connected account: display name, username, profile picture, bio,... Read social_api_get_export Get the status and result of an analytics export. Returns status (pending, processing, completed, failed), ... Read social_api_get_export_videos Get the cached video data from a completed analytics export. Returns the full video array with per-video an... Read social_api_get_me Get the authenticated user's profile. Returns id (UUID), email, plan tier (free, starter, pro, business, or... Read social_api_get_media_upload_url Get a presigned S3-compatible URL for uploading a media file to attach to a post. Provide the MIME type (e.... Read social_api_get_mentions List brand mentions and tags for a connected account -- posts by other users that mention or tag your accou... Read social_api_get_post Get full details for a single post including text, status, scheduled/published timestamps, per-platform del... Read social_api_get_post_metrics Fetch live engagement metrics for a published post from each target platform. Returns per-platform metrics ... Read social_api_get_reviews List reviews across connected accounts (applicable to Google Business, Trustpilot, and similar review platf... Read social_api_get_storage_usage Get storage usage and quota for the authenticated user's media library. Returns used_bytes, limit_bytes (-1... Read social_api_get_usage Get resource usage for the current billing period. Returns counts and limits for brands (brand slots), post... Read social_api_get_webhook Get details for a single webhook endpoint including URL, subscribed events, is_active status, a secret hint... Read social_api_get_webhook_delivery Get full details of a single webhook delivery attempt: request payload, response body, response headers, HT... Read social_api_list_account_pages List pages (e.g. Facebook Pages) for a connected account. Returns page IDs, names, default/active status. U... Read social_api_list_accounts List all connected social media accounts for the authenticated user. Returns account details including plat... Read social_api_list_brands List all brands for the authenticated user. Each brand groups social accounts for one business, client, or ... Read social_api_list_conversations List inbox DM conversations for the authenticated user, sorted by most recently active. Optionally filter b... Read social_api_list_events List developer events (unified activity log). Filter by category (post, webhook, inbox, api, account), stat... Read social_api_list_exports List the 50 most recent analytics exports for the authenticated user, newest first. Optionally filter by st... Read social_api_list_inbox_posts List inbox posts (posts that have received comments) for the authenticated user. Optionally filter by accou... Read social_api_list_invites List all platform invites for a brand, ordered by creation date (newest first). Returns both active and exp... Read social_api_list_keys List all API keys for the authenticated user. Returns key metadata including id, name, preview (first chara... Read social_api_list_media List uploaded media files in the user's media library. Returns media objects with id, filename, content_typ... Read social_api_list_messages List messages in a DM conversation, sorted newest first. The conversation_id comes from social_api_list_con... Read social_api_list_post_comments List comments for a specific inbox post, sorted oldest-first. The inbox_post_id comes from social_api_list_... Read social_api_list_posts List all posts (drafts, scheduled, published, failed) with rich filtering. Supports filtering by status, pl... Read social_api_list_webhook_deliveries List recent delivery attempts for a webhook endpoint. Each delivery includes id, event_type, status (pendin... Read social_api_list_webhooks List all registered webhook endpoints for the authenticated user. Returns endpoint details including id, ur... Read social_api_reply_to_review Reply to a review as the business. The reply appears publicly as the business response. Requires account_id... Read social_api_retry_webhook_delivery Manually retry a failed webhook delivery. Re-sends the original payload to the endpoint URL with a fresh at... Read social_api_test_webhook Send a test event to a webhook endpoint to verify it is reachable and correctly configured. Takes an event_... Read social_api_validate_post Validate post content against platform-specific constraints before creating a post. Checks text length, med... Read social_api_verify_media_upload Confirm that a media file was successfully uploaded to the presigned URL. Call this after uploading the fil...

WRITE 24 tools

Write social_api_connect_account Initiate connecting a new social media account. For OAuth2 platforms (instagram, facebook) returns an auth_... Write social_api_create_brand Create a new brand to group social accounts for a business, client, or project. Each brand can connect one ... Write social_api_create_export Create an analytics export for a connected account. Enqueues an async job that collects post data, engageme... Write social_api_create_invite Create a platform invite link for a brand. The invite allows someone to connect a social media account to t... Write social_api_create_key Generate a new API key (prefixed sapi_key_) for programmatic API access. The raw key is returned exactly on... Write social_api_create_post Create or schedule a post to one or more connected social media accounts. Omit targets and scheduled_at to ... Write social_api_create_webhook Register a new webhook endpoint to receive real-time event notifications. The URL must be HTTPS. Specify wh... Write social_api_hide_comment Hide a comment from public view on the platform. The comment remains in the database but is marked hidden. ... Write social_api_like_comment Like a comment on behalf of the connected account. Supported on Facebook and Twitter. Returns 501 for platf... Write social_api_mark_conversation_read Mark all messages in a conversation as read, resetting the unread count to zero. Idempotent -- calling on a... Write social_api_patch_me Update the authenticated user's profile. Currently only supports marking onboarding complete by setting onb... Write social_api_private_reply_to_comment Send a private reply (DM) in response to a comment, visible only to the commenter. Max 1000 characters. Con... Write social_api_reply_to_comment Reply publicly to a post or a specific comment. Provide account_id and post_id; optionally also comment_id ... Write social_api_retry_post Retry publishing a post that previously failed. Only posts in 'failed' or 'partial' status can be retried -... Write social_api_send_dm Send a direct message in an existing inbox conversation. The conversation_id comes from social_api_list_con... Write social_api_send_feedback Send feedback to the SocialAPI team. Use when a user wants to report a bug, request a feature, or share gen... Write social_api_unhide_comment Restore a previously hidden comment to public view. Supported on Instagram, Facebook, and Threads. Write social_api_unlike_comment Remove a like from a comment previously liked by the connected account. Supported on Facebook and Twitter. ... Write social_api_update_account_page Update a page's default or active status for a connected account. Set is_default=true to make this the defa... Write social_api_update_brand Rename a brand. Only the name can be changed; connected accounts are not affected. Idempotent -- setting th... Write social_api_update_conversation Update a conversation's status. Set status to 'archived' to move it out of the active inbox, or 'active' to... Write social_api_update_post Update the content of a draft, scheduled, or failed post. Only posts in 'draft', 'scheduled', or 'failed' s... Write social_api_update_review_reply Update an existing business reply to a review. Requires account_id and the platform review_id. Max 2200 cha... Write social_api_update_webhook Update an existing webhook endpoint. Change the URL, subscribed event types, or enable/disable it (is_activ...

DESTRUCTIVE 12 tools

Destructive social_api_delete_brand Delete a brand and disconnect all its connected social accounts. This is irreversible. Destructive social_api_delete_comment Permanently delete a comment from the platform and remove it from the inbox database. This action is irreve... Destructive social_api_delete_me Permanently delete the authenticated user account and ALL associated data including API keys, connected soc... Destructive social_api_delete_media Permanently delete a media file from the media library and object storage. This is irreversible. If the med... Destructive social_api_delete_post Delete a published post from the social media platform, or cancel a scheduled/failed post before it is publ... Destructive social_api_delete_review_reply Delete a business reply to a review. Requires account_id and the platform review_id. Supported on Google Bu... Destructive social_api_delete_webhook Permanently delete a webhook endpoint. Future events will no longer be delivered to this URL. Any in-flight... Destructive social_api_disconnect_account Disconnect a connected social media account. Removes the stored OAuth tokens and disassociates the account ... Destructive social_api_moderate_comment Moderate a comment by hiding, unhiding, or deleting it. The interaction_id must be a comment ID starting wi... Destructive social_api_revoke_invite Revoke an active platform invite, making the invite URL immediately invalid. This is irreversible. Use soci... Destructive social_api_revoke_key Permanently deactivate an API key. This is irreversible -- the key immediately stops working for all API re... Destructive social_api_unpublish_post Unpublish a post from one or all platforms. Removes the post from the social media platform but keeps the p...

// RUNNING THIS SERVER

The managed route: connect Mcp Socialapi through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y mcp-socialapi

// FAQ

How many tools does the Mcp Socialapi MCP server have? +

The Mcp Socialapi MCP server exposes 75 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Mcp Socialapi tools? +

Route the Mcp Socialapi server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Mcp Socialapi tools fall into? +

Mcp Socialapi tools are categorised as Read (39), Write (24), Destructive (12). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.