Facebook

{
  "service_type": "platform",
  "base_url": "https://developers.facebook.com",
  "auth_method": "oauth2",
  "auth_config": {
    "type": "oauth2",
    "authorization_url": "https://www.facebook.com/v22.0/dialog/oauth",
    "token_url": "https://graph.facebook.com/v22.0/oauth/access_token",
    "scopes": ["public_profile", "email", "pages_manage_posts", "ads_management", "business_management", "whatsapp_business_messaging", "instagram_basic"],
    "grant_type": "authorization_code",
    "additional": "Requires App ID and App Secret. Access tokens are short-lived; refresh via long-lived token endpoint or use system user tokens for server-to-server."
  },
  "endpoints": [
    {
      "name": "Graph API",
      "path": "https://graph.facebook.com/v22.0",
      "method": "GET/POST/DELETE",
      "description": "Main endpoint for Facebook Login, Pages, Groups, Events, and app data. Supports partial response, fields, and pagination.",
      "auth": "Access token (short-lived or long-lived user/system token)"
    },
    {
      "name": "Marketing API",
      "path": "https://graph.facebook.com/v22.0/act_<AD_ACCOUNT_ID>/",
      "method": "GET/POST",
      "description": "Ad management: campaigns, ad sets, ads, insights, audiences. Requires ads_management permission and ad account ID.",
      "auth": "Access token (user token with ads_management, or system user token)"
    },
    {
      "name": "WhatsApp Cloud API",
      "path": "https://graph.facebook.com/v22.0/<PHONE_NUMBER_ID>/messages",
      "method": "POST",
      "description": "Send and receive WhatsApp messages. Requires a WhatsApp Business Account and a phone number ID. Messaging via cloud, no on-prem hosting.",
      "auth": "Permanent access token (from WhatsApp Business Account) or system user token"
    },
    {
      "name": "Threads API",
      "path": "https://graph.threads.net/v1.0",
      "method": "GET/POST",
      "description": "Publish and manage Threads posts, retrieve insights. Requires Threads app setup and user access token.",
      "auth": "OAuth2 access token (Threads-specific)"
    },
    {
      "name": "Instagram Basic Display API",
      "path": "https://graph.instagram.com/v22.0",
      "method": "GET",
      "description": "Fetch user profile, media, and insights for Instagram business/creator accounts. Deprecated in favor of Instagram Graph API for business purposes.",
      "auth": "Access token (long-lived user token with instagram_basic)"
    },
    {
      "name": "Meta MCP Server",
      "path": "npm:@meta/ads-mcp",
      "description": "Model Context Protocol endp for agents to query and manage ad campaigns via natural language. Allows self-identification in User-Agent header.",
      "auth": "Access token (stored in MCP session)"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": "Facebook Login, Sharing, Social Plugins, and some APIs are free. WhatsApp Cloud API is free for business messaging. Ads on Facebook are pay-per-use (bidding on campaigns).",
      "paid": "Marketing API usage is free but ads spend is charged based on impressions/actions. Advanced features (e.g., audience insights, detailed targeting) are free. Taxes may apply. There is no monthly fee for API access."
    }
  },
  "rate_limits": {
    "graph_api": "Default per-hour limit per app based on number of engaged users. Standard limit: 200 calls/user/hour. For pages, 200 requests/hour per page. Burst limits apply.",
    "marketing_api": "Rate limiting based on ad account spend. Tiers: up to $25M/month public limit. Each tier has different call caps. See docs for exact thresholds.",
    "whatsapp": "Message throughput: up to 80 messages per second for high quality and high volume. Threading limits.",
    "instagram": "200 requests per hour per user (similar to Graph API).",
    "general": "Use exponential backoff on 429 and 5xx errors. Consult developer docs for rate limit headers."
  },
  "capabilities": [
    "Facebook Login (OAuth 2.0 authentication and user authorization)",
    "Social plugins (like/share buttons, embedded posts)",
    "Graph API for pages, groups, events, user data",
    "Marketing API for ads campaign management, analytics, and audience targeting",
    "WhatsApp Business platform with Cloud API for messaging (text, media, interactive)",
    "Threads API for publishing and insights",
    "Meta MCP server for agent-based ad management",
    "Instagram Graph API for business account content and insights",
    "Analytics and insights APIs (Page Insights, Ad Insights, Post Insights)",
    "Webhooks for real-time event notifications (e.g., page changes, message arrival)",
    "Token management (long-lived, short-lived, system user tokens)"
  ],
  "raw_analysis": "The Facebook Developer Platform is a comprehensive ecosystem managed by Meta, offering a wide range of APIs and tools for social integration, advertising, and messaging. It supports OAuth-based authentication (Facebook Login), social plugins,

3/3 tests passed

{
  "overall": 68,
  "dimensions": {
    "token_efficiency": 7.0,
    "first_try_success": 6.0,
    "response_parseability": 7.5,
    "error_clarity": 6.0,
    "doc_quality": 7.5,
    "auth_simplicity": 6.5,
    "latency": 6.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier": "Free for authentication, sharing, and WhatsApp Cloud API; ads are pay-per-use",
    "entry_cost": 0,
    "notes": "No monthly API access fee; only ad spend charges if using ads"
  },
  "issues": [
    "LLMs.txt exists but only provides high-level section links without full API reference content",
    "Robots.txt explicitly prohibits automated data collection without written permission, which may concern agents",
    "Main developers site latency of 1.7s is above the ideal 500ms threshold",
    "OAuth flow requires app registration and multiple token types (long-lived, short-lived, system user), adding complexity"
  ],
  "recommendations": [
    "For basic tasks like social login or fetching public page data, agents can rely on the free tier without ads",
    "Use llms.txt to quickly navigate to API docs sections for user lookup or page insights",
    "For advertising or marketing tasks, agents should be prepared for complex bid management and policy constraints",
    "Prefer the Meta MCP server for agent-based ad management to abstract some API complexity"
  ]
}