How do I add Facebook data to Cursor?
Updated on · Sources
Add the SocialAPIs MCP server to Cursor: put its URL (https://mcp.socialapis.io/mcp) with your key in an Authorization: Bearer header in ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project), or use the one-click install on the Integrations page. Cursor's agent can then read public Facebook and Instagram data when you ask.
Meta's official option
Cursor reads MCP servers from ~/.cursor/mcp.json and a project's .cursor/mcp.json, and remote servers take a url and headers (Cursor docs, November 2026). Meta has no MCP server for other Pages' public data.
How to do it with SocialAPIs
Then ask in the chat: "Get the last 9 posts of facebook.com/nike and draft a JSON schema for them" or "Which ads is this brand running in the US?". Each tool call uses the credits of the endpoint behind it, e.g. Page details 1 credit; 5 credits when exact_followers_count=true.
For code that calls the API directly, the Integrations page also has the Python, JavaScript and Go SDKs.
Endpoints
GET /facebook/pages/details1 credit; 5 credits when exact_followers_count=true
Get Facebook page details.
Params:
link(required),exact_followers_count,page_sectionFacebook Page Details: docs and playgroundMCP:
facebook_page→detailsGET /facebook/ads/search1 credit
Search ads in the Meta Ad Library by keyword or page ID with filters.
Params:
query,ad_page_id,country,activeStatus,after_time,before_time,sort_data,end_cursorMeta Ads Library Search: docs and playgroundMCP:
facebook_ads→search
{
"mcpServers": {
"socialapis": {
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Tutorial: Integrations: Cursor setupUse it from Claude, ChatGPT or Cursor (MCP)
Good to know
- Keep the key out of a project file you commit: use the global file, or Cursor's
${env:…}variables inheaders. - The server has 12 read-only tools: no posting, no messages.
- The free plan (200 calls a month, no card) is enough to try it.
Sources
Checked on 2026-11-16.