SocialAPIs MCP Server

Unified social media API for AI agents

🚀 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

Variable	Description	Default
`SOCIALAPIS_API_KEY`	Your SocialAPIs API key	None (required)
`MCP_PROXY_URL`	MCP proxy server URL	`https://mcp.socialapis.io`
`PORT`	HTTP server port	`3001`
`API_BASE_URL`	Backend API URL	`https://api.socialapis.io/v1`

Get API Key

Sign up at socialapis.io
Go to Dashboard
Copy your API key
Replace YOUR_API_KEY 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

Facebook Pages

facebook_get_page_id - Extract page ID from URL
facebook_get_page_details - Get page info, followers, likes
facebook_get_page_posts - Fetch posts with time filtering
facebook_get_page_reels - Get reels/short videos

Facebook Groups

facebook_get_group_id - Extract group ID from URL
facebook_get_group_details - Get group metadata
facebook_get_group_posts - Fetch group posts

Facebook Posts

facebook_get_post_id - Extract post ID from URL
facebook_get_post_details - Get reactions, comments, shares
facebook_get_post_attachments - Get media attachments
facebook_get_video_details - Get video metadata
facebook_get_post_comments - Fetch comments with pagination

More platforms coming soon: Instagram, TikTok, YouTube, Twitter

💡 Usage Examples

Brand Monitoring

Monitor Nike's Facebook page and alert me if engagement drops below average

Competitive Analysis

Compare engagement rates between Nike, Adidas, and Puma over the last month

Content Strategy

What types of posts get the most engagement on Coca-Cola's Facebook page?

Sentiment Analysis

Analyze comments on our recent posts and identify common themes

🏗️ Architecture

Claude Desktop
    ↓
@socialapis/mcp (local MCP client)
    ↓
https://mcp.socialapis.io (global proxy)
    ↓
https://api.socialapis.io (data API)

Why this architecture?

✅ Low latency (global edge network)
✅ High reliability (99.9% uptime)
✅ Auto rate limiting
✅ Smart caching
✅ Your API key stays local

🔧 Development

Local Setup

# Clone repository
git clone https://github.com/SocialAPIsHub/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Run MCP client
npm start YOUR_API_KEY

# Run HTTP proxy server
npm run serve

Project Structure

mcp-server/
├── src/
│   └── tools.js          # Tool definitions
├── mcp-wrapper.js        # MCP client (runs locally)
├── server.js             # HTTP proxy server
├── package.json
├── Dockerfile
└── README.md

Testing

# Test MCP client locally
node mcp-wrapper.js YOUR_API_KEY

# Test HTTP proxy
curl http://localhost:3001/health
curl http://localhost:3001/tools

# Test specific tool
curl -X POST http://localhost:3001/proxy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'

📊 Pricing

Plan	Requests/Month	Price
Free	200	$0
Starter	30,000	$49
Pro	120,000	$179
Enterprise	Unlimited	Custom

View detailed pricing →

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Quick Contribution Guide

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📖 Documentation

💬 Support

📧 Email: support@socialapis.io
💬 Discord: discord.gg/socialapis
🐛 Issues: GitHub Issues
📚 Docs: docs.socialapis.io

🗺️ Roadmap

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with Model Context Protocol
Powered by Anthropic Claude
Inspired by the AI agent community

🌟 Star History

Made with ❤️ by the SocialAPIs Team

Website • Twitter • Discord

social-media-api

Documentation