facebook-page-insights
Read Facebook Fanpage information, published posts, engagement counts, comments, reactions, and Page/Post Insights.
Connect this API to an AI agent Browse all specs
What you can do with facebook-page-insights via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /{pageId} |
getFacebookPage | Get detailed information for a Fanpage |
| GET | /{pageId}/published_posts |
listFacebookPagePosts | List posts published by a Fanpage |
| GET | /{pageId}/insights |
getFacebookPageInsights | Read Page-level Insights |
| GET | /{postId} |
getFacebookPost | Get detailed information for a Page post |
| GET | /{postId}/comments |
listFacebookPostComments | List comments on a Page post |
| GET | /{postId}/reactions |
listFacebookPostReactions | List reactions on a Page post |
| GET | /{postId}/insights |
getFacebookPostInsights | Read Post-level Insights |
Authentication
FacebookPageToken
Bearer token — sent as Authorization: Bearer <token>
Paste the raw Page Access Token (not a User token alone). Prefer a long-lived Page token. Required permissions: read_insights, pages_read_engagement; also pages_read_user_content for comments/content. Token owner must have ANALYZE task on the Page for Insights. Short-lived tokens expire in about 1–2 hours (Graph error 190/463). For multi-page agents, each install must use the token for the same Page as its pinned pageId.
Usage guide
Authentication Request
Authentication requires a Page Access Token for a Page managed by the token owner.
Note: This template is read-only and contains GET operations only.
Required Permissions
To proceed, please ensure the following permissions are granted to your app:
pages_show_listpages_read_engagementpages_read_user_contentread_insights
How to Get a Page Access Token
Follow these steps using the Meta Graph API Explorer:
Open Graph API Explorer
- Go to the Meta Graph API Explorer.
- Select your Meta App from the Meta App dropdown in the right panel.
Add Required Permissions
- In the Permissions section, click Add a Permission.
- Add the following four permissions:
pages_show_listpages_read_engagementpages_read_user_contentread_insights
Generate User Access Token
- Click Generate Access Token.
- Log in to Facebook and select the Page(s) you want to manage.
- Accept the requested permissions to return a short-lived User Access Token.
Exchange for a Page Access Token
- In the User or Page dropdown, select the specific Facebook Page you want to access.
- The token displayed in the Access Token field will automatically update to a Page Access Token.
Note for Production: Tokens generated via the Graph API Explorer are short-lived. For permanent or automated integrations, exchange your short-lived User Access Token for a Long-Lived User Access Token via the
oauth/access_tokenendpoint, then query/{page-id}?fields=access_tokento get a Never-Expiring Page Access Token.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “facebook-page-insights” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.