SocialAPIs

by @SocialAPIsHub · io.github.SocialAPIsHub/social-media-api

Facebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.

OnlineRemote + local
Category
Marketing and sales
Connection
Remote (HTTP)
Tools
12 reported
Status
Online

Connect it to your AI

Claude Code

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

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://mcp.socialapis.io/mcp

This server expects extra headers, usually an API key from its maker.

Or run it locally (npm)

claude mcp add social-media-api -e SOCIALAPIS_API_KEY=… -- npx -y @socialapis/mcp@2.2.0

Needs: SOCIALAPIS_API_KEY

Cursor, VS Code and other apps (mcp.json)

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

Tools it offers

12 tools, as the server itself reported during our check on Oct 31, 2026.

  • facebook_pageFacebook pages: profile details, page ID, posts, videos, reels and photo albums. Actions: - action=details: Get a Facebook page's profile: name, category, follower and like counts, bio, contact info (email, phone, websit
  • facebook_groupPublic Facebook groups: details, group ID, posts, videos and photo albums. Actions: - action=details: Get a public Facebook group's profile: name, description, member count, privacy, rules and activity stats. Use action=
  • facebook_postFacebook posts, videos and comments: post details, attachments, comments and replies. Actions: - action=details: Get a Facebook post's text, author, timestamp, media, and reaction, comment and share counts. Start here fo
  • facebook_searchSearch Facebook by keyword: pages, people, posts, videos and locations. Actions: - action=pages: Find Facebook pages by keyword (brand, business or topic name), optionally near a location. Returns page names, URLs, categ
  • facebook_adsMeta Ads Library: search ads, find advertisers by keyword, advertiser page details, single ad details and supported countries. Actions: - action=search: Search ads in the Meta Ad Library. Pass a keyword (query) to find a
  • facebook_marketplaceFacebook Marketplace: search listings, vehicles and rentals, listing and seller details, categories and city coordinates. Actions: - action=search: Search general Facebook Marketplace listings (items for sale) by keyword
  • facebook_media_downloadResolve a Facebook media URL (image, video or audio, e.g. from a post or reel) to direct downloadable file URLs. Returns URLs, not file bytes. Pricing: 1 credit per call. Inputs: url (required).
  • instagram_profileInstagram profiles: details, user ID, posts, reels, highlights and highlight stories. Actions: - action=details: Get an Instagram profile by username: bio, follower and post counts, verification status and related profil
  • instagram_postInstagram posts: full post details, or the shortcode from a post URL. Actions: - action=details: Get one Instagram post or reel in full: caption, media URLs, engagement counts, timestamp and owner. Needs the shortcode (t
  • instagram_reelsInstagram Reels: the trending feed, or reels that use a given audio track. Actions: - action=feed: Get Instagram's recommended and trending reels. Pass clips_media_id from a previous result to continue the feed or get si
  • instagram_searchSearch Instagram by keyword and get the top matching users, hashtags and places. Use it to find a username, or a place's location_id for instagram_location (action=posts). Returns an end_cursor for more. Pricing: 1 credi
  • instagram_locationInstagram locations: posts tagged at a place, and nearby places. Actions: - action=posts: List Instagram posts tagged at a location: top posts (tab=ranked) or most recent (tab=recent). Needs a location_id, e.g. from a pl

Questions

What is the SocialAPIs MCP server?

Facebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels. It is made by @SocialAPIsHub and listed in the official MCP Registry as io.github.SocialAPIsHub/social-media-api. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.

How do I add SocialAPIs to Claude?

In the Claude app or claude.ai, open Settings, then Connectors, choose "Add custom connector" and paste https://mcp.socialapis.io/mcp. In Claude Code, run: claude mcp add --transport http social-media-api https://mcp.socialapis.io/mcp

How do I add SocialAPIs to ChatGPT?

ChatGPT can use remote MCP servers as connectors. In ChatGPT settings, under Apps and Connectors, turn on developer mode if asked, create a new connector and paste https://mcp.socialapis.io/mcp.

How do I add SocialAPIs to Cursor?

Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "social-media-api": { "url": "https://mcp.socialapis.io/mcp" } } }

Does SocialAPIs work right now?

Yes. It responded when we last checked on 31 Oct 2026. We check remote MCP servers every day.

What can SocialAPIs do?

It gives your AI 12 tools, including facebook_page, facebook_group, facebook_post, facebook_search, facebook_ads. The full list is on this page.

Is this your server? Get the badge for your README
chen.media/mcp badge

Markdown (GitHub README)

[![Listed on chen.media/mcp](https://chen.media/mcp/badge/github-socialapishub-social-media-api.svg)](https://chen.media/mcp/github-socialapishub-social-media-api)

HTML (switches to dark mode on its own)

<a href="https://chen.media/mcp/github-socialapishub-social-media-api"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-socialapishub-social-media-api.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-socialapishub-social-media-api.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>

More in Marketing and sales

See all