facebook

Facebook Graph API

Server path: /facebook | Type: Application | PCID required: Yes

Tools

Tool	Description
facebook_create_comment	Add a comment to a post
facebook_create_page_post	Create a post on a page
facebook_get_me	Get authenticated user profile
facebook_get_page	Get page information
facebook_get_page_insights	Get page insights and analytics
facebook_list_page_posts	List posts on a page
facebook_list_post_comments	Get comments on a post
facebook_list_user_pages	List pages managed by a user

---

facebook_create_comment

Add a comment to a post

Parameters:

Parameter	Type	Required	Default	Description
post_id	string	Yes	—	The ID of the post to comment on
message	string	Yes	—	The text content of the comment

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "post_id": {
      "type": "string",
      "description": "The ID of the post to comment on"
    },
    "message": {
      "type": "string",
      "description": "The text content of the comment"
    }
  },
  "required": [
    "PCID",
    "post_id",
    "message"
  ]
}

---

facebook_create_page_post

Create a post on a page

Parameters:

Parameter	Type	Required	Default	Description
page_id	string	Yes	—	The ID of the Facebook Page to post to
link	string	No	—	A URL to share in the post
message	string	No	—	The text content of the post
published	boolean	No	—	Whether the post should be published immediately (default true). Set to false to create an unpublished/draft post.
scheduled_publish_time	integer	No	—	Unix timestamp for when to publish the post (requires published=false). Must be between 10 minutes and 30 days from now.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page_id": {
      "type": "string",
      "description": "The ID of the Facebook Page to post to"
    },
    "link": {
      "type": "string",
      "description": "A URL to share in the post"
    },
    "message": {
      "type": "string",
      "description": "The text content of the post"
    },
    "published": {
      "type": "boolean",
      "description": "Whether the post should be published immediately (default true). Set to false to create an unpublished/draft post."
    },
    "scheduled_publish_time": {
      "type": "integer",
      "description": "Unix timestamp for when to publish the post (requires published=false). Must be between 10 minutes and 30 days from now."
    }
  },
  "required": [
    "PCID",
    "page_id"
  ]
}

---

facebook_get_me

Get authenticated user profile

Parameters:

Parameter	Type	Required	Default	Description
fields	string	No	—	Comma-separated list of fields to return (e.g. id,name,email,picture)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. id,name,email,picture)"
    }
  },
  "required": [
    "PCID"
  ]
}

---

facebook_get_page

Get page information

Parameters:

Parameter	Type	Required	Default	Description
page_id	string	Yes	—	The ID of the Facebook Page
fields	string	No	—	Comma-separated list of fields to return (e.g. name,category,fan_count,about,description,website)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page_id": {
      "type": "string",
      "description": "The ID of the Facebook Page"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. name,category,fan_count,about,description,website)"
    }
  },
  "required": [
    "PCID",
    "page_id"
  ]
}

---

facebook_get_page_insights

Get page insights and analytics

Parameters:

Parameter	Type	Required	Default	Description
page_id	string	Yes	—	The ID of the Facebook Page
metric	string	Yes	—	Comma-separated list of metrics to retrieve (e.g. page_impressions,page_engaged_users,page_fans,page_views_total,page_post_engagements)
period	string	No	—	Aggregation period: day, week, days_28, month, lifetime, total_over_range
since	string	No	—	Unix timestamp or date string for the start of the date range
until	string	No	—	Unix timestamp or date string for the end of the date range

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page_id": {
      "type": "string",
      "description": "The ID of the Facebook Page"
    },
    "metric": {
      "type": "string",
      "description": "Comma-separated list of metrics to retrieve (e.g. page_impressions,page_engaged_users,page_fans,page_views_total,page_post_engagements)"
    },
    "period": {
      "type": "string",
      "description": "Aggregation period: day, week, days_28, month, lifetime, total_over_range",
      "enum": [
        "day",
        "week",
        "days_28",
        "month",
        "lifetime",
        "total_over_range"
      ]
    },
    "since": {
      "type": "string",
      "description": "Unix timestamp or date string for the start of the date range"
    },
    "until": {
      "type": "string",
      "description": "Unix timestamp or date string for the end of the date range"
    }
  },
  "required": [
    "PCID",
    "page_id",
    "metric"
  ]
}

---

facebook_list_page_posts

List posts on a page

Parameters:

Parameter	Type	Required	Default	Description
page_id	string	Yes	—	The ID of the Facebook Page
fields	string	No	—	Comma-separated list of fields to return (e.g. id,message,created_time,permalink_url,shares,likes.summary(true))
limit	integer	No	—	Maximum number of posts to return (default 25, max 100)
after	string	No	—	Cursor for pagination (from previous response’s paging.cursors.after)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "page_id": {
      "type": "string",
      "description": "The ID of the Facebook Page"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. id,message,created_time,permalink_url,shares,likes.summary(true))"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of posts to return (default 25, max 100)"
    },
    "after": {
      "type": "string",
      "description": "Cursor for pagination (from previous response's paging.cursors.after)"
    }
  },
  "required": [
    "PCID",
    "page_id"
  ]
}

---

facebook_list_post_comments

Get comments on a post

Parameters:

Parameter	Type	Required	Default	Description
post_id	string	Yes	—	The ID of the post
fields	string	No	—	Comma-separated list of fields to return (e.g. id,message,from,created_time,like_count)
limit	integer	No	—	Maximum number of comments to return
after	string	No	—	Cursor for pagination (from previous response’s paging.cursors.after)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "post_id": {
      "type": "string",
      "description": "The ID of the post"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. id,message,from,created_time,like_count)"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of comments to return"
    },
    "after": {
      "type": "string",
      "description": "Cursor for pagination (from previous response's paging.cursors.after)"
    }
  },
  "required": [
    "PCID",
    "post_id"
  ]
}

---

facebook_list_user_pages

List pages managed by a user

Parameters:

Parameter	Type	Required	Default	Description
user_id	string	Yes	—	The user ID, or ‘me’ for the authenticated user
fields	string	No	—	Comma-separated list of fields to return (e.g. name,access_token,category,id)
limit	integer	No	—	Maximum number of pages to return
after	string	No	—	Cursor for pagination (from previous response’s paging.cursors.after)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "user_id": {
      "type": "string",
      "description": "The user ID, or 'me' for the authenticated user"
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated list of fields to return (e.g. name,access_token,category,id)"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of pages to return"
    },
    "after": {
      "type": "string",
      "description": "Cursor for pagination (from previous response's paging.cursors.after)"
    }
  },
  "required": [
    "PCID",
    "user_id"
  ]
}