Start free

Facebook API MCP server

MCP server · 11 tools · 23 endpoints

Facebook MCP server

Pages, posts, comments with replies, reviews, reels, the ad library, Marketplace and events: public Facebook read by Claude or Cursor.

Get a free key Connect in a minute

100 credits on signup · No card · Sign in with OAuth or paste a key

scrapersocial-facebook mcp.scrapersocial.com/facebookconnected
you

Transcribe <facebook-video-url> and summarise the announcements in it.

agent
calls get_transcript 15 credits / video
{ "url": "<Facebook video url>" }
server
returns
transcript string · the spoken words segments [{ start, end, text }] · timestamped
agent

Reads the transcript and lists each announcement with the moment it is made.

Shape only. Keys follow the tool's summary; a real call returns the full record. 1 call · 15 credits

Connect

One URL. Your client already knows what to do with it.

The first call opens a sign-in. New accounts get 100 credits, no card. Every client below shares one account and one balance.

Get a free key
server url https://mcp.scrapersocial.com/facebook
claude.aiOAuth

Settings → Connectors → Add custom connector, then paste the server URL.

mcp.scrapersocial.com/facebook

Web, desktop and mobile. Nothing else to paste.

Claude Codeone command

Run this in a terminal.

$ claude mcp add --transport http scrapersocial-facebook https://mcp.scrapersocial.com/facebook

Approve the sign-in prompt on first use.

Cursorone click

Installs the server and opens the MCP panel.

