Facebook MCP Server
Connect your AI agents to HasData's Facebook MCP server. Scrape public profiles, page posts, and engagement counts in structured JSON over streamable HTTP.
https://mcp.hasdata.com/api/mcp?apis=facebook - Transport
- Streamable HTTP
- Auth
- OAuth or API key
- Tools
- 1 Facebook tool
- Price
- 10 credits / call
Data teams at
Playground
See the Facebook MCP server in action
Select a sample prompt to inspect the tool it chooses and the JSON payload your agent receives.
Facebook · 1 tool Enter to send
Who owns Nike's Facebook page, and what is its website?
NIKE, Inc. is the confirmed owner of Nike's Facebook page.
Its website is nike.com, and the page is verified.
hasdata_facebook_profile_getFacebookProfile { "handle": "nike" }
{
"url": "https://api.hasdata.com/scrape/facebook/profile/?handle=nike",
"status": 200,
"json": {
"profile": {
"id": "100044541544829",
"name": "Nike",
"username": "nike",
"category": "Sportswear Store",
"biography": "Just Do It.",
"verified": true,
"website": "nike.com",
"owner": {
"name": "NIKE, Inc.",
"isConfirmed": true
}
}
}
}
Who owns Nike's Facebook page, and what is its website?
NIKE, Inc. is the confirmed owner of Nike's Facebook page.
Its website is nike.com, and the page is verified.
hasdata_facebook_profile_getFacebookProfile { "handle": "nike" }
{
"url": "https://api.hasdata.com/scrape/facebook/profile/?handle=nike",
"status": 200,
"json": {
"profile": {
"id": "100044541544829",
"name": "Nike",
"username": "nike",
"category": "Sportswear Store",
"biography": "Just Do It.",
"verified": true,
"website": "nike.com",
"owner": {
"name": "NIKE, Inc.",
"isConfirmed": true
}
}
}
}
Show me a post from Nike's Facebook page.
"Leave your limits at the surface. #JustDoIt"
Nike published this Facebook reel on September 15, 2025.
hasdata_facebook_profile_getFacebookProfile { "handle": "nike" }
{
"url": "https://api.hasdata.com/scrape/facebook/profile/?handle=nike",
"status": 200,
"json": {
"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",
"media": [
{
"id": "2166091230582141",
"type": "Video"
}
]
}
]
}
}
How many reactions, comments and shares does Nike's "Leave your limits at the surface" post have?
The post has 7,935 reactions, 2,500 comments and 1,127 shares.
That includes 6,537 likes and 1,150 love reactions.
hasdata_facebook_profile_getFacebookProfile { "handle": "nike" }
{
"url": "https://api.hasdata.com/scrape/facebook/profile/?handle=nike",
"status": 200,
"json": {
"posts": [
{
"id": "1393461115481927",
"reactionsCount": 7935,
"commentsCount": 2500,
"sharesCount": 1127,
"reactions": [
{
"type": "Like",
"count": 6537
},
{
"type": "Love",
"count": 1150
},
{
"type": "Care",
"count": 136
},
{
"type": "Wow",
"count": 44
},
{
"type": "Angry",
"count": 33
},
{
"type": "Haha",
"count": 31
},
{
"type": "Sad",
"count": 4
}
]
}
]
}
}
Tools
The Facebook tools your agent can call
1 toolTyped parameters, required flags, and structured JSON fields for each tool. Read public profiles and page posts with reaction, comment and share counts.
+ hasdata_facebook_profile_getFacebookProfile Public profile details and page posts 3 params 10 credits
Try| Parameter | Type | Required | Example |
|---|---|---|---|
| handle | string | required | "nike" |
| language | enum | optional | "en" |
| nextPageToken | string | optional | "token from the previous response" |
response
- profile
- posts
- photos
- pagination
Base calls cost 10 credits. Failed calls are not billed.
Connect
One endpoint, any MCP client
A config block for every major MCP client, in its native format. Authenticate with browser OAuth or an x-api-key header.
Claude Code
$claude mcp add --transport http hasdata-facebook \
> https://mcp.hasdata.com/api/mcp?apis=facebook \
> --header "x-api-key: YOUR_API_KEY"
· One line, no restart. Run /mcp to confirm 1 tool.
Check the tools are thereIn the session
/mcp
hasdata-facebook · connected · 1 toolCursor
{
"mcpServers": { "hasdata-facebook": {
"url": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.cursor/mcp.json. Servers already in the file stay as they are.
· Project-level config also works at .cursor/mcp.json
Check the tools are thereAfter saving the file
Settings → MCP
hasdata-facebook · 1 tool enabledClaude Desktop
Recommended · OAuth connector
1.Settings → Connectors → Add custom connector
2.Paste https://mcp.hasdata.com/api/mcp?apis=facebook
3.Sign in with HasData
{
"mcpServers": { "hasdata-facebook": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.hasdata.com/api/mcp?apis=facebook",
"--header", "x-api-key:YOUR_API_KEY"]
} }
}
· Add this entry to ~/Library/Application Support/Claude/claude_desktop_config.json. Servers already in the file stay as they are.
· The config file only takes stdio servers, so a static key rides the mcp-remote bridge. On Windows the file lives at %APPDATA%\Claude\claude_desktop_config.json.
Check the tools are thereReopen the app
Settings → Connectors
hasdata-facebook · connected · 1 toolVS Code / Copilot
{
"servers": { "hasdata-facebook": {
"type": "http",
"url": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to .vscode/mcp.json. Servers already in the file stay as they are.
· Agent mode picks the server up on save.
Check the tools are thereAgent mode
Ctrl/⌘ + Shift + P → MCP: List Servers
hasdata-facebook · running · 1 toolWindsurf
{
"mcpServers": { "hasdata-facebook": {
"serverUrl": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.codeium/windsurf/mcp_config.json. Servers already in the file stay as they are.
· Windsurf reads serverUrl, not url. Header auth only.
Check the tools are thereIn Cascade
Cascade → MCP servers
hasdata-facebook · 1 toolCline
{
"mcpServers": { "hasdata-facebook": {
"type": "streamableHttp",
"url": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to cline_mcp_settings.json. Servers already in the file stay as they are.
· Header auth only. The type field tells Cline this is a remote server, not a command.
Check the tools are thereIn the MCP panel
MCP Servers → Installed
hasdata-facebook · 1 toolChatGPT / Agents SDK
Recommended · OAuth connector
1.Settings → Security and login → Developer mode
2.Plugins → + → developer-mode app, paste https://mcp.hasdata.com/api/mcp?apis=facebook
3.Sign in with HasData
from agents import Agent, HostedMCPTool
tool = HostedMCPTool(tool_config={
"type": "mcp",
"server_label": "hasdata-facebook",
"server_url": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"authorization": "YOUR_API_KEY",
"require_approval": "never",
})
agent = Agent(name="Researcher", tools=[tool])
· The Agents SDK sends authorization as a Bearer token, which the endpoint accepts. The ChatGPT route needs no key: it signs in with OAuth.
Check the tools are thereRun the agent
Runner.run(agent, "…")
hasdata-facebook · 1 tool listedCodex CLI
[mcp_servers.hasdata-facebook]
url = "https://mcp.hasdata.com/api/mcp?apis=facebook"
env_http_headers = { "x-api-key" = "HASDATA_API_KEY" }
· Add this entry to ~/.codex/config.toml. Servers already in the file stay as they are.
· TOML, not JSON. Codex reads the key from the HASDATA_API_KEY environment variable, so export it in the shell that starts Codex.
Check the tools are thereIn the terminal
codex mcp list
hasdata-facebook · 1 toolGemini CLI
{
"mcpServers": { "hasdata-facebook": {
"httpUrl": "https://mcp.hasdata.com/api/mcp?apis=facebook",
"headers": { "x-api-key": "YOUR_API_KEY" }
} }
}
· Add this entry to ~/.gemini/settings.json. Servers already in the file stay as they are.
· httpUrl, not url: Gemini keeps url for SSE servers. Header auth only.
Check the tools are thereIn the session
/mcp
hasdata-facebook · 1 toolRaw HTTP / curl
$curl -N https://mcp.hasdata.com/api/mcp?apis=facebook \
> -H "x-api-key: YOUR_API_KEY" \
> -H "Content-Type: application/json" \
> -H "Accept: application/json, text/event-stream" \
> -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
· Fallback for any client not listed. Streamable HTTP wants both Accept types, and leaving one out returns 406.
Check the tools are thereCall it yourself
curl … tools/list
{ "tools": [ … 1 item ] }Scope
Facebook plus whatever else you need
Name the services in the query string and the server exposes only their tools. Every one draws from the same key and the same balance.
https://mcp.hasdata.com/api/mcp?apis=facebook,instagram
3tools in your server
Build vs Buy
Free on GitHub, paid in hours
Anyone can clone a free MCP to scrape Facebook. Whether that stays free depends on the shape of your project.
Scenario
A script I run once
Self-hosted from GitHubyour machine, your upkeep
$0/ mo, runs locally
+ 3–6 h onceof someone’s time
Setup (clone, wire, run)3–6 h once
Markup changesnot yet
Retries and concurrencynot needed
Proxy and hosting$0
Nothing to own. You get the answer and delete the folder.
mcp.hasdata.comFree tier
$0/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
~25 calls 250 of 1,000 credits
The free tier renews every month. No card.
leans self-hosted
Take the free repo
Nothing has to keep working tomorrow, so upkeep never appears. Both cost nothing, so take whichever is already in front of you.
A weekly report
Self-hosted from GitHubyour machine, your upkeep
$0–40/ mo
+ 2–4 h / moof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes2–4 h / mo
Retries and concurrency2–4 h once
Proxy and hosting$0–40 / mo
Someone looks at it when the numbers come back wrong, which is how you find out.
mcp.hasdata.comFree tier
$0/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
~100 calls a month 1,000 of 1,000 credits
Exactly the free tier, so a heavier month moves you to Startup.
dead even
Either works
The repo is free if you have somewhere to run it, ours is free up to the credit ceiling. The two to four hours a month decide it.
A pipeline in production
Self-hosted from GitHubyour machine, your upkeep
$40–120/ mo
+ 6–10 h / moof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes2–4 h / mo
Retries, concurrency, rate limits4–8 h once
Proxy and hosting$40–120 / mo
Someone owns this permanently, and it is never the top of their list.
mcp.hasdata.comStartup, 200K credits, 5 concurrent
$49/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
5,000 calls 50K of 200K credits
A quarter of the plan used, and the rest is headroom.
leans hosted
Use the hosted server
The proxy and hosting bill alone is in the range of the whole plan, and that is before anyone spends the six to ten hours.
A feature in my product
Self-hosted from GitHubyour machine, your upkeep
$300+/ mo
+ on-callof someone’s time
Setup (proxy, hosting, wiring)3–6 h once
Markup changes, plus on-call2–4 h / mo
Retries, concurrency, rate limitsongoing
Proxy and hosting$300+ / mo
The thing your customers touch depends on one volunteer's spare evening.
mcp.hasdata.comBasic, 1M credits, 15 concurrent
$99/ mo
+ 0 hof someone’s time
Setup one line
Parser upkeep included
Retries and concurrency included
50,000 calls 500K of 1M credits
Same endpoint at ten calls and at ten million. One invoice.
leans hosted
Use the hosted server
A third of the price, and nobody has to carry a pager for a dependency your customers touch.
Pricing
One balance, every interface
A flat monthly price against a known credit ceiling. Move up a plan when you outgrow it.
Free
$0 /mo
Free forever
100 tool calls / month
1,000 credits / month
1 concurrent request
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Community support
Startup
$49 /mo
$2.46 / 1k tool calls
20K tool calls / month
200K credits / month
5 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Email support
Basic
Recommended$99 /mo
$0.99 / 1k tool calls
100K tool calls / month
1M credits / month
15 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Priority email support
Growth
$208 /mo
$0.69 / 1k tool calls
3M credits / month
50 concurrent requests
Every MCP tool on every plan
Failed calls are not billed
One balance across MCP and REST
Dedicated account manager
Monthly tool call volume
Free 100K 500K 2M
Best fit
Basic
tool calls / mo
100K
Concurrency
15
$ / 1k tool calls
$0.99
$99 /mo
Get StartedEnterprise
Custom price based on required volume
Past 20M credits a month, or terms the self-serve plans do not cover. We shape the contract around your workload.
Credits rollover
Unused credits carry into the next billing period.
Concurrency 2000+
Parallel request limits set to your peak load.
#1 request priority
Highest speed, always first in the queue.
Personal manager
A direct line to the founding team.
SSO
SAML single sign-on for the whole team.
SOC-2 compliance
Security review, DPA, and audit reports.
Talk to sales Quote within one business day
The same data, without the agent
FAQ
Before you wire it in
Which Facebook profiles can an agent access?
The tool reads publicly available Facebook profiles and Pages. Send a username, with or without @, or a numeric profile ID. Groups and private personal accounts are not supported. HasData is an independent service, not an official Meta integration.
Do I need to connect a Facebook account?
No Facebook password, session cookie or Page administrator token is required. Authenticate with HasData through OAuth or your API key. The tool does not expose private account data or administrator analytics.
Does it return comments or let an agent publish posts?
Posts include reaction, comment and share counts. Comment text and reply threads are not included. The tool reads public data and has no publishing, messaging or advertising-management actions.
How can an agent retrieve more posts?
When the response includes pagination.nextPageToken, send it in the next call with the same handle. Each page is a separate request. The available feed is not a guaranteed complete history of the account.
Why are follower counts returned as text?
Facebook displays follower and following totals as localized strings. The language parameter changes those display strings and labels, while fields such as likesCount remain numeric. It does not translate user-written posts.
Are the playground examples live?
The playground shows recorded response excerpts and illustrative agent summaries. It does not execute the sample prompts. Connect the MCP server to make your own requests.
How does billing work across MCP and the API?
MCP tool calls use the same workspace balance as direct API requests. The tool table shows the applicable rate, and failed requests consume no credits. When the balance runs out, calls stop until the billing cycle renews or the balance is replenished.
Which AI clients can connect?
Use an MCP client that supports Streamable HTTP. The connection section provides client-specific settings. Clients with OAuth can sign in to HasData, while unattended agents can use the x-api-key header.