Skip to main content
Glama

Adeli

by com.tryadeli.app
OverviewDiscussionsAdmin

Publish a post

create_post

Publish to Instagram, Facebook, TikTok, YouTube or X. This posts publicly unless the platform's privacy setting says otherwise, so confirm the content with the user first. post is exactly the JSON body of POST /api/v1/posts: Instagram takes image or images (base64), with altText and userTags per image and collaborators and isAiGenerated per post (hashtags go in caption); Facebook takes image, images, reel or video (base64); TikTok takes video (prefer {"url": "https://..."} over base64) or photos, with music_usage_confirmed: true. Call get_tiktok_creator_info before a TikTok post. TikTok videos publish publicly (privacy_level PUBLIC_TO_EVERYONE or omitted); any other video privacy_level is refused. Photos take any level from get_tiktok_creator_info. post_mode MEDIA_UPLOAD sends a draft to the creator's TikTok inbox instead of publishing. YouTube takes video (prefer {"url": "https://..."}), title, privacy_status (public, unlisted or private) and made_for_kids, all required; ask the user for privacy_status and made_for_kids rather than choosing them. publish_at schedules a private video to go public. Until Adeli passes YouTube's API audit, YouTube keeps every upload private: the result says so with privacyRestricted. X takes text (280 characters, a link counts as 23) and media: up to 4 images, or 1 GIF, or 1 video, as base64 or a video {"url"}; thread is a list of further posts, each a reply to the one before. Every X post is billed at X's price ($0.015, or $0.20 with a link), and a thread that fails part-way returns 207 with the posts that went live. TikTok, Facebook and YouTube video publish asynchronously: poll get_tiktok_post_status, get_facebook_post_status or get_youtube_post_status with the returned publishId. Multipart uploads are REST-only.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
postYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / post / anyOf
      Previous value: -[
-  {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "caption": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "collaborators": {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 3,
-            "type": "array"
-          },
-          "image": {
-            "additionalProperties": false,
-            "properties": {
-              "altText": {
-                "maxLength": 1000,
-                "type": "string"
-              },
-              "base64": {
-                "minLength": 1,
-                "type": "string"
-              },
-              "contentType": {
-                "enum": [
-                  "image/jpeg",
-                  "image/png",
-                  "image/webp"
-                ],
-                "type": "string"
-              },
-              "userTags": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "username": {
-                      "type": "string"
-                    },
-                    "x": {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    "y": {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    }
-                  },
-                  "required": [
-                    "username",
-                    "x",
-                    "y"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "required": [
-              "contentType",
-              "base64"
-            ],
-            "type": "object"
-          },
-          "isAiGenerated": {
-            "type": "boolean"
-          },
-          "platform": {
-            "const": "instagram",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "image"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "caption": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "collaborators": {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 3,
-            "type": "array"
-          },
-          "images": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "altText": {
-                  "maxLength": 1000,
-                  "type": "string"
-                },
-                "base64": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "contentType": {
-                  "enum": [
-                    "image/jpeg",
-                    "image/png",
-                    "image/webp"
-                  ],
-                  "type": "string"
-                },
-                "userTags": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "username": {
-                        "type": "string"
-                      },
-                      "x": {
-                        "maximum": 1,
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      "y": {
-                        "maximum": 1,
-                        "minimum": 0,
-                        "type": "number"
-                      }
-                    },
-                    "required": [
-                      "username",
-                      "x",
-                      "y"
-                    ],
-                    "type": "object"
-                  },
-                  "maxItems": 20,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "contentType",
-                "base64"
-              ],
-              "type": "object"
-            },
-            "maxItems": 10,
-            "minItems": 2,
-            "type": "array"
-          },
-          "isAiGenerated": {
-            "type": "boolean"
-          },
-          "platform": {
-            "const": "instagram",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "images"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  {
-    "anyOf": [
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "image": {
-            "additionalProperties": false,
-            "properties": {
-              "base64": {
-                "maxLength": 5592408,
-                "minLength": 4,
-                "type": "string"
-              },
-              "contentType": {
-                "enum": [
-                  "image/jpeg",
-                  "image/png",
-                  "image/webp"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "contentType",
-              "base64"
-            ],
-            "type": "object"
-          },
-          "message": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "platform": {
-            "const": "facebook",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "image"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "images": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "base64": {
-                  "maxLength": 5592408,
-                  "minLength": 4,
-                  "type": "string"
-                },
-                "contentType": {
-                  "enum": [
-                    "image/jpeg",
-                    "image/png",
-                    "image/webp"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "contentType",
-                "base64"
-              ],
-              "type": "object"
-            },
-            "maxItems": 10,
-            "minItems": 2,
-            "type": "array"
-          },
-          "message": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "platform": {
-            "const": "facebook",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "images"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "platform": {
-            "const": "facebook",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "reel": {
-            "additionalProperties": false,
-            "properties": {
-              "base64": {
-                "maxLength": 89478488,
-                "minLength": 4,
-                "type": "string"
-              },
-              "contentType": {
-                "enum": [
-                  "video/mp4",
-                  "video/quicktime",
-                  "video/webm"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "contentType",
-              "base64"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "reel"
-        ],
-        "type": "object"
-      },
-      {
-        "additionalProperties": false,
-        "properties": {
-          "accountId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "message": {
-            "maxLength": 2200,
-            "type": "string"
-          },
-          "platform": {
-            "const": "facebook",
-            "type": "string"
-          },
-          "profileId": {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          "title": {
-            "maxLength": 255,
-            "type": "string"
-          },
-          "video": {
-            "additionalProperties": false,
-            "properties": {
-              "base64": {
-                "maxLength": 89478488,
-                "minLength": 4,
-                "type": "string"
-              },
-              "contentType": {
-                "enum": [
-                  "video/mp4",
-                  "video/quicktime",
-                  "video/webm"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "contentType",
-              "base64"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "platform",
-          "accountId",
-          "video"
-        ],
-        "type": "object"
-      }
-    ]
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accountId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "add_to_queue": {
-        "not": {}
-      },
-      "async_upload": {
-        "not": {}
-      },
-      "auto_add_music": {
-        "default": false,
-        "type": "boolean"
-      },
-      "brand_content_toggle": {
-        "default": false,
-        "type": "boolean"
-      },
-      "brand_organic_toggle": {
-        "default": false,
-        "type": "boolean"
-      },
-      "cover_timestamp": {
-        "default": 1000,
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "disable_comment": {
-        "default": false,
-        "type": "boolean"
-      },
-      "disable_duet": {
-        "default": false,
-        "type": "boolean"
-      },
-      "disable_stitch": {
-        "default": false,
-        "type": "boolean"
-      },
-      "is_aigc": {
-        "default": false,
-        "type": "boolean"
-      },
-      "music_usage_confirmed": {
-        "const": true,
-        "type": "boolean"
-      },
-      "photo_cover_index": {
-        "default": 0,
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "photos": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "base64": {
-              "maxLength": 27962040,
-              "minLength": 4,
-              "type": "string"
-            },
-            "content_type": {
-              "enum": [
-                "image/jpeg",
-                "image/png",
-                "image/webp"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "content_type",
-            "base64"
-          ],
-          "type": "object"
-        },
-        "maxItems": 35,
-        "minItems": 1,
-        "type": "array"
-      },
-      "platform": {
-        "const": "tiktok",
-        "type": "string"
-      },
-      "post_mode": {
-        "default": "DIRECT_POST",
-        "enum": [
-          "DIRECT_POST",
-          "MEDIA_UPLOAD"
-        ],
-        "type": "string"
-      },
-      "privacy_level": {
-        "enum": [
-          "PUBLIC_TO_EVERYONE",
-          "MUTUAL_FOLLOW_FRIENDS",
-          "FOLLOWER_OF_CREATOR",
-          "SELF_ONLY"
-        ],
-        "type": "string"
-      },
-      "profileId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "scheduled_date": {
-        "not": {}
-      },
-      "tiktok_description": {
-        "maxLength": 4000,
-        "type": "string"
-      },
-      "tiktok_title": {
-        "maxLength": 2200,
-        "type": "string"
-      },
-      "video": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "base64": {
-                "maxLength": 89478488,
-                "minLength": 4,
-                "type": "string"
-              },
-              "content_type": {
-                "const": "video/mp4",
-                "type": "string"
-              }
-            },
-            "required": [
-              "content_type",
-              "base64"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "url": {
-                "format": "uri",
-                "type": "string"
-              }
-            },
-            "required": [
-              "url"
-            ],
-            "type": "object"
-          }
-        ]
-      }
-    },
-    "required": [
-      "platform",
-      "accountId",
-      "music_usage_confirmed"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "accountId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "category_id": {
-        "pattern": "^\\d+$",
-        "type": "string"
-      },
-      "contains_synthetic_media": {
-        "type": "boolean"
-      },
-      "description": {
-        "type": "string"
-      },
-      "made_for_kids": {
-        "type": "boolean"
-      },
-      "notify_subscribers": {
-        "type": "boolean"
-      },
-      "platform": {
-        "const": "youtube",
-        "type": "string"
-      },
-      "privacy_status": {
-        "enum": [
-          "public",
-          "unlisted",
-          "private"
-        ],
-        "type": "string"
-      },
-      "profileId": {
-        "format": "uuid",
-        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-        "type": "string"
-      },
-      "publish_at": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-        "type": "string"
-      },
-      "tags": {
-        "items": {
-          "maxLength": 500,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "title": {
-        "maxLength": 100,
-        "minLength": 1,
-        "type": "string"
-      },
-      "video": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "url": {
-                "format": "uri",
-                "type": "string"
-              }
-            },
-            "required": [
-              "url"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "base64": {
-                "maxLength": 89478488,
-                "minLength": 4,
-                "type": "string"
-              },
-              "content_type": {
-                "enum": [
-                  "video/mp4",
-                  "video/quicktime",
-                  "video/webm"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "content_type",
-              "base64"
-            ],
-            "type": "object"
-          }
-        ]
-      }
-    },
-    "required": [
-      "platform",
-      "accountId",
-      "title",
-      "privacy_status",
-      "made_for_kids",
-      "video"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "anyOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "caption": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "collaborators": {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 3,
+            "type": "array"
+          },
+          "image": {
+            "additionalProperties": false,
+            "properties": {
+              "altText": {
+                "maxLength": 1000,
+                "type": "string"
+              },
+              "base64": {
+                "minLength": 1,
+                "type": "string"
+              },
+              "contentType": {
+                "enum": [
+                  "image/jpeg",
+                  "image/png",
+                  "image/webp"
+                ],
+                "type": "string"
+              },
+              "userTags": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "username": {
+                      "type": "string"
+                    },
+                    "x": {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "y": {
+                      "maximum": 1,
+                      "minimum": 0,
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "username",
+                    "x",
+                    "y"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "required": [
+              "contentType",
+              "base64"
+            ],
+            "type": "object"
+          },
+          "isAiGenerated": {
+            "type": "boolean"
+          },
+          "platform": {
+            "const": "instagram",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "image"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "caption": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "collaborators": {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 3,
+            "type": "array"
+          },
+          "images": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "altText": {
+                  "maxLength": 1000,
+                  "type": "string"
+                },
+                "base64": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "contentType": {
+                  "enum": [
+                    "image/jpeg",
+                    "image/png",
+                    "image/webp"
+                  ],
+                  "type": "string"
+                },
+                "userTags": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "username": {
+                        "type": "string"
+                      },
+                      "x": {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      "y": {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "username",
+                      "x",
+                      "y"
+                    ],
+                    "type": "object"
+                  },
+                  "maxItems": 20,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "contentType",
+                "base64"
+              ],
+              "type": "object"
+            },
+            "maxItems": 10,
+            "minItems": 2,
+            "type": "array"
+          },
+          "isAiGenerated": {
+            "type": "boolean"
+          },
+          "platform": {
+            "const": "instagram",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "images"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  {
+    "anyOf": [
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "image": {
+            "additionalProperties": false,
+            "properties": {
+              "base64": {
+                "maxLength": 5592408,
+                "minLength": 4,
+                "type": "string"
+              },
+              "contentType": {
+                "enum": [
+                  "image/jpeg",
+                  "image/png",
+                  "image/webp"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "contentType",
+              "base64"
+            ],
+            "type": "object"
+          },
+          "message": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "platform": {
+            "const": "facebook",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "image"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "images": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "base64": {
+                  "maxLength": 5592408,
+                  "minLength": 4,
+                  "type": "string"
+                },
+                "contentType": {
+                  "enum": [
+                    "image/jpeg",
+                    "image/png",
+                    "image/webp"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "contentType",
+                "base64"
+              ],
+              "type": "object"
+            },
+            "maxItems": 10,
+            "minItems": 2,
+            "type": "array"
+          },
+          "message": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "platform": {
+            "const": "facebook",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "images"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "platform": {
+            "const": "facebook",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "reel": {
+            "additionalProperties": false,
+            "properties": {
+              "base64": {
+                "maxLength": 89478488,
+                "minLength": 4,
+                "type": "string"
+              },
+              "contentType": {
+                "enum": [
+                  "video/mp4",
+                  "video/quicktime",
+                  "video/webm"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "contentType",
+              "base64"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "reel"
+        ],
+        "type": "object"
+      },
+      {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "message": {
+            "maxLength": 2200,
+            "type": "string"
+          },
+          "platform": {
+            "const": "facebook",
+            "type": "string"
+          },
+          "profileId": {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          "title": {
+            "maxLength": 255,
+            "type": "string"
+          },
+          "video": {
+            "additionalProperties": false,
+            "properties": {
+              "base64": {
+                "maxLength": 89478488,
+                "minLength": 4,
+                "type": "string"
+              },
+              "contentType": {
+                "enum": [
+                  "video/mp4",
+                  "video/quicktime",
+                  "video/webm"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "contentType",
+              "base64"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "platform",
+          "accountId",
+          "video"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "add_to_queue": {
+        "not": {}
+      },
+      "async_upload": {
+        "not": {}
+      },
+      "auto_add_music": {
+        "default": false,
+        "type": "boolean"
+      },
+      "brand_content_toggle": {
+        "default": false,
+        "type": "boolean"
+      },
+      "brand_organic_toggle": {
+        "default": false,
+        "type": "boolean"
+      },
+      "cover_timestamp": {
+        "default": 1000,
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "disable_comment": {
+        "default": false,
+        "type": "boolean"
+      },
+      "disable_duet": {
+        "default": false,
+        "type": "boolean"
+      },
+      "disable_stitch": {
+        "default": false,
+        "type": "boolean"
+      },
+      "is_aigc": {
+        "default": false,
+        "type": "boolean"
+      },
+      "music_usage_confirmed": {
+        "const": true,
+        "type": "boolean"
+      },
+      "photo_cover_index": {
+        "default": 0,
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "photos": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "base64": {
+              "maxLength": 27962040,
+              "minLength": 4,
+              "type": "string"
+            },
+            "content_type": {
+              "enum": [
+                "image/jpeg",
+                "image/png",
+                "image/webp"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "content_type",
+            "base64"
+          ],
+          "type": "object"
+        },
+        "maxItems": 35,
+        "minItems": 1,
+        "type": "array"
+      },
+      "platform": {
+        "const": "tiktok",
+        "type": "string"
+      },
+      "post_mode": {
+        "default": "DIRECT_POST",
+        "enum": [
+          "DIRECT_POST",
+          "MEDIA_UPLOAD"
+        ],
+        "type": "string"
+      },
+      "privacy_level": {
+        "enum": [
+          "PUBLIC_TO_EVERYONE",
+          "MUTUAL_FOLLOW_FRIENDS",
+          "FOLLOWER_OF_CREATOR",
+          "SELF_ONLY"
+        ],
+        "type": "string"
+      },
+      "profileId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "scheduled_date": {
+        "not": {}
+      },
+      "tiktok_description": {
+        "maxLength": 4000,
+        "type": "string"
+      },
+      "tiktok_title": {
+        "maxLength": 2200,
+        "type": "string"
+      },
+      "video": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "base64": {
+                "maxLength": 89478488,
+                "minLength": 4,
+                "type": "string"
+              },
+              "content_type": {
+                "const": "video/mp4",
+                "type": "string"
+              }
+            },
+            "required": [
+              "content_type",
+              "base64"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "url": {
+                "format": "uri",
+                "type": "string"
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "type": "object"
+          }
+        ]
+      }
+    },
+    "required": [
+      "platform",
+      "accountId",
+      "music_usage_confirmed"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "category_id": {
+        "pattern": "^\\d+$",
+        "type": "string"
+      },
+      "contains_synthetic_media": {
+        "type": "boolean"
+      },
+      "description": {
+        "type": "string"
+      },
+      "made_for_kids": {
+        "type": "boolean"
+      },
+      "notify_subscribers": {
+        "type": "boolean"
+      },
+      "platform": {
+        "const": "youtube",
+        "type": "string"
+      },
+      "privacy_status": {
+        "enum": [
+          "public",
+          "unlisted",
+          "private"
+        ],
+        "type": "string"
+      },
+      "profileId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "publish_at": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+        "type": "string"
+      },
+      "tags": {
+        "items": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "title": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "video": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "url": {
+                "format": "uri",
+                "type": "string"
+              }
+            },
+            "required": [
+              "url"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "base64": {
+                "maxLength": 89478488,
+                "minLength": 4,
+                "type": "string"
+              },
+              "content_type": {
+                "enum": [
+                  "video/mp4",
+                  "video/quicktime",
+                  "video/webm"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "content_type",
+              "base64"
+            ],
+            "type": "object"
+          }
+        ]
+      }
+    },
+    "required": [
+      "platform",
+      "accountId",
+      "title",
+      "privacy_status",
+      "made_for_kids",
+      "video"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "accountId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "media": {
+        "items": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "base64": {
+                  "maxLength": 89478488,
+                  "minLength": 4,
+                  "type": "string"
+                },
+                "content_type": {
+                  "enum": [
+                    "image/jpeg",
+                    "image/png",
+                    "image/webp",
+                    "image/gif",
+                    "video/mp4"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "content_type",
+                "base64"
+              ],
+              "type": "object"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "url": {
+                  "format": "uri",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "url"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "maxItems": 4,
+        "type": "array"
+      },
+      "platform": {
+        "const": "x",
+        "type": "string"
+      },
+      "profileId": {
+        "format": "uuid",
+        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 25000,
+        "type": "string"
+      },
+      "thread": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "media": {
+              "items": {
+                "anyOf": [
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "base64": {
+                        "maxLength": 89478488,
+                        "minLength": 4,
+                        "type": "string"
+                      },
+                      "content_type": {
+                        "enum": [
+                          "image/jpeg",
+                          "image/png",
+                          "image/webp",
+                          "image/gif",
+                          "video/mp4"
+                        ],
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "content_type",
+                      "base64"
+                    ],
+                    "type": "object"
+                  },
+                  {
+                    "additionalProperties": false,
+                    "properties": {
+                      "url": {
+                        "format": "uri",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "url"
+                    ],
+                    "type": "object"
+                  }
+                ]
+              },
+              "maxItems": 4,
+              "type": "array"
+            },
+            "text": {
+              "maxLength": 25000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "text"
+          ],
+          "type": "object"
+        },
+        "maxItems": 24,
+        "type": "array"
+      }
+    },
+    "required": [
+      "platform",
+      "accountId",
+      "text"
+    ],
+    "type": "object"
+  }
+]
  2. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover only the safety profile (readOnlyHint=false, openWorldHint=true, destructiveHint=false). The description adds far more: public-by-default posting, async publish for TikTok/Facebook/YouTube with polling, X billing ($0.015, $0.20 with a link), a 207 partial-failure return for threads, and YouTube's privacyRestricted behavior until the API audit passes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the essential purpose and the public-posting warning before platform detail, and nearly every sentence carries unique operational facts. It is nevertheless a dense wall of text with no structural breaks, which makes it harder to scan than it could be for a tool this complex.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-platform, multi-shape mutation tool with no output schema, the description supplies the async polling contract, the partial-failure code, billing, platform privacy constraints, and the TikTok preflight dependency. Nothing an agent needs to invoke it correctly appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% on a deeply nested anyOf, so the description carries the full burden and does so: per-platform payload shapes, Instagram altText/userTags/collaborators/isAiGenerated, Facebook image/images/reel/video, TikTok music_usage_confirmed:true and post_mode, YouTube required title/privacy_status/made_for_kids, and X text limits (280 chars, link = 23) plus media/thread rules.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a precise verb+resource ("Publish to Instagram, Facebook, TikTok, YouTube or X") and enumerates exactly which platforms are supported. An agent can immediately distinguish it from list_posts, get_*_status and the update_* siblings without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent: "Call get_tiktok_creator_info before a TikTok post," "poll get_tiktok_post_status / get_facebook_post_status / get_youtube_post_status with the returned publishId," and "ask the user for privacy_status and made_for_kids rather than choosing them." It also states the precondition "confirm the content with the user first" and notes multipart uploads are REST-only.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Adeli toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources