SocialAPIs

socialapishub/mcp-server

A unified API wrapper that lets Claude pull data from Facebook pages, groups, and posts without dealing with OAuth complexity. You get tools to extract page IDs from URLs, fetch follower counts and engagement metrics, retrieve posts with time filters, and pull comments with pagination. The MCP client runs locally while routing requests through their hosted proxy to api.socialapis.io. Useful when you need to monitor brand mentions, compare competitor engagement rates, or analyze comment sentiment across Facebook properties. Requires a SocialAPIs API key with a free tier of 200 requests per month. Instagram, TikTok, and YouTube support are on the roadmap but not yet available.

tools: 12
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Oct 27, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.socialapis.io/mcp --name social-media-api --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http social-media-api https://mcp.socialapis.io/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 12 tools

Verified live against the running server on Nov 6, 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, website, address), rating and the ad_page_id used by the Ads Li...10 params

Facebook 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, website, address), rating and the ad_page_id used by the Ads Li...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of details · id · posts · videos · reels · albums

after_timestring

ISO 8601 timestamp - only return posts after this time. Optional for: posts.

album_idstring

Album ID, from action=albums or facebook_group (action=albums). Required for: album_items.

before_timestring

ISO 8601 timestamp - only return posts before this time. Optional for: posts.

end_cursorstring

Pagination cursor from the previous response. Optional for: posts, videos, reels, albums, album_items.

exact_followers_countboolean

When true, performs a deeper scrape to return the exact follower count (e.g. 38,493,217 instead of "38M"). Charges 5 credits when true, 1 credit otherwise. Default: false. Optional for: details.

limitnumber

Results per call. posts: 3-9 (default 3) · videos: 6-12 (default 6) · albums: 8-16 (default 8). Optional for: posts, videos, albums.

linkstring

Facebook page URL, e.g. https://facebook.com/nike. For videos you can pass profile_id instead. Required for: details, id, posts, reels. Optional for: videos.

profile_idstring

Numeric Facebook page ID, from action=id. For videos, an alternative to link. Required for: albums. Optional for: videos.

timezonestring

Timezone for timestamps (e.g., UTC, America/New_York). Optional for: posts.

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=posts for its posts. Pricing: 1 credit per call. Inputs:...9 params

Public 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=posts for its posts. Pricing: 1 credit per call. Inputs:...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of details · id · posts · videos · albums · album_items

after_timestring

ISO 8601 timestamp. Optional for: posts.

album_idstring

Album ID, from facebook_page (action=albums) or action=albums. Required for: album_items.

before_timestring

ISO 8601 timestamp. Optional for: posts.

end_cursorstring

Pagination cursor. Optional for: posts, videos, album_items.

group_idstring

Facebook group ID, from action=id. Required for: albums.

limitnumber

Results per call. posts: 3-9 (default 3) · albums: 8-16 (default 8). Optional for: posts, albums.

linkstring

Facebook group URL. Required for: details, id, posts, videos.

timezonestring

IANA timezone for returned timestamps, e.g. UTC or America/New_York. Default: UTC. Optional for: posts.

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 for any post. If you need view counts, video download URLs...9 params

Facebook 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 for any post. If you need view counts, video download URLs...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of details · details_extended · id · attachments · video · comments

comment_feedback_idstring

Feedback ID from the comments endpoint with include_reply_info=true. Required for: comment_replies.

end_cursorstring

Pagination cursor for next page of comments. Optional for: comments.

expansion_tokenstring

Expansion token from the comments endpoint with include_reply_info=true. Required for: comment_replies.

include_reply_infostring

When "true", includes comment_feedback_id and expansion_token for fetching replies. Optional for: comments.

limitnumber

Maximum number of comments to return. Default: 10. Maximum: 30. Optional for: comments.

linkstring

Facebook post or reel URL (regular posts, video posts and reels). Required for: details, details_extended, id, comments.

post_idstring

Numeric Facebook post ID, from action=id. Required for: attachments.

video_idstring

Numeric Facebook video ID, e.g. the number in a facebook.com/.../videos/<id> URL. Required for: video.

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, categories and follower counts, 3 per call, plus an end_cursor...10 params

Search 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, categories and follower counts, 3 per call, plus an end_cursor...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of pages · people · posts · videos · locations

end_cursorstring

Pagination cursor. Optional for: pages, people, posts, videos.

end_timestring

Filter posts before this date (YYYY-MM-DD). Optional for: posts.

fieldsstring

Comma-separated list of response fields to include. Optional for: videos.

location_uidstring

Location UID from action=locations, to limit results to a place. Optional for: pages, people, posts.

most_recentstring

When "true", shows most recent videos first. Optional for: videos.

querystring

Search keyword. pages: a brand or business name · people: a name · posts, videos: words in the text · locations: a city, place or landmark. Required for: pages, people, posts, videos, locations.

recent_postsstring

When "true", shows only recent posts. Optional for: posts.

start_timestring

Filter posts after this date (YYYY-MM-DD). Optional for: posts.

videos_livestring

When "true", filters for live videos only. Optional for: videos.

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 ads about a topic, or ad_page_id to list one advertiser's...13 params

Meta 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 ads about a topic, or ad_page_id to list one advertiser's...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of search · keywords · page_details · archive_details · countries

activeStatusstring

Filter: ALL, Active, or Inactive. Optional for: search.

ad_archive_idstring

Ad Library archive ID of the ad (ad_archive_id from a action=search result). Required for: archive_details.

ad_page_idstring

Facebook AD Page ID (alternative to query). Optional for: search.

after_timestring

Filter ads after this date (YYYY-MM-DD). Optional for: search.

before_timestring

Filter ads before this date (YYYY-MM-DD). Optional for: search.

countrystring

ISO country code or "ALL". Optional for: search, keywords, archive_details.

end_cursorstring

Pagination cursor. Optional for: search.

is_ad_non_politicalstring

Filter non-political ads. Optional for: archive_details.

is_ad_not_aaa_eligiblestring

Filter AAA eligibility. Optional for: archive_details.

page_idstring

Advertiser page ID: ad_page_id from facebook_page (action=details), or page_id from action=keywords. Required for: page_details. Optional for: archive_details.

querystring

Keyword. search: words in the ads (or pass ad_page_id instead) · keywords: a topic to find advertisers for, e.g. running shoes. Required for: keywords. Optional for: search.

sort_datastring

Sort by "impressions" or "recent". Optional for: search.

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 or category near a location, with price, condition, radi...25 params

Facebook 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 or category near a location, with price, condition, radi...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of search · vehicles · rentals · listing · seller · categories

category_urlstring

Category URL slug. Optional for: search.

citystring

City name, e.g. Austin. Required for: city_coordinates.

commerce_search_and_rp_conditionstring

Condition: new, used_like_new, used_good, used_fair. Optional for: search.

commerce_search_sort_bystring

Sort: BEST_MATCH, CREATION_TIME_DESCEND, PRICE_ASCEND, etc. Optional for: search.

countrystring

Country name or code. Optional for: city_coordinates.

end_cursorstring

Pagination cursor. Optional for: search, vehicles, rentals.

exact_matchstring

When "true", exact match search. Optional for: search.

exactly_onestring

When "true", return exactly one result. Optional for: city_coordinates.

filter_bathrooms_maxstring

Maximum number of bathrooms. Optional for: rentals.

filter_bathrooms_minstring

Minimum number of bathrooms, e.g. 1. Optional for: rentals.

filter_bedrooms_maxstring

Maximum number of bedrooms. Optional for: rentals.

filter_bedrooms_minstring

Minimum number of bedrooms, e.g. 2. Optional for: rentals.

filter_location_latitudestring

Latitude of the search center, e.g. 30.2672 (from action=city_coordinates). Optional for: search, vehicles, rentals.

filter_location_longitudestring

Longitude of the search center, e.g. -97.7431 (from action=city_coordinates). Optional for: search, vehicles, rentals.

filter_price_lower_boundstring

Minimum price in the local currency, whole number, e.g. 100. Optional for: search, vehicles, rentals.

filter_price_upper_boundstring

Maximum price in the local currency, whole number, e.g. 2000. Optional for: search, vehicles, rentals.

filter_radius_kmstring

