Store Facebook Graph API credentials and validate them immediately.

Saves the given values to ~/.facebook-automata-mcp/credentials.json (merged with any previously stored fields) and validates the access_token by calling GET /me. Use this once before using any other tool.

Args: access_token: A Facebook User, Page, or App access token (long-lived tokens recommended). Required. app_id: Your Facebook App ID (optional, enables token introspection via /debug_token). app_secret: Your Facebook App Secret (optional, used together with app_id for /debug_token introspection; never sent anywhere except graph.facebook.com). page_id: A default Facebook Page ID to use for tools where page_id is not explicitly supplied. api_version: Graph API version to target, e.g. "v21.0" (defaults to v21.0 if omitted).

Check whether Facebook credentials are configured and still valid.

Loads credentials from ~/.facebook-automata-mcp/credentials.json (or FACEBOOK_MCP_* environment variables), calls GET /me to confirm the access token still works, and — if app_id/app_secret are also configured — calls /debug_token to report scopes, expiry, and whether the token is still valid according to Facebook.

Quickly report whether credentials exist on disk, without any network call.

Delete the stored credentials file (~/.facebook-automata-mcp/credentials.json).

Get the profile of the identity behind the configured access token (GET /me).

Note: Facebook heavily restricts which fields are available for personal user tokens without app review (usually just id, name, picture). Page tokens will return the Page's own info.

Get public profile info for a given Facebook user or page ID.

Note: Modern Graph API restricts most personal fields for non-consenting users; only public fields (id, name, picture, etc.) are typically returned unless you have specific permissions/roles.

List the Facebook Pages managed by the current user token (GET /me/accounts).

Useful to discover page_id values and their page-scoped access tokens (returned in the 'access_token' field of each item).

Search public Facebook Pages by name/keyword (GET /search?type=page).

Get details about a Facebook Page (name, about, category, fan_count, etc.).

If page_id is omitted, uses the default page_id stored via 'set_facebook_credentials'.

List posts published BY a Page (GET /{page-id}/posts).

since/until accept Unix timestamps or strtotime-compatible strings (e.g. "2026-01-01").

List the Page's feed: own posts + posts/links from others on the Page (GET /{page-id}/feed).

List posts the Page has been tagged in (GET /{page-id}/tagged).

List events hosted by the Page (GET /{page-id}/events).

List photos posted by the Page (GET /{page-id}/photos?type=uploaded).

List videos posted by the Page (GET /{page-id}/videos).

List photo albums on the Page (GET /{page-id}/albums).

Get Page analytics/insights (GET /{page-id}/insights).

Requires the Page access token to have the read_insights permission. metric is a comma-separated list, e.g. "page_impressions,page_engaged_users,page_fans,page_views_total". period is one of: day, week, days_28, month, lifetime.

Get full details of a single post by its ID (GET /{post-id}).

Publish a new post on a Page (POST /{page-id}/feed).

Set published=False and provide scheduled_publish_time (a future Unix timestamp) to schedule the post instead of publishing immediately.

Delete a post by ID (DELETE /{post-id}). Requires ownership permissions.

List comments on a post, including who commented (GET /{post-id}/comments).

order: "chronological" or "reverse_chronological". filter: "toplevel" (top-level comments only) or "stream" (include replies inline). Each comment item includes 'from' with the commenter's id/name.

Get details of a single comment by ID (GET /{comment-id}).

List replies to a comment (GET /{comment-id}/comments).

Post a new top-level comment on a post (POST /{post-id}/comments).

Reply to an existing comment (POST /{comment-id}/comments).

Delete a comment by ID (DELETE /{comment-id}).

Hide or unhide a comment on your Page's post (POST /{comment-id}?is_hidden=...).

List people who liked a post, including their id/name (GET /{post-id}/likes).

List reactions on a post with who reacted and how (GET /{post-id}/reactions).

reaction_type filters to one of: LIKE, LOVE, WOW, HAHA, SAD, ANGRY, THANKFUL, CARE. Omit to get all reaction types (each item includes a 'type' field showing which reaction the person used).

List people who liked a comment (GET /{comment-id}/likes).

List reactions on a comment with who reacted and how (GET /{comment-id}/reactions).

Like a post/comment/object as the current identity (POST /{object-id}/likes).

Remove a previously placed like (DELETE /{object-id}/likes).

Upload a photo to a Page from a public image URL (POST /{page-id}/photos).

Upload a video to a Page from a public video URL (POST /{page-id}/videos).

Generic GET against any Graph API edge, e.g. edge="{id}/comments".

Use this for any endpoint not covered by a dedicated tool. params is passed through as query parameters (do not include access_token).

Generic POST against any Graph API edge, e.g. edge="{id}/feed".

Generic DELETE against any Graph API edge, e.g. edge="{post-id}".