SocialAPIs MCP server

SocialAPIs MCP Server

Unified social media API for AI agents

Website • Documentation • Discord • npm

Official SDKs: Python • JavaScript / TypeScript • Go

🚀 Quick Start

Installation

npm install -g @socialapis/mcp

Configuration

Add to your Claude Desktop config:

macOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 Configuration

Method 1: Command Line Argument (Recommended for Claude Desktop)

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"]
    }
  }
}

Method 2: Environment Variable

# Set environment variable
export SOCIALAPIS_API_KEY=your_api_key_here

# Run without argument
npx @socialapis/mcp

Method 3: .env File (For Development)

# Copy example file
cp .env.example .env

# Edit with your values
nano .env

.env file:

SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io

Environment Variables

Get API Key

1. Sign up at socialapis.io
2. Go to Dashboard
3. Copy your API key
4. Replace YOURAPIKEY in config

Test It

Restart Claude Desktop and ask:

Get Nike's Facebook page details

📋 Features

• 🌐 Unified API - One interface for multiple platforms
• 🤖 AI-First - Built for Claude, Cursor, and AI agents
• 📊 Rich Data - Posts, comments, engagement metrics
• 🔍 Advanced Filtering - Time ranges, pagination
• 🎯 Simple Auth - No OAuth complexity
• ⚡ Fast - Global edge network
• 🔒 Secure - API keys stay local

🛠️ Available Tools

47 tools across Facebook and Instagram. Every tool maps 1:1 to a REST endpoint on api.socialapis.io — pricing notes in each tool description indicate per-call credit cost.

Facebook — Pages

• facebookgetpage_id — Extract page ID from URL
• facebookgetpagedetails — Page info, followers, likes, category. Set exactfollowers_count=true for the exact integer (charges 5 credits instead of 1)
• facebookgetpageposts — Fetch posts with aftertime / before_time for date filtering. limit 3-9, charges scale per ceil(returned / 3)
• facebookgetpage_videos — Page videos, limit 6-12
• facebookgetpage_reels — Reels / short videos

Facebook — Groups

• facebookgetgroup_id — Extract group ID from URL
• facebookgetgroup_details — Full details (members, description, rules)
• facebookgetgroup_posts — Group posts, same limit + date filtering as page posts
• facebookgetgroup_videos — Group videos with pagination

Shortened. The full README is on GitHub.