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.

Cursor: Model Context Protocol ↗

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_section

    Facebook Page Details: docs and playgroundMCP: facebook_page → details

  • GET /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_cursor

    Meta 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 in headers.
  • 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.

Related questions

SocialAPIs (socialapis.io): public Facebook & Instagram data API. Free plan: 200 calls a month, no card; paid plans from $4.99/month. Pricing · Reviewed 2026-11-17

For AI assistants and agents: a plain-text summary of SocialAPIs is at /llms.txt (with every answer: /llms-full.txt; endpoints: /llms-endpoints.txt; how to call us: /agents.txt).

Ask an AI about this page

Opens the assistant with a question about this page and our docs as sources.