# Social-API.ai

SocialAPI gives AI agents a single MCP server to read and respond to every social media interaction — comments,

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add socialapi/socialapi

# Browse available tools
npx -y @smithery/cli@latest tool list socialapi/socialapi

# Get full schema for a tool
npx -y @smithery/cli@latest tool get socialapi/socialapi social_api_connect_account

# Call a tool
npx -y @smithery/cli@latest tool call socialapi/socialapi social_api_connect_account '{}'
```

## Direct MCP Connection

Endpoint: `https://socialapi--socialapi.run.tools`

## Tools (55)

- `social_api_connect_account` — Initiate connecting a new social media account. For OAuth2 platforms (instagram, facebook) returns an auth_url the user…
- `social_api_create_key` — Generate a new API key (prefixed sapi_key_) for programmatic API access. The raw key is returned exactly once in the re…
- `social_api_create_post` — Create or schedule a post to one or more connected social media accounts. Omit targets and scheduled_at to create a dra…
- `social_api_create_webhook` — Register a new webhook endpoint to receive real-time event notifications. The URL must be HTTPS. Specify which event ty…
- `social_api_delete_comment` — Permanently delete a comment from the platform and remove it from the inbox database. This action is irreversible. Supp…
- `social_api_delete_me` — Permanently delete the authenticated user account and ALL associated data including API keys, connected social accounts…
- `social_api_delete_media` — Permanently delete a media file from the media library and object storage. This is irreversible. If the media is refere…
- `social_api_delete_post` — Delete a published post from the social media platform, or cancel a scheduled/failed post before it is published. For p…
- `social_api_delete_review_reply` — Delete a business reply to a review. Requires account_id and the platform review_id. Supported on Google Business. Retu…
- `social_api_delete_webhook` — Permanently delete a webhook endpoint. Future events will no longer be delivered to this URL. Any in-flight deliveries …
- `social_api_disconnect_account` — Disconnect a connected social media account. Removes the stored OAuth tokens and disassociates the account from the use…
- `social_api_exchange_oauth` — Complete an OAuth2 account connection by exchanging the authorization code received after the user authorized access. R…
- `social_api_get_account_limits` — Get platform-specific API usage limits and quotas for a connected account, as reported by the platform itself (e.g., In…
- `social_api_get_comment_replies` — List replies to a specific comment. The interaction_id must be a comment ID starting with sapi_cmt_ (from social_api_ge…
- `social_api_get_constraints` — Get platform-specific content constraints for post creation. Returns per-platform limits including max text length, max…
- `social_api_get_conversation` — Get details for a single DM conversation including participant info, unread count, status (active/archived), and last m…
- `social_api_get_me` — Get the authenticated user's profile. Returns id (UUID), email, plan tier (free, starter, pro, business, or enterprise)…
- `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.g., image/jp…
- `social_api_get_mentions` — List brand mentions and tags for a connected account -- posts by other users that mention or tag your account. Returns …
- `social_api_get_post` — Get full details for a single post including text, status, scheduled/published timestamps, per-platform delivery detail…
- `social_api_get_post_logs` — Get delivery attempt logs for a single post. Returns log entries with platform, action (publish/retry/unpublish/delete)…
- `social_api_get_post_metrics` — Fetch live engagement metrics for a published post from each target platform. Returns per-platform metrics including li…
- `social_api_get_reviews` — List reviews across connected accounts (applicable to Google Business, Trustpilot, and similar review platforms). Fan-o…
- `social_api_get_storage_usage` — Get storage usage and quota for the authenticated user's media library. Returns used_bytes, limit_bytes (-1 if unlimite…
- `social_api_get_usage` — Get resource usage for the current billing period. Returns counts and limits for accounts (connected account slots), po…
- `social_api_hide_comment` — Hide a comment from public view on the platform. The comment remains in the database but is marked hidden. Reversible —…
- `social_api_like_comment` — Like a comment on behalf of the connected account. Supported on Facebook and Twitter. Returns 501 for platforms without…
- `social_api_list_accounts` — List all connected social media accounts for the authenticated user. Returns account details including platform name, u…
- `social_api_list_conversations` — List inbox DM conversations for the authenticated user, sorted by most recently active. Optionally filter by connected …
- `social_api_list_inbox_posts` — List inbox posts (posts that have received comments) for the authenticated user. Optionally filter by account, platform…
- `social_api_list_keys` — List all API keys for the authenticated user. Returns key metadata including id, name, preview (first characters of the…
- `social_api_list_media` — List uploaded media files in the user's media library. Returns media objects with id, filename, content_type, size_byte…
- `social_api_list_messages` — List messages in a DM conversation, sorted newest first. The conversation_id comes from social_api_list_conversations. …
- `social_api_list_post_comments` — List comments for a specific inbox post, sorted oldest-first. The inbox_post_id comes from social_api_list_inbox_posts.…
- `social_api_list_post_logs` — List publishing logs across all posts for the authenticated user. Filter by status (success/error), platform, action (p…
- `social_api_list_posts` — List all posts (drafts, scheduled, published, failed) with rich filtering. Supports filtering by status, platform, acco…
- `social_api_list_webhooks` — List all registered webhook endpoints for the authenticated user. Returns endpoint details including id, url, subscribe…
- `social_api_mark_conversation_read` — Mark all messages in a conversation as read, resetting the unread count to zero. Idempotent -- calling on an already-re…
- `social_api_moderate_comment` — Moderate a comment by hiding, unhiding, or deleting it. The interaction_id must be a comment ID starting with sapi_cmt_…
- `social_api_patch_me` — Update the authenticated user's profile. Currently only supports marking onboarding complete by setting onboarding=fals…
- `social_api_private_reply_to_comment` — Send a private reply (DM) in response to a comment, visible only to the commenter. Max 1000 characters. Consumes 1 inte…
- `social_api_reply_to_comment` — Reply publicly to a post or a specific comment. Provide account_id and post_id; optionally also comment_id to target a …
- `social_api_reply_to_review` — Reply to a review as the business. The reply appears publicly as the business response. Requires account_id and the pla…
- `social_api_retry_post` — Retry publishing a post that previously failed. Only posts in 'failed' or 'partial' status can be retried -- re-enqueue…
- `social_api_revoke_key` — Permanently deactivate an API key. This is irreversible -- the key immediately stops working for all API requests. Use …
- `social_api_send_dm` — Send a direct message in an existing inbox conversation. The conversation_id comes from social_api_list_conversations. …
- `social_api_send_feedback` — Send feedback to the SocialAPI team. Use when a user wants to report a bug, request a feature, or share general feedbac…
- `social_api_unhide_comment` — Restore a previously hidden comment to public view. Supported on Instagram, Facebook, and Threads.

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*