Search radius around the center in kilometres, e.g. 40. Optional for: search, vehicles, rentals.

is_c2c_listing_onlystring

Individual sellers only. Optional for: vehicles.

limitnumber

Maximum number of items to return. Default: 24. Optional for: search.

+5 more parameters. See the server's own documentation for the full schema.

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).1 params

Resolve 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).

Parameters* required

url*string

Facebook media URL to download

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 profiles. Pricing: 1 credit per call. Inputs: username (require...6 params

Instagram 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 profiles. Pricing: 1 credit per call. Inputs: username (require...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of details · id · posts · reels · highlights · highlight_details

end_cursorstring

Pagination cursor for next page. Optional for: posts, reels.

highlight_idstring

Highlight ID (from profile highlights endpoint). Required for: highlight_details.

linkstring

Instagram profile URL (alternative to username). Optional for: details, id.

user_idstring

Instagram profile ID from action=id. posts, reels: its long user_id (e.g. 17841401474538262) · highlights: its pk (e.g. 528817151). For posts, an alternative to username. Required for: reels, highl...

usernamestring

Instagram username, without the @. For posts it returns more results than user_id. Required for: details. Optional for: id, posts.

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 (the part after /p/ or /reel/ in the URL, or from action=id...3 params

Instagram 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 (the part after /p/ or /reel/ in the URL, or from action=id...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of details · id

linkstring

Instagram post URL. Required for: id.

shortcodestring

Instagram post shortcode (e.g., DMF-GjGO0-q). Required for: details.

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 similar reels by the same author. Not tied to a user; for o...4 params

Instagram 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 similar reels by the same author. Not tied to a user; for o...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of feed · by_audio

audio_idstring

Audio cluster ID (music ID). Required for: by_audio.

clips_media_idstring

Clip media ID for chaining/pagination (from previous response). Optional for: feed.

max_idstring

Pagination cursor for next page. Optional for: by_audio.

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 credit per call. Inputs: keyword (required), end_cursor (optio...2 params

Search 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 credit per call. Inputs: keyword (required), end_cursor (optio...

Parameters* required

end_cursorstring

Pagination cursor for next page

keyword*string

Search keyword/query

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 place in instagram_search (action=search). Returns an end_c...4 params

Instagram 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 place in instagram_search (action=search). Returns an end_c...

Parameters* required

action*string

Which operation to run. See the tool description for what each action returns and which parameters it needs.one of posts · nearby

end_cursorstring

Pagination cursor for next page. Optional for: posts.

location_idstring

Instagram location ID. Required for: posts, nearby.

tabstring

Filter: "recent" or "ranked". Optional for: posts.

Configuration

SOCIALAPIS_API_KEY*secret

Your SocialAPIs API key. Get yours at https://socialapis.io/dashboard

MCP_PROXY_URLdefault: https://mcp.socialapis.io

MCP proxy server URL (optional)

Readme

SocialAPIs MCP Server

Facebook & Instagram data for AI agents — local (npx) or hosted (remote MCP)

Website • Documentation • Discord • npm

View the full README on GitHub

Details

Repository: github.com/socialapishub/mcp-server
Categories: Data & Analytics, Finance & Commerce, Media & Entertainment
Package: @socialapis/mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Data & Analytics MCP servers

View all

Patreon Mcp Serverkyurish/patreon-mcp-serverAccess your Patreon creator data - campaigns, patrons, tiers, and posts.2stars

HoneyLabshoneylabshq/honeylabs-mcpHoneypot probe data: IP reputation, scanners, CVE probing, TLS and SSH fingerprints.2stars

IndieStackpattyboi101/indiestackSearch 3,100+ developer tools via MCP. Install commands, compatibility data, health scores.2stars

CallRail MCPpghdma/callrail-mcpCallRail REST API v3: 57 tools for calls, leads, trackers, tags, users, and agency reporting.2stars

Paradex Tradingtradeparadex/mcp-paradex-pyMCP server for Paradex perp trading. Market data, accounts, orders, positions, and vaults.2stars

Xraylib Mcp Servertschoonj/xraylib-mcp-serverMCP server providing X-ray interaction data via xraylib2stars