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