# Facebook Pages

MCP server for Facebook Pages API — manage posts, comments, photos, videos, insights, and Messenger conversations through 28 tools.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add node2flow/facebook-pages

# Browse available tools
npx -y @smithery/cli@latest tool list node2flow/facebook-pages

# Get full schema for a tool
npx -y @smithery/cli@latest tool get node2flow/facebook-pages fb_list_pages

# Call a tool
npx -y @smithery/cli@latest tool call node2flow/facebook-pages fb_list_pages '{}'
```

## Direct MCP Connection

Endpoint: `https://facebook-pages--node2flow.run.tools`

**Required config:**
- `FACEBOOK_PAGE_ACCESS_TOKEN` (query) — Facebook Page Access Token (long-lived or never-expiring)

**Optional config:**
- `FACEBOOK_PAGE_ID` (query) — Facebook Page ID (optional — auto-detected from token if not provided)

## Tools (28)

- `fb_list_pages` — List all Facebook Pages the user manages. Returns page ID, name, category, and access token for each page. Use this to …
- `fb_get_page` — Get detailed information about a Facebook Page: name, category, followers, fan count, about, description, website, and …
- `fb_get_page_token` — Get the Page Access Token for a specific page. Useful when managing multiple pages — each page has its own token.
- `fb_list_posts` — List posts from a Facebook Page feed. Returns post ID, message, creation time, picture, and permalink. Supports paginat…
- `fb_get_post` — Get details of a single Facebook post by ID. Returns message, creation time, picture, permalink, and engagement counts.
- `fb_create_post` — Create a new post on a Facebook Page. Can include text message and/or link. Set published=false to create an unpublishe…
- `fb_update_post` — Update the text message of an existing Facebook post. Only the message field can be edited after creation.
- `fb_delete_post` — Permanently delete a Facebook post. This action cannot be undone.
- `fb_schedule_post` — Schedule a post to be published at a future time. The scheduled_time must be between 10 minutes and 75 days from now (U…
- `fb_list_comments` — List comments on a Facebook post or object. Returns comment ID, message, author, time, like count, and hidden status.
- `fb_create_comment` — Add a comment to a Facebook post. The page will be shown as the comment author.
- `fb_reply_comment` — Reply to an existing comment. Creates a threaded reply under the specified comment.
- `fb_delete_comment` — Permanently delete a comment. This action cannot be undone.
- `fb_hide_comment` — Hide or unhide a comment. Hidden comments are only visible to the author and page admins. Useful for moderation.
- `fb_upload_photo` — Upload a photo to a Facebook Page from a URL. Can include a caption. Set published=false for an unpublished photo (use …
- `fb_list_photos` — List photos uploaded to a Facebook Page. Returns photo ID, name, link, creation time, and image URLs at various sizes.
- `fb_delete_photo` — Permanently delete a photo from a Facebook Page.
- `fb_upload_video` — Upload a video to a Facebook Page from a URL. Supports title and description. For large videos (>1GB), use chunked uplo…
- `fb_list_videos` — List videos uploaded to a Facebook Page. Returns video ID, title, description, creation time, duration, and source URL.
- `fb_delete_video` — Permanently delete a video from a Facebook Page.
- `fb_get_page_insights` — Get analytics metrics for a Facebook Page. Common metrics: page_impressions, page_engaged_users, page_post_engagements,…
- `fb_get_post_insights` — Get analytics for a specific post. Common metrics: post_impressions, post_engaged_users, post_clicks, post_reactions_by…
- `fb_get_page_fans` — Get total fan (follower) count for a Facebook Page over time. Returns daily values showing the total page likes.
- `fb_get_page_views` — Get page view count over time. Returns total number of times the Page profile was viewed.
- `fb_list_conversations` — List Messenger conversations for a Facebook Page. Returns conversation ID, last update time, snippet, message count, an…
- `fb_get_messages` — Get messages from a specific Messenger conversation. Returns message ID, text, sender, and time.
- `fb_send_message` — Send a text message via Messenger to a user. Requires the recipient PSID (Page-Scoped ID). Note: 24-hour messaging wind…
- `fb_send_typing` — Show or hide the typing indicator in Messenger. Use before sending a message for a more natural conversation feel.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get node2flow/facebook-pages <tool-name>
```

## Resources

- `facebook://server-info` — Connection status and available tools for this Facebook Pages MCP server

## Prompts (2)

- `manage-page` — Guide for managing Facebook Page content: posts, photos, videos, and comments
- `page-analytics` — Guide for viewing Facebook Page insights and analytics

---

License: MIT
