HasData Facebook

Facebook MCP Server

A hosted Facebook MCP server that gives Claude, Cursor, Windsurf and any other MCP client one read-only Facebook tool. Look up a public page or profile by its handle and get the page record with its exact like count, contact details and owner, plus the post feed with reactions, comments and shares, all as structured JSON, with no Meta developer app and nothing to host.

It reads public Facebook pages that a signed-out visitor can see. Groups and private personal accounts are out of scope.

1,000 free credits every month, no card required, which is 100 Facebook calls at the 10-credit rate.

https://mcp.hasdata.com/mcp?apis=facebook

• Prompts and resources

Contents

• What you need
• Quick start
• Example prompts
• Tools
• Errors and failure paths
• Pricing, free tier and limits
• How it compares
• FAQ
• HasData links
• Development
• Contributing
• License

What you need

An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-credit rate. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/facebook-mcp on npm and hasdata-facebook-mcp on PyPI, shown below.

Quick start

The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.

Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.

Claude Code

claude mcp add --transport http facebook "https://mcp.hasdata.com/mcp?apis=facebook" \

--header "x-api-key: HASDATA_API_KEY"

Claude Desktop

Settings, then Connectors, then Add custom connector, then paste https://mcp.hasdata.com/mcp?apis=facebook and sign in.

For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The @hasdata/facebook-mcp package is that launcher, and it reads the key from the environment. Add this to claude_desktop_config.json:

{

"mcpServers": { "facebook": { "command": "npx", "args": ["-y", "@hasdata/facebook-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:

{

"mcpServers": { "facebook": { "command": "uvx", "args": ["hasdata-facebook-mcp"], "env": { "HASDATA_API_KEY": "YOUR_KEY" } } } }

Cursor

~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{

"mcpServers": { "facebook": { "url": "https://mcp.hasdata.com/mcp?apis=facebook", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Windsurf

~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:

{

"mcpServers": { "facebook": { "serverUrl": "https://mcp.hasdata.com/mcp?apis=facebook", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

VS Code

.vscode/mcp.json in the workspace:

{

"servers": { "facebook": { "type": "http", "url": "https://mcp.hasdata.com/mcp?apis=facebook", "headers": { "x-api-key": "HASDATA_API_KEY" } } } }

Example prompts

• How many people like the Nike page, and how many are talking about it this week?
• Pull the contact details and the confirmed owner of this Facebook page.
• Read the last ten posts on this page and tell me which got the most shares.
• Compare the reaction mix on this brand's posts with its competitor's.
• Is this Facebook page verified, and what category does it list?
• Walk this page's feed back to the start of the month and list the posts with video.

One call returns the page record and the newest post. Walking the feed takes one more call per three posts, using the token the previous response returns.

Tools

One tool, 10 credits per successful call.

Get Facebook profile

hasdata_facebook_profile_getFacebookProfile

A public page or profile, with its feed.

The first call returns four blocks. profile is the page record, posts holds the newest post, photos is the strip of recent images, and pagination carries postsPerPage, nextPage and the nextPageToken to continue with.

Every call made with a token returns posts and pagination only, three posts at a time, with a fresh token until the feed ends and the token disappears.

{

"profile": { "id": "100044541544829", "pageId": "15087023444", "name": "Nike", "username": "nike", "url": "https://www.facebook.com/nike", "category": "Sportswear Store", "biography": "Just Do It.", "likesCount": 39545204, "talkingAboutCount": 173971, "checkInsCount": 18299, "followersCount": "39M followers", "followingCount": "24 following", "verified": true, "website": "nike.com", "websiteUrl": "http://nike.com/", "phone": "+48 58 881 27 61", "owner": { "name": "NIKE, Inc.", "isConfirmed": true }, "profilePicUrl": "https://scontent.fmex5-1.fna.fbcdn.net/v/t39.30808-1/284964043_10159903868513445_7696353984967674128_n.jpg", "coverPhotoUrl": "https://scontent.fmex25-1.fna.fbcdn.net/v/t39.30808-6/285211224_10159903868008445_5477337468887983165_n.png" }, "posts": [ { "id": "1393461115481927", "url": "https://www.facebook.com/reel/2166091230582141/", "text": "Leave your limits at the surface. #JustDoIt", "hashtags": ["#JustDoIt"], "timestamp": "2025-09-15T16:01:59.000Z", "reactionsCount": 7885, "commentsCount": 2461, "sharesCount": 1124, "reactions": [{ "type": "Like", "count": 6491 }], "media": [{ "id": "2166091230582141", "type": "Video" }] } ], "photos": [{ "id": "1095811278580247", "type": "Photo", "image": "https://scontent.fmex22-1.fna.fbcdn.net/v/t39.30808-6/471313661_18515827156020081_2460706748949541958_n.jpg" }], "pagination": { "postsPerPage": 3, "nextPage": 2, "nextPageToken": "eyJjdXJzb3IiOiJDZzhPYjNKbllXNXBZMTlqZFhKemIzS…" } }

Prompts and resources

The server exposes one resource, the accepted values of the single parameter that takes a fixed list. Reading it is cheaper than learning the vocabulary from a rejected call, and it costs no credits.

Its URI is hasdata://facebook/language.

The list is served without an API key, so a client can read it before a user has signed up.

Errors and failure paths

Plan for these rather than assuming a happy path.

Three of the counts are numbers and two are strings, and that is not a bug. likesCount, talkingAboutCount and checkInsCount are the exact figures Facebook publishes. followersCount and followingCount arrive as the rounded, localised text the page shows, "39M followers" in English and "39 Mio. Follower" when language is de. Compare with the numbers, display the strings.

`language` changes the strings, not the numbers. category moved from Sportswear Store to Sportbekleidungsgeschäft under de, while likesCount stayed a number. Pick the language for the reader, not for the maths.

A page that does not exist, was deleted or is not public still answers 200. The response then carries error instead of profile, and the call is billed. Test for profile before you read it. Groups and private personal accounts land here too.

The first page of the feed holds one post, not three. postsPerPage says 3, and pages two onward do return three, but the opening response carries the newest post alone alongside the profile and photos. Count what you got rather than what the field promises.

Later pages drop `profile` and `photos`. A call made with nextPageToken returns posts and pagination only. Keep the profile from the first response instead of expecting it again.

The token is the only way forward. nextPage is a page number for your own bookkeeping, and there is no parameter that takes it. Pass the previous nextPageToken unchanged, and stop when a response arrives without one.

Contact details are what the page shows to the request, not a canonical record. A global brand page can surface a regional phone number, and website is the display text while websiteUrl is the link. Read owner.isConfirmed before you treat the owner name as verified.

Image URLs are Facebook CDN links with signed parameters. They expire. Fetch what you need promptly and store the file, not the URL.

Results that carry data also carry a requestMetadata.id worth quoting in support.

Pricing, free tier and limits

The Facebook tool costs 10 credits per successful call. Response size does not change the price, and a page of the feed costs the same as th