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