@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/facebook-api.json

@@ -0,0 +1,282 @@
+{
+  "slug": "facebook-api",
+  "name": "Facebook Pages",
+  "description": "MCP server for Facebook Graph API operations including page management, post publishing, and social media analytics",
+  "logo": "https://www.google.com/s2/favicons?domain=www.facebook.com&sz=128",
+  "categories": [
+    "facebook",
+    "meta",
+    "social-media",
+    "pages",
+    "posts"
+  ],
+  "base_url": "",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "API Key"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "post_to_page",
+      "description": "Post text, links, or photos to a Facebook page. For IMAGE/PHOTO posts, use the 'image' parameter with a public URL - do NOT use 'link' for images. The 'link' parameter is only for sharing webpage URLs. For video uploads, use facebook-api-post-video instead.",
+      "method": "POST",
+      "path": "/post-to-page",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageId": {
+            "type": "string",
+            "description": "Facebook page ID"
+          },
+          "message": {
+            "type": "string",
+            "description": "Post message content (used as caption for photos)"
+          },
+          "image": {
+            "type": "string",
+            "description": "Image/photo URL to post (must be publicly accessible). Use this for posting images - NOT the 'link' parameter."
+          },
+          "link": {
+            "type": "string",
+            "description": "Webpage URL to share (NOT for images - use 'image' parameter for photos)"
+          },
+          "photos": {
+            "type": "array",
+            "description": "Array of photo URLs for multi-image posts (must be publicly accessible)",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "pageId"
+        ]
+      }
+    },
+    {
+      "name": "post_video",
+      "description": "Upload and post a video to a Facebook page using a publicly accessible URL. Uses graph-video.facebook.com for proper video handling. Videos must be under 1GB and 20 minutes.",
+      "method": "POST",
+      "path": "/post-video",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageId": {
+            "type": "string",
+            "description": "Facebook page ID"
+          },
+          "file_url": {
+            "type": "string",
+            "description": "Publicly accessible URL to the video file (MP4, MOV, AVI, WMV, FLV supported)"
+          },
+          "title": {
+            "type": "string",
+            "description": "Video title"
+          },
+          "description": {
+            "type": "string",
+            "description": "Video description text"
+          },
+          "thumb": {
+            "type": "string",
+            "description": "URL to custom thumbnail image"
+          }
+        },
+        "required": [
+          "pageId",
+          "file_url"
+        ]
+      }
+    },
+    {
+      "name": "get_page_posts",
+      "description": "List posts from a Facebook page. Get all posts with message content, images, links, and engagement metrics (reactions, comments, shares). Supports pagination and date filtering.",
+      "method": "GET",
+      "path": "/get-page-posts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageId": {
+            "type": "string",
+            "description": "Facebook page ID"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Number of posts to retrieve",
+            "default": 25,
+            "maximum": 100
+          },
+          "fields": {
+            "type": "string",
+            "description": "Comma-separated list of fields to include",
+            "default": "id,message,created_time,full_picture,permalink_url,shares,reactions.summary(true),comments.summary(true)"
+          },
+          "since": {
+            "type": "string",
+            "description": "Unix timestamp or date string to filter posts from"
+          },
+          "until": {
+            "type": "string",
+            "description": "Unix timestamp or date string to filter posts until"
+          },
+          "includeHidden": {
+            "type": "boolean",
+            "description": "Whether to include hidden posts",
+            "default": false
+          }
+        },
+        "required": [
+          "pageId"
+        ]
+      }
+    },
+    {
+      "name": "get_page_insights",
+      "description": "Get analytics data for a Facebook page",
+      "method": "GET",
+      "path": "/get-page-insights",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageId": {
+            "type": "string",
+            "description": "Facebook page ID"
+          },
+          "metrics": {
+            "type": "array",
+            "description": "Metrics to retrieve",
+            "items": {
+              "type": "string"
+            },
+            "default": [
+              "page_fans"
+            ]
+          },
+          "period": {
+            "type": "string",
+            "description": "Time period",
+            "enum": [
+              "day",
+              "week",
+              "days_28"
+            ],
+            "default": "day"
+          },
+          "since": {
+            "type": "string",
+            "description": "Start date (YYYY-MM-DD or Unix timestamp)"
+          },
+          "until": {
+            "type": "string",
+            "description": "End date (YYYY-MM-DD or Unix timestamp)"
+          },
+          "datePreset": {
+            "type": "string",
+            "description": "Predefined date range",
+            "enum": [
+              "today",
+              "yesterday",
+              "this_week",
+              "last_week",
+              "this_month",
+              "last_month"
+            ]
+          }
+        },
+        "required": [
+          "pageId"
+        ]
+      }
+    },
+    {
+      "name": "list_pages",
+      "description": "List all Facebook pages managed by the authenticated user with details like name, category, fan count, and verification status",
+      "method": "GET",
+      "path": "/list-pages",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "fields": {
+            "type": "string",
+            "description": "Comma-separated list of fields to include",
+            "default": "id,name,category,access_token,tasks,fan_count,verification_status,website"
+          }
+        }
+      }
+    },
+    {
+      "name": "facebook_get_post",
+      "description": "Get details of a specific Facebook post including message, creation time, and engagement metrics",
+      "method": "GET",
+      "path": "/facebook-get-post",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "postId": {
+            "type": "string",
+            "description": "Facebook post ID (format: pageId_postId)"
+          },
+          "fields": {
+            "type": "string",
+            "description": "Comma-separated list of fields to include",
+            "default": "id,message,created_time,updated_time"
+          }
+        },
+        "required": [
+          "postId"
+        ]
+      }
+    },
+    {
+      "name": "facebook_update_post",
+      "description": "Update/edit the message content of a Facebook post",
+      "method": "GET",
+      "path": "/facebook-update-post",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "postId": {
+            "type": "string",
+            "description": "Facebook post ID (format: pageId_postId)"
+          },
+          "message": {
+            "type": "string",
+            "description": "New message content for the post"
+          }
+        },
+        "required": [
+          "postId",
+          "message"
+        ]
+      }
+    },
+    {
+      "name": "facebook_delete_post",
+      "description": "Permanently delete a Facebook post from a page",
+      "method": "GET",
+      "path": "/facebook-delete-post",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "postId": {
+            "type": "string",
+            "description": "Facebook post ID (format: pageId_postId)"
+          }
+        },
+        "required": [
+          "postId"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/fal-ai.json

@@ -0,0 +1,400 @@
+{
+  "slug": "fal-ai",
+  "name": "fal.ai",
+  "description": "MCP server for fal.ai generative AI platform - image generation, video, audio, 3D models, and LLMs with fast inference",
+  "logo": "https://fal.ai/favicon.png",
+  "categories": [
+    "ai",
+    "inference",
+    "image-generation",
+    "video",
+    "audio",
+    "3d",
+    "llm",
+    "generative-ai"
+  ],
+  "base_url": "https://fal.run",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Key {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Api Key",
+        "description": "fal.ai API Key (from https://fal.ai/dashboard/keys)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "run",
+      "description": "Run a fal.ai model synchronously and get the result directly. Best for fast models that complete in under 60 seconds (e.g. FLUX image generation, whisper transcription)",
+      "method": "POST",
+      "path": "/%7B%7Bmodel_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_id": {
+            "type": "string",
+            "description": "Model endpoint ID (e.g. fal-ai/flux/dev, fal-ai/fast-sdxl, fal-ai/whisper)"
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Text prompt for generation (for image/video/audio models)"
+          },
+          "image_url": {
+            "type": "string",
+            "description": "Input image URL (for image-to-image, upscaling, or vision models)"
+          },
+          "audio_url": {
+            "type": "string",
+            "description": "Input audio URL (for transcription or audio processing models)"
+          },
+          "image_size": {
+            "type": "object",
+            "description": "Image dimensions {width, height} or preset string like 'landscape_4_3', 'square_hd'",
+            "properties": {
+              "width": {
+                "type": "integer",
+                "description": "Image width in pixels"
+              },
+              "height": {
+                "type": "integer",
+                "description": "Image height in pixels"
+              }
+            }
+          },
+          "num_images": {
+            "type": "integer",
+            "description": "Number of images to generate",
+            "minimum": 1,
+            "maximum": 4,
+            "default": 1
+          },
+          "num_inference_steps": {
+            "type": "integer",
+            "description": "Number of inference steps (higher = better quality, slower)"
+          },
+          "guidance_scale": {
+            "type": "number",
+            "description": "Guidance scale for diffusion models (higher = more prompt adherence)"
+          },
+          "seed": {
+            "type": "integer",
+            "description": "Random seed for reproducible results"
+          },
+          "negative_prompt": {
+            "type": "string",
+            "description": "Negative prompt to avoid certain features in generation"
+          },
+          "loras": {
+            "type": "array",
+            "description": "LoRA weights to apply [{path, scale}]",
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "description": "LoRA model path or URL"
+                },
+                "scale": {
+                  "type": "number",
+                  "description": "LoRA weight scale",
+                  "default": 1
+                }
+              }
+            }
+          },
+          "enable_safety_checker": {
+            "type": "boolean",
+            "description": "Enable safety content filter",
+            "default": true
+          }
+        },
+        "required": [
+          "model_id"
+        ]
+      }
+    },
+    {
+      "name": "queue_submit",
+      "description": "Submit a model request to the fal.ai queue for async processing. Returns a request_id to poll for results. Best for longer-running models (video generation, training, etc.)",
+      "method": "POST",
+      "path": "/%7B%7Bmodel_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_id": {
+            "type": "string",
+            "description": "Model endpoint ID (e.g. fal-ai/flux/dev, fal-ai/minimax-video, fal-ai/kling-video)"
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Text prompt for generation"
+          },
+          "image_url": {
+            "type": "string",
+            "description": "Input image URL"
+          },
+          "audio_url": {
+            "type": "string",
+            "description": "Input audio URL"
+          },
+          "image_size": {
+            "type": "object",
+            "description": "Image dimensions {width, height}",
+            "properties": {
+              "width": {
+                "type": "integer"
+              },
+              "height": {
+                "type": "integer"
+              }
+            }
+          },
+          "num_images": {
+            "type": "integer",
+            "description": "Number of images to generate",
+            "minimum": 1,
+            "maximum": 4,
+            "default": 1
+          },
+          "num_inference_steps": {
+            "type": "integer",
+            "description": "Number of inference steps"
+          },
+          "guidance_scale": {
+            "type": "number",
+            "description": "Guidance scale for diffusion models"
+          },
+          "seed": {
+            "type": "integer",
+            "description": "Random seed for reproducibility"
+          },
+          "negative_prompt": {
+            "type": "string",
+            "description": "Negative prompt"
+          },
+          "loras": {
+            "type": "array",
+            "description": "LoRA weights [{path, scale}]",
+            "items": {
+              "type": "object",
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "scale": {
+                  "type": "number",
+                  "default": 1
+                }
+              }
+            }
+          },
+          "webhook_url": {
+            "type": "string",
+            "description": "Webhook URL to receive completion notification instead of polling"
+          }
+        },
+        "required": [
+          "model_id"
+        ]
+      }
+    },
+    {
+      "name": "queue_status",
+      "description": "Check the status of an async queue request. Returns status (IN_QUEUE, IN_PROGRESS, COMPLETED) and queue position",
+      "method": "GET",
+      "path": "/%7B%7Bmodel_id%7D%7D/requests/%7B%7Brequest_id%7D%7D/status",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_id": {
+            "type": "string",
+            "description": "Model endpoint ID used in the original request"
+          },
+          "request_id": {
+            "type": "string",
+            "description": "Request ID returned from queue submission"
+          }
+        },
+        "required": [
+          "model_id",
+          "request_id"
+        ]
+      }
+    },
+    {
+      "name": "queue_result",
+      "description": "Retrieve the result of a completed async queue request. Only call after status is COMPLETED",
+      "method": "GET",
+      "path": "/%7B%7Bmodel_id%7D%7D/requests/%7B%7Brequest_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_id": {
+            "type": "string",
+            "description": "Model endpoint ID used in the original request"
+          },
+          "request_id": {
+            "type": "string",
+            "description": "Request ID returned from queue submission"
+          }
+        },
+        "required": [
+          "model_id",
+          "request_id"
+        ]
+      }
+    },
+    {
+      "name": "queue_cancel",
+      "description": "Cancel a pending or in-progress queue request",
+      "method": "PUT",
+      "path": "/%7B%7Bmodel_id%7D%7D/requests/%7B%7Brequest_id%7D%7D/cancel",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_id": {
+            "type": "string",
+            "description": "Model endpoint ID"
+          },
+          "request_id": {
+            "type": "string",
+            "description": "Request ID to cancel"
+          }
+        },
+        "required": [
+          "model_id",
+          "request_id"
+        ]
+      }
+    },
+    {
+      "name": "upload_file",
+      "description": "Upload a file to fal.ai storage for use as model input. Returns a URL that can be passed to model endpoints",
+      "method": "POST",
+      "path": "/fal-ai/file-upload/upload",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "file_url": {
+            "type": "string",
+            "description": "URL of the file to upload to fal.ai storage"
+          },
+          "file_name": {
+            "type": "string",
+            "description": "Name for the uploaded file"
+          }
+        },
+        "required": [
+          "file_url"
+        ]
+      }
+    },
+    {
+      "name": "search_models",
+      "description": "Search and discover available fal.ai models by keyword, category, or endpoint ID",
+      "method": "GET",
+      "path": "/api/models",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search query (e.g. 'flux', 'video generation', 'whisper')"
+          },
+          "category": {
+            "type": "string",
+            "description": "Filter by category",
+            "enum": [
+              "text-to-image",
+              "image-to-image",
+              "text-to-video",
+              "image-to-video",
+              "text-to-speech",
+              "speech-to-text",
+              "text-to-music",
+              "text-to-3d",
+              "llm",
+              "embedding",
+              "upscaler"
+            ]
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Max results to return",
+            "default": 20,
+            "maximum": 100
+          },
+          "offset": {
+            "type": "integer",
+            "description": "Offset for pagination",
+            "default": 0
+          }
+        }
+      }
+    },
+    {
+      "name": "get_usage",
+      "description": "Get API usage records for your fal.ai account with filters by endpoint and date range",
+      "method": "GET",
+      "path": "/api/platform-apis/v1/models/usage",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "endpoint_id": {
+            "type": "string",
+            "description": "Filter by model endpoint ID"
+          },
+          "start_date": {
+            "type": "string",
+            "description": "Start date filter (ISO 8601 format)"
+          },
+          "end_date": {
+            "type": "string",
+            "description": "End date filter (ISO 8601 format)"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Max records to return",
+            "default": 50
+          }
+        }
+      }
+    },
+    {
+      "name": "list_request_history",
+      "description": "Get history of requests made to fal.ai models with status and timing information",
+      "method": "GET",
+      "path": "/api/platform-apis/v1/models/requests/by-endpoint",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "endpoint_id": {
+            "type": "string",
+            "description": "Filter by model endpoint ID"
+          },
+          "status": {
+            "type": "string",
+            "description": "Filter by request status",
+            "enum": [
+              "success",
+              "error",
+              "user_error"
+            ]
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Max records to return",
+            "default": 20
+          }
+        }
+      }
+    }
+  ]
+}