# SocialAPIs

> SocialAPIs is an open-source MCP server for marketing and seo. Facebook and Instagram pages, posts, ads and Marketplace data for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Repository:** https://github.com/socialapishub/mcp-server
- **MCP Registry name:** io.github.SocialAPIsHub/social-media-api
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

The server wraps the SocialAPIs REST API in 12 tools that cover 50 actions. Each tool groups one resource, such as `facebook_page`, `facebook_ads` or `instagram_profile`, and takes an `action` argument that maps to one endpoint on api.socialapis.io. Every call returns a structured result together with the credits charged and the credits remaining, so an agent can watch its own spend.

Coverage runs from page details, posts, reels and albums to group content, comments, ad-library searches and Marketplace listings with price, location and condition filters. On Instagram it reads profiles, highlights, posts, reels by audio and nearby places. All tools are marked read-only, so clients can skip confirmation prompts.

You can run it locally over stdio with npx, or point a remote-MCP client at the hosted streamable-HTTP endpoint and send your API key as a bearer token. Listing tools works without a key; calls need one. Tool prices and parameters follow the live SocialAPIs catalogue, which the server re-reads every ten minutes.

## Features

- **Twelve grouped tools:** Facebook and Instagram resources are grouped into 12 tools with an action argument covering 50 endpoints.
- **Ads and Marketplace search:** Search the Facebook ad library by keyword, page or country, and Marketplace by price, location, category and condition.
- **Credit tracking in results:** Each response includes credits charged and credits remaining so agents can budget calls.
- **Hosted or local:** Use the remote endpoint at mcp.socialapis.io or run the npm package over stdio.
- **Live tool catalogue:** Prices, descriptions and parameters update from the SocialAPIs catalogue without a new release.
- **Read-only annotations:** All tools carry readOnlyHint, so clients may skip approval prompts.

## Good for

- Pull a competitor's recent Facebook page posts and engagement
- Monitor Facebook ads running for a keyword in a given country
- Collect Marketplace vehicle or rental listings with seller details
- Look up an Instagram profile, its reels and highlights
- Resolve a page or group ID from a URL before further queries

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http social-media-api https://mcp.socialapis.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.socialapis.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "social-media-api": {
      "url": "https://mcp.socialapis.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "social-media-api": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "social-media-api": {
      "serverUrl": "https://mcp.socialapis.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "social-media-api": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp"
    }
  }
}
```

## Tools

- `facebook_page`: Page details, id, posts, videos, reels, albums and album items
- `facebook_group`: Group details, id, posts, videos and albums
- `facebook_post`: Post details, attachments, comments and comment replies
- `facebook_search`: Search pages, people, posts, videos and locations
- `facebook_ads`: Ad searches, advertisers by keyword, page and archive details
- `facebook_marketplace`: Marketplace search, vehicles, rentals, listings and sellers
- `facebook_media_download`: Download URLs for Facebook images and videos
- `instagram_profile`: Profile details, posts, reels and highlights
- `instagram_post`: Post details and ID from a shortcode
- `instagram_reels`: Reels feed and reels by audio
- `instagram_search`: Popular users, hashtags and places for a keyword
- `instagram_location`: Posts and nearby places for a location

## FAQ

### Do I need an API key?

Yes for tool calls: set SOCIALAPIS_API_KEY or send a bearer token to the hosted endpoint. Listing tools works without one.

### Can it post or change anything on Facebook or Instagram?

No. All tools are read-only data lookups.

### How do I connect without installing anything?

Point a remote-MCP client at https://mcp.socialapis.io/mcp and pass Authorization: Bearer with your key.

### Do old tool names still work?

The README says the earlier per-endpoint names still work when called directly, though they are no longer listed.

### Is SocialAPIs free?

Yes. SocialAPIs is open source, so you can use and self-host it for free.

### How do I add SocialAPIs to Claude Code?

Run this command in your terminal: claude mcp add --transport http social-media-api https://mcp.socialapis.io/mcp

### What are the best alternatives to SocialAPIs?

The closest alternatives to SocialAPIs are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/socialapis
