mcp-socialapi

mcp-socialapi

MCP server for SocialAPI — manage social media comments, DMs, reviews, and mentions across platforms through a single unified API.

Supports Instagram, Facebook, Google Business, TikTok, YouTube, X/Twitter, Trustpilot, and LinkedIn.

Installation

Claude Desktop (API key)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "socialapi": {
      "command": "npx",
      "args": ["-y", "mcp-socialapi"],
      "env": {
        "SOCIALAPI_API_KEY": "sapi_key_..."
      }
    }
  }
}

Get your API key from the SocialAPI dashboard.

OAuth (Marketplace)

When installing from the Claude MCP marketplace or Smithery, OAuth is handled automatically — no manual configuration needed.

Configuration

Variable	Required	Default	Description
SOCIALAPI_API_KEY	In self-hosted mode	—	Your SocialAPI API key (sapi_key_...)
SOCIALAPI_BASE_URL	No	https://api.social-api.ai	Override for self-hosted API instances

Available Tools

Accounts

Tool	Description
social_api_list_accounts	List all connected social media accounts
social_api_connect_account	Initiate OAuth flow to connect a new account
social_api_exchange_oauth	Complete OAuth flow by exchanging authorization code

Posts

Tool	Description
social_api_get_posts	List posts/media for a connected account

Comments

Tool	Description
social_api_get_comments	List comments on a specific post
social_api_get_comment_replies	List replies to a comment
social_api_reply_to_interaction	Reply to a comment or review
social_api_moderate_comment	Hide, unhide, or delete a comment
social_api_toggle_post_comments	Enable or disable comments on a post

Direct Messages

Tool	Description
social_api_get_dms	List DM threads
social_api_get_dm_thread	Look up a thread by user ID
social_api_send_dm	Send a message to a DM thread

Reviews & Mentions

Tool	Description
social_api_get_reviews	List reviews (Google Business, Trustpilot)
social_api_get_mentions	List brand mentions and tags

Usage

Tool	Description
social_api_get_usage	Get credit usage for current billing period
social_api_get_account_limits	Get platform-specific limits for an account

API Keys

Tool	Description
social_api_list_keys	List all API keys
social_api_create_key	Generate a new API key
social_api_revoke_key	Revoke an API key

Webhooks

Tool	Description
social_api_list_webhooks	List webhook endpoints
social_api_create_webhook	Create a new webhook endpoint
social_api_update_webhook	Update an existing webhook
social_api_delete_webhook	Delete a webhook endpoint

User

Tool	Description
social_api_get_me	Get current user profile
social_api_send_feedback	Send feedback to the SocialAPI team

Documentation

Full API reference: docs.social-api.ai

License

MIT