Add to Cursor
or paste the JSON into .cursor/mcp.json
{ "mcpServers": { "scrapersocial-facebook": { "url": "https://mcp.scrapersocial.com/facebook", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Other clients · VS Code, Windsurf, Gemini CLI, anything that speaks MCP
VS Codeone click or JSON
Add to VS Codeor run MCP: Add Server, choose HTTP and use:
{ "name": "scrapersocial-facebook", "type": "http", "url": "https://mcp.scrapersocial.com/facebook" }
Windsurf~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "scrapersocial-facebook": { "serverUrl": "https://mcp.scrapersocial.com/facebook", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Gemini CLI~/.gemini/settings.json
{ "mcpServers": { "scrapersocial-facebook": { "httpUrl": "https://mcp.scrapersocial.com/facebook", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Any clientStreamable HTTP · OAuth 2.1 or Bearer
$ npx add-mcp https://mcp.scrapersocial.com/facebook

One account and one balance across every client and the every-platform hub at mcp.scrapersocial.com.

What it does

What your agent can do with Facebook

Facebook is several products under one domain, and the catalog here reflects that: 23 endpoints covering pages and their posts, comments with replies, video transcripts and summaries, reels, photos, the ad library, Marketplace listings, events, group posts and page reviews.

Nine billed tools are named directly. get_transcript returns the spoken words of a public video for 15 credits and get_summary a short written summary for 17. get_post_stats gives one post’s likes, comments and shares for 5. get_comments (3 per comment) and get_comment_replies (3 per reply) walk a discussion. get_profile returns a page’s follower count and about section for 10, get_channel_posts its recent posts for 3 each, get_reviews its public ratings and reviews at 3 per review, and download_media direct media URLs for 10. The rest, ad search and single ads, page ads, events and event search, group posts, Marketplace search and items, photos, reels, followers and following, run through call_endpoint at 3 to 5 credits; list_endpoints prints the whole table without charge.

If you administer the page, Meta’s own Graph API gives you more for free. This server is for the pages you don’t own: competitors, partners, public figures, venues, and the pages your customers talk about. Give the agent a page URL or handle and let it decide which of the 23 calls answers the question.

Five jobs it finishes on its own

01

Profile a competitor's page

Ten credits for page stats, 150 for fifty posts, 3 per review. An agent can tell you posting cadence, what gets shared, and what customers complain about in reviews, all from public pages.

02

Read a video instead of watching it

A town-hall recording, a product demo, a political page's live stream. get_transcript gives you the words for 15 credits; get_summary gives you two paragraphs for 17.

03

Research ads in the library

ads-search by keyword and page-ads by page, both via call_endpoint, return what a page is currently running. Pair with get_channel_posts to see the organic side of the same campaign.

04

Monitor events and Marketplace

events-search for a keyword, page-events for a venue, marketplace-search for a product category. Three credits a result, and an agent can diff today's list against yesterday's.

05

Walk a comment thread with replies

get_comments for the top level, get_comment_replies for the thread under any comment. Three credits each, newest first, 50 to a page. Enough to reconstruct an argument.

Limits · read before you connect

What this does not do

Written by a person, not generated. If something here is wrong, tell us.

Public Facebook only, read without a session: friends-only posts, private groups, Messenger and the Page Insights only admins see aren’t reachable. A private or deleted post produces not found without a charge. List tools cap at 50 items per call, charge by the item, and never bill under 1 credit once they succeed. Transcript and summary are the dear calls at 15 and 17 credits, so an agent should confirm the user wants a video’s content before fetching it. Group posts work for public groups only. Nothing here comments, reacts or messages on your behalf.

Tools

11 tools, same names as the every-platform hub

9 do one Facebook thing each. The last two reach all 23 endpoints by path, so nothing in the catalog is out of an agent's reach.

Full credit table →

Get a video transcript

get_transcript

Spoken-word transcript of a public video, with timestamped segments where the source publishes them.

15 credits / video

Summarise a video

get_summary

Short LLM summary of what a public video actually says, built on its transcript.

17 credits / video

Get post engagement stats

get_post_stats

Engagement stats for one public post or video: views, likes, comments, shares and reposts where the platform publishes them.

5 credits / post

Read comments on a post

get_comments

Comments on a public post or video, newest first, paginated with limit and cursor.

3 credits / comment

Read replies to a comment

get_comment_replies

The reply thread hanging off a single public comment.

3 credits / reply

Get an account profile

get_profile

Profile, page or channel record for a public account: follower and subscriber counts, bio, and totals.

10 credits / page

List an account's posts

get_channel_posts

Recent public posts or videos from one account, with per-item metrics.

3 credits / post

Read reviews

get_reviews

Public reviews and ratings for a product, business, app or company page.

3 credits / review

Get media file URLs

download_media

Direct media URLs for a public post or video, served from the platform's own CDN.

10 credits / video
Reaches the other 14 endpoints

List every Facebook endpoint

list_endpoints

Browse every Facebook endpoint, its input and its credit cost. Free, and calls nothing upstream.

free

Call any Facebook endpoint by path

call_endpoint

Run any Facebook endpoint by its path, so nothing Facebook offers is out of reach of an agent.

endpoint's own cost

Pricing

100 free credits is 6 transcripts, or 10 profile reads, or 33 comments.

Then $5 a month for 1,000 credits, or $4 per 1,000 as a top-up. No card to start. Calls cost between 3 and 17 credits on Facebook.

6 transcriptsget_transcript · 15 each
10 profile readsget_profile · 10 each
33 commentsget_comments · 3 each
Get a free key 100 credits on signup · $5 for 1,000 · full credit table

Prompts

Things to ask once it is connected

Copy one, swap the placeholder, paste it into your client.

Give me the stats for the Facebook page at <page-url>: followers and recent engagement.

Grab the 30 most recent posts on <page-url> and tell me which three got the most shares.

Transcribe <facebook-video-url> and summarise the announcements in it.

Pull the reviews for <page-url> and group the one-star ones by complaint.

What ads is <page-url> running right now?

Read the comments and replies on <facebook-post-url> and summarise both sides of the argument.

Questions

Before you connect

Do I need a Facebook login? #

No. A ScraperSocial key is all you supply; pages are read the way a logged-out browser sees them.

Why did a call cost 15 credits? #

That's get_transcript. Summary is 17, page stats and download are 10, post stats are 5, and comments, replies, posts and reviews are 3 per item.

Is this the Graph API or a Meta partner product? #

Neither. ScraperSocial is not a Meta product and not a Meta partner; it's independent, and it returns what's publicly visible. For pages you own, the Graph API is the better and cheaper tool.

Can it read private groups or friends-only posts? #

No. Only public groups and public posts. Everything else surfaces as not found, unmetered.

How do I reach the ad library and Marketplace tools? #

Through call_endpoint with paths like /v1/facebook/ads-search, /v1/facebook/page-ads or /v1/facebook/marketplace-search. list_endpoints shows every path with its input and cost.

What's a comment page? #

Up to 50 comments, newest first, 3 credits each, and a cursor to continue from. Replies under a single comment use get_comment_replies at the same rate.