HasData/facebook-mcp

A hosted Model Context Protocol (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.
- 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.
| Field | Value |
| :--- | :--- |
| URL | https://mcp.hasdata.com/mcp?apis=facebook |
| Transport | HTTP, streamable |
| Auth header | x-api-key: HASDATA_API_KEY |
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 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:
For Python instead of Node, swap the launcher for the PyPI package, which uvx runs without a manual install:
Cursor
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:
Windsurf
~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:
VS Code
.vscode/mcp.json in the workspace:
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
| Tool | What it returns |
| --- | --- |
| hasdata_facebook_profile_getFacebookProfile | Fetches a public Facebook page or profile by handle (username, @username or numeric profile id) and returns page id, name, username, category, bio, exact likes and…. 10 credits a call |
One tool, 10 credits per successful call.
Get Facebook profile
hasdata_facebook_profile_getFacebookProfile
A public page or profile, with its feed.
| Parameter | Type | Required | Notes |
| :--- | :--- | :--- | :--- |
| handle | string | yes | The username, with or without @, or the numeric id from a profile.php?id=… URL |
| language | string | | Language the page is rendered in, one of 32 codes such as en, de, pt or zh-hans |
| nextPageToken | string | | Cursor from the previous response, to read the next three posts |
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.