MCP server · SDKs · n8n

Facebook and Instagram data, wherever you build

Give AI agents 47 tools through MCP, or call the same API from Python, JavaScript, Go and n8n. One API key, no OAuth.

For AI agents

MCP server

47 read-only tools with structured output. Use the hosted endpoint, with nothing to install. Send your key as Authorization: Bearer YOUR_API_KEY and replace YOUR_API_KEY with the key from your dashboard.

Hosted endpoint · Streamable HTTP

https://mcp.socialapis.io/mcp

claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Where: Run in your terminal

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp"],
      "env": {
        "SOCIALAPIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

File: claude_desktop_config.json (Settings → Developer → Edit Config) · Needs Node.js 18+. Restart Claude Desktop after saving.

{
  "mcpServers": {
    "socialapis": {
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

File: ~/.cursor/mcp.jsonOne-click install in Cursor

{
  "servers": {
    "socialapis": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:socialapis-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "socialapis-key",
      "description": "SocialAPIs API key",
      "password": true
    }
  ]
}

File: .vscode/mcp.json (VS Code prompts for the key, so it isn't stored in the file)

{
  "mcpServers": {
    "socialapis": {
      "type": "streamableHttp",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

File: cline_mcp_settings.json (MCP Servers → Configure)

{
  "mcpServers": {
    "socialapis": {
      "serverUrl": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

File: ~/.codeium/windsurf/mcp_config.json

Other MCP clients work the same way: point them at the hosted endpoint with the header, or run npx -y @socialapis/mcp with SOCIALAPIS_API_KEY set. Full guide

For developers

SDKs

Official open-source clients for Python, JavaScript and Go, with typed responses and cursor pagination. All three cover every endpoint.

$ pip install socialapis-sdk

from socialapis import Facebook, Instagram

fb = Facebook(api_token="YOUR_API_KEY")
page = fb.get_page_info("nike")
print(page.title, page.followers_count)

ig = Instagram(api_token="YOUR_API_KEY")
profile = ig.get_profile_details("nike")
print(profile.username, profile.followers_count)

Package ↗Source on GitHub ↗

$ npm install socialapis-sdk

import { Facebook, Instagram } from "socialapis-sdk";

const fb = new Facebook({ apiToken: "YOUR_API_KEY" });
const page = await fb.getPageInfo("nike");
console.log(page.title, page.followers_count);

const ig = new Instagram({ apiToken: "YOUR_API_KEY" });
const profile = await ig.getProfileDetails("nike");
console.log(profile.username, profile.followers_count);

Package ↗Source on GitHub ↗

$ go get github.com/SocialAPIsHub/socialapis-go

fb, err := socialapis.NewFacebook("YOUR_API_KEY")
if err != nil {
    log.Fatal(err)
}
page, err := fb.GetPageInfo(context.Background(), "nike", nil)
if err != nil {
    log.Fatal(err)
}
fmt.Println(page.Title, page.FollowersCount)

Package ↗Source on GitHub ↗

For automations

n8n

The SocialAPIs community node adds every Facebook and Instagram operation to n8n as dropdowns, with no HTTP Request setup. It also works as a tool for n8n AI Agents.

1In n8n, open Settings → Community Nodes and select Install.
2Enter n8n-nodes-socialapis and confirm.
3Add a SocialAPIs node and create a credential with your API key.

npm ↗GitHub ↗

Listings

Find us on

The SocialAPIs MCP server is listed in these directories and marketplaces.

Frequently Asked Questions

Quick answers about MCP, the SDKs and n8n

An MCP (Model Context Protocol) server that gives AI assistants 47 read-only tools for public Facebook and Instagram data: pages, posts, comments, groups, the Ads Library, Marketplace, Instagram profiles, posts, reels and locations. Claude, Cursor, VS Code, Cline and other MCP clients can call them directly.

No. Clients that support remote MCP servers connect to https://mcp.socialapis.io/mcp with your API key in the Authorization header. For clients that only run local servers, such as Claude Desktop, use npx @socialapis/mcp (needs Node.js 18+).

MCP tool calls, SDK calls and n8n calls all use the same credits as the REST API. The free plan includes 200 credits a month with no credit card. Each tool description states its price.

The key goes in a request header, never in the URL, so it doesn't end up in server logs. Keep config files with your key out of version control; in VS Code, use the input prompt shown above so the key isn't written to the file at all.

Facebook and Instagram today. The MCP server, SDKs and n8n node all cover the same endpoints as the REST API.

One key for everything

MCP, SDKs, n8n and the REST API. 200 free calls a month, no credit card.

Get a free API key Read the docs

{ "servers": { "socialapis": { "type": "http", "url": "https://mcp.socialapis.io/mcp", "headers": { "Authorization": "Bearer ${input:socialapis-key}" } } }, "inputs": [ { "type": "promptString", "id": "socialapis-key", "description": "SocialAPIs API key", "password": true } ] }

{ "mcpServers": { "socialapis": { "type": "streamableHttp", "url": "https://mcp.socialapis.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

from socialapis import Facebook, Instagram fb = Facebook(api_token="YOUR_API_KEY") page = fb.get_page_info("nike") print(page.title, page.followers_count) ig = Instagram(api_token="YOUR_API_KEY") profile = ig.get_profile_details("nike") print(profile.username, profile.followers_count)

import { Facebook, Instagram } from "socialapis-sdk"; const fb = new Facebook({ apiToken: "YOUR_API_KEY" }); const page = await fb.getPageInfo("nike"); console.log(page.title, page.followers_count); const ig = new Instagram({ apiToken: "YOUR_API_KEY" }); const profile = await ig.getProfileDetails("nike"); console.log(profile.username, profile.followers_count);

fb, err := socialapis.NewFacebook("YOUR_API_KEY") if err != nil { log.Fatal(err) } page, err := fb.GetPageInfo(context.Background(), "nike", nil) if err != nil { log.Fatal(err) } fmt.Println(page.Title, page.FollowersCount)