
SocialAPIs
Facebook and Instagram pages, posts, ads and Marketplace data for AI agents
- Pricing
- Open source
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 2.2.0
- Listing updated
- 2 days ago
About SocialAPIs
SocialAPIs is an open-source MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http social-media-api https://mcp.socialapis.io/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.socialapis.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"social-media-api": {
"url": "https://mcp.socialapis.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"social-media-api": {
"type": "http",
"url": "https://mcp.socialapis.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"social-media-api": {
"serverUrl": "https://mcp.socialapis.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"social-media-api": {
"type": "http",
"url": "https://mcp.socialapis.io/mcp"
}
}
}Configuration
SOCIALAPIS_API_KEYYour SocialAPIs API key. Get yours at https://socialapis.io/dashboardRequiredMCP_PROXY_URLMCP proxy server URL (optional)
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Open source
Server is MIT licensed; API calls spend credits on a SocialAPIs account and prices are not listed in the README
SocialAPIs 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 to SocialAPIs

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data