facebook-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FB_APP_ID | No | Meta app id, used by facebook-mcp-token to extend user tokens. | |
| FB_PAGE_ID | No | Default Facebook Page id. | |
| FB_APP_SECRET | No | Meta app secret, used by facebook-mcp-token to extend user tokens. | |
| FB_MCP_ENV_FILE | No | Explicit path to a .env file. | |
| FACEBOOK_PAGE_ID | No | Alias for FB_PAGE_ID. | |
| FB_MCP_LOG_LEVEL | No | Log level (DEBUG, INFO, WARNING, etc.); logs go to stderr. | INFO |
| FB_MCP_READ_ONLY | No | Set to 1 to hide every publish/schedule/delete tool. | |
| FB_MCP_SKIP_DOTENV | No | Set to 1 to ignore all .env files. | |
| FB_MCP_ALLOWED_DIRS | No | Folders (separated by :, or ; on Windows) that local photos/videos must live in. | |
| FB_PAGE_ACCESS_TOKEN | No | Facebook Page access token. | |
| FB_USER_ACCESS_TOKEN | No | User token for fb_list_pages and facebook-mcp-token. | |
| META_GRAPH_API_VERSION | No | Graph API version. | v24.0 |
| FACEBOOK_PAGE_ACCESS_TOKEN | No | Alias for FB_PAGE_ACCESS_TOKEN. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Manage a Facebook Page through the Meta Graph API.
Read tools: fb_get_page_info, fb_get_recent_posts, fb_get_scheduled_posts, fb_get_page_insights, fb_get_post_insights, fb_list_pages.
Write tools (absent when FB_MCP_READ_ONLY=1): fb_publish_post, fb_publish_video, fb_reschedule_post, fb_publish_scheduled_now, fb_delete_post. Publishing and deleting are public and irreversible: confirm the exact content, target Page and time with the user before calling a write tool. Scheduled times are UNIX timestamps in seconds, at least 10 minutes in the future.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| fb_list_pagesA | List the Facebook Pages the user manages: id, name, category, followers, tasks. Needs a USER access token with pages_show_list (FB_USER_ACCESS_TOKEN by default). Page access tokens are never returned; use the get-token CLI to store one. :param user_access_token: Optional user token; defaults to FB_USER_ACCESS_TOKEN. |
| fb_get_page_infoB | Get Page details: name, likes (fan_count), followers, link, about, category, picture. :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token; defaults to FB_PAGE_ACCESS_TOKEN. |
| fb_get_recent_postsA | List the Page's latest published posts with reactions, comments and shares. :param limit: Number of posts (1-100, default 10). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token. |
| fb_get_scheduled_postsA | List posts scheduled but not yet published, sorted by publish time (up to 500). :param limit: Page size per Graph request (1-100, default 100). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token. |
| fb_get_page_insightsB | Page analytics. Default metrics: page_post_engagements, page_daily_follows_unique, page_follows, page_views_total, page_media_view, page_total_media_view_unique, page_video_views. Metrics Meta has retired are listed in metric_errors. :param period: day, week, days_28, month, lifetime or total_over_range. :param metrics: Optional custom metric names. :param since: Optional start (YYYY-MM-DD or UNIX seconds). :param until: Optional end (YYYY-MM-DD or UNIX seconds). :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token. |
| fb_get_post_insightsB | Stats for one post or video: reactions/comments/shares plus reactions by type, clicks, media views, unique viewers, video views and view time. :param post_id: Post id ("{page_id}_{post_id}") or video id. :param page_access_token: Optional Page token. |
| fb_publish_postA | Publish or schedule a Page post: text, text + link, or photo (local file or URL). This is public: confirm content and timing with the user first. :param message: Post text / photo caption. :param link: Optional URL to attach (text posts only). :param photo_path: Optional local image path (jpg, png, gif, webp...). :param photo_url: Optional public image URL. Use photo_path or photo_url, not both. :param scheduled_publish_time: Optional UNIX seconds, at least 10 minutes ahead. :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token. |
| fb_publish_videoA | Upload a local video to the Page, now or scheduled. This is public: confirm first. as_reel=True uses the Reels API (Meta's Reels specs apply: vertical 9:16, short duration); if the Page cannot post Reels, it falls back to a regular Page video and says so in "note". as_reel=False uploads a regular Page video; files over 50 MB use chunked upload. :param video_path: Local video path (mp4, mov, ...). :param description: Caption. :param title: Optional title (regular Page videos only; ignored for Reels). :param as_reel: Reel (default) or regular Page video. :param scheduled_publish_time: Optional UNIX seconds, at least 10 minutes ahead. :param page_id: Optional Page id; defaults to FB_PAGE_ID. :param page_access_token: Optional Page token. |
| fb_reschedule_postA | Change the publish time of a scheduled post or video. :param post_id: Id of the scheduled post/video. :param new_scheduled_time_unix: New time, UNIX seconds, at least 10 minutes ahead. :param page_access_token: Optional Page token. |
| fb_publish_scheduled_nowA | Publish a scheduled post immediately. This is public: confirm first. :param post_id: Id of the scheduled post. :param page_access_token: Optional Page token. |
| fb_delete_postA | Permanently delete a post or video from the Page. Irreversible: confirm first. :param post_id: Id of the post/video to delete. :param page_access_token: Optional Page token. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool targets a distinct resource and action: page info vs. page list, recent vs. scheduled posts, page vs. post insights, and publish/reschedule/publish-now/delete operations are clearly separated. The publish_post and publish_video tools overlap only in the broad verb but are cleanly distinguished by media type.
All tools use a consistent fb_ prefix and snake_case verb_noun naming, such as fb_get_page_info, fb_publish_post, and fb_delete_post. Minor variation like fb_publish_scheduled_now is still readable and follows the same overall convention.
Eleven tools is well-scoped for Facebook Page management, covering page discovery, post listing, publishing, scheduling, insights, and deletion without excessive surface area. Each tool appears to earn its place.
The set covers the core Page publishing lifecycle: page info/list, recent and scheduled posts, insights, text/photo/video publishing, rescheduling, immediate publishing, and deletion. Minor gaps remain around comment moderation/replies and editing existing post content, which agents may need for full social management.