bn-facebook-mcp-server 0.0.1

package/tools.json

@@ -0,0 +1,108 @@
+{
+  "get_me": {
+    "name": "get_me",
+    "description": "Get the current user's Facebook profile information.\n\n**Use Cases:**\n- Verify the authenticated user\n- Get user's name, email, profile picture\n- Check what user data is accessible\n\n**Required Permission:** public_profile (always granted)\n**Optional Permission:** email (for email field)\n\n**Returns:** User profile with id, name, email (if permitted), profile picture URL.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of user profile fields.\n\n**Default:** \"id,name,email,first_name,last_name,picture.width(200).height(200)\"\n\n**Available Fields:**\n- id - Facebook user ID\n- name - Full name\n- email - Primary email (requires email permission)\n- first_name, last_name - Name parts\n- picture - Profile picture URL\n- birthday, gender, hometown, location (if permissions allow)"
+        }
+      }
+    }
+  },
+  "get_friends": {
+    "name": "get_friends",
+    "description": "Get list of user's Facebook friends.\n\n**Use Cases:**\n- See friends who also use the app\n- Get friend profile info\n\n**Required Permission:** user_friends\n\n**Note:** Only returns friends who have also authorized the app.\n\n**Returns:** Array of friends with id, name, and profile picture.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Maximum friends to retrieve (1-100).\n\n**Default:** 25"
+        },
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of friend fields.\n\n**Default:** \"id,name,picture\""
+        }
+      }
+    }
+  },
+  "get_photos": {
+    "name": "get_photos",
+    "description": "Get user's uploaded photos.\n\n**Use Cases:**\n- Browse user's photo albums\n- Get photo URLs and metadata\n\n**Required Permission:** user_photos\n\n**Returns:** Array of photos with id, name, URLs, and timestamps.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Maximum photos to retrieve (1-100).\n\n**Default:** 25"
+        },
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of photo fields.\n\n**Default:** \"id,name,picture,created_time,link,images\""
+        }
+      }
+    }
+  },
+  "get_user_posts": {
+    "name": "get_user_posts",
+    "description": "Get user's timeline posts.\n\n**Use Cases:**\n- Browse user's posts\n- Analyze engagement metrics\n- Get post content and media\n\n**Required Permission:** user_posts\n\n**Returns:** Array of posts with content, engagement metrics, and timestamps.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Maximum posts to retrieve (1-100).\n\n**Default:** 25"
+        },
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of post fields.\n\n**Default:** \"id,message,story,created_time,full_picture,permalink_url,shares,likes.summary(true),comments.summary(true)\""
+        }
+      }
+    }
+  },
+  "get_videos": {
+    "name": "get_videos",
+    "description": "Get user's uploaded videos.\n\n**Use Cases:**\n- Browse user's video library\n- Get video URLs and metadata\n\n**Required Permission:** user_videos\n\n**Returns:** Array of videos with id, title, description, and thumbnails.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Maximum videos to retrieve (1-100).\n\n**Default:** 25"
+        },
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of video fields.\n\n**Default:** \"id,title,description,created_time,permalink_url,thumbnails,length\""
+        }
+      }
+    }
+  },
+  "get_likes": {
+    "name": "get_likes",
+    "description": "Get pages/things the user has liked.\n\n**Use Cases:**\n- See user's interests\n- Get liked page information\n\n**Required Permission:** user_likes\n\n**Returns:** Array of liked pages with id, name, category, and fan count.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "limit": {
+          "type": "number",
+          "description": "Maximum liked pages to retrieve (1-100).\n\n**Default:** 25"
+        },
+        "fields": {
+          "type": "string",
+          "description": "Comma-separated list of page fields.\n\n**Default:** \"id,name,category,picture,fan_count\""
+        }
+      }
+    }
+  },
+  "get_permissions": {
+    "name": "get_permissions",
+    "description": "Get list of permissions granted to the current access token.\n\n**Use Cases:**\n- Verify what data you can access\n- Debug permission-related errors\n- Check if user granted required permissions\n\n**No parameters required.**\n\n**Returns:** Array of permission objects with name and status (granted/declined).",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  }
+}