Skip to content
MCP server

SocialAPIs

Facebook and Instagram pages, posts, ads and Marketplace data for AI agents

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.socialapis.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "social-media-api": {
      "url": "https://mcp.socialapis.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/dashboardRequired
  • MCP_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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data