juzpost
Registry code: 6979a971ac947fa4
Draft, schedule and publish social posts to X, LinkedIn, Instagram, TikTok, YouTube and more
from a public catalogue that lists it, not from the operator
- endpoint
- https://www.juzpost.com/mcp
- protocol
- http-sse ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is juzpost live?
- Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
- Is juzpost free to use?
- Partly — some of its tools are open, others need a key or payment.
- What tools does juzpost have?
- 19 tools: list_options, update_post, list_workspaces, switch_workspace, list_groups, list_posts, get_post, create_post, ….
- Is juzpost safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 100%· all time 100%
last good check
of 19 tools
- unknown → live
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
get_platform_limits open 1h ago
Returns the full publishing rules for one platform or all of them: caption and title limits and units, media counts, sizes, formats, whether media is required, hashtags, mentions, native scheduling, plus the global file rules. Use this before drafting to answer "will this fit on X / Instagram / TikTok". Returns platforms[] (one object per platform, with effectiveBodyLimit) and global. imageFormats is what the post may carry: a PNG or WebP is converted to JPEG for a platform that only takes JPEG, and a still image over maxImageBytes is compressed under it when it publishes, so neither blocks. Does NOT look at a specific account; list_accounts carries the per-account effective limits.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "platform": { "type": "string", "description": "Platform id such as \"x\", \"linkedin\", \"tiktok\". Omit for every platform." } } }arguments 10 linesget_context auth-required 1h ago
Reports who this connection is, the one workspace it acts on (use switch_workspace to change it), the plan, billing state, entitlements, quotas, limits and a plain-language list of what is blocked right now. Use this to see what the connection can do, and after an error mentions a plan or quota. Returns user, credential, workspace, plan, billing, entitlements, quotas, limits and blocked[]. The plan and quotas.subscription belong to the subscription of the workspace owner (ownedBy says whether that is the user) and are counted across every workspace that owner has; quotas.workspace is this workspace alone. Say which is which when reporting numbers. workspace.timezone is null until the user picks a plan on the website. Does NOT change anything. Works on every plan, including a workspace with no plan.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }arguments 5 lineslist_accounts auth-required 1h ago
Lists the social accounts connected to the workspace, with health, how many posts are queued on each, and the effective limits for that account. Use this to pick the accounts for create_post and schedule_post, or to check whether an account needs reconnecting. Returns accounts[] (id, ref, platform, username, health, scheduledCount, limits, blockedByPlan, and seo for WordPress accounts), nextCursor and hasMore. seo is "yoast" when the WordPress site lets this account write Yoast SEO fields (schedule_post wordpress.seo), and "core" when it does not. health.status is the same as the dashboard: an expired access token that renews itself is still active; only needs_reconnect means the user must reconnect. ref is the account as "platform:handle" (e.g. "x:acme_studio"): pass it wherever a tool takes an account, since it is what the person reads when approving; it is null when the account has no handle, and then the id is used. Does NOT connect or disconnect accounts; that happens in the dashboard.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "sort": { "enum": [ "createdAt", "username", "platform" ], "type": "string", "description": "createdAt (default), username or platform." }, "limit": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Page size, 1–100." }, "cursor": { "type": "string", "description": "Opaque cursor from the previous page. Omit for the first page." }, "groupId": { "type": "string", "description": "Only accounts in this channel group." }, "platform": { "type": "string", "description": "Filter by platform id, e.g. \"x\", \"instagram\"." } } }arguments 34 lineslist_options unknown never probed
Lists the choices one account offers for a setting the schedule needs, read live from the platform. Requests: list_board (pinterest, ids go in pinterest.board_id); list_post_type (wordpress, ids go in wordpress.post_type); list_location (tiktok, ids go in tiktok.location). Use this when the user posts to Pinterest: list the boards, ask which one, and pass its id as board_id. Use list_location with a query (a city, a venue) when the user wants a place on a TikTok Business post: pass the chosen choice as tiktok.location { id, name }. Use list_post_type when the user wants a WordPress post published as something other than a blog post (a short story, a page): pass the matching id as post_type; the name lists the taxonomies that type takes in terms. Returns field (where the ids go) and choices[] with id and name. Refer to a choice by its name when talking to the user. Does NOT change anything.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "account_id", "platform", "req_type" ], "properties": { "query": { "type": "string", "maxLength": 100, "description": "What to search for. Required by list_location; ignored by the others." }, "platform": { "type": "string", "description": "That account's platform id from list_accounts, e.g. \"pinterest\"." }, "req_type": { "enum": [ "list_board", "list_post_type", "list_location" ], "type": "string", "description": "What to list." }, "account_id": { "type": "string", "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)$", "description": "An account id from list_accounts." } } }arguments 35 linesupdate_post unknown never probed
Edits a draft or a scheduled post, the same edit the composer makes: caption, title, description, hashtags, type, media keys, cover, accounts, per-account text, media and covers, platform settings, and the time. Only the fields passed change; media_keys: null clears the media. The per-account maps (account_overrides, channel_overrides, media_by_account, cover_by_account, each platform's settings) change only the accounts they name: send just the accounts you are changing, and every other account keeps its text, media and settings. An account's entry is its whole text or settings; account_overrides: { id: null } clears that account's text. account_ids is the complete list: an account left out is removed from the post. Facebook text post with a link: also set platform_settings.facebook.link (see that field) so Facebook shows a preview card. A scheduled post is checked the way schedule_post checks one, and nothing is written when it is refused. It can no longer be edited from 10 minutes before its first account fires, or once an account has started preparing (an Instagram or Pinterest video prepares earlier). publish_at on a scheduled post moves it; on a draft it is the time the draft keeps. Times are ISO 8601 ending in Z or an offset, like 2026-11-03T09:00:00+05:30: use the user's own local time with its offset. workspace.timezone from get_context is the workspace's display zone, not necessarily where the user is; if you are unsure of their timezone, ask them. Use this when the user revises a post before it goes out. Returns the updated post and warnings[] for any platform caption limit the new content exceeds. Does NOT edit published or failed posts (returns an error), and does NOT ingest URLs; use upload_media first.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "post_id" ], "properties": { "x": { "type": "object", "description": "x settings keyed by x account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI. Default false." }, "reply_settings": { "enum": [ "everyone", "following", "mentionedUsers", "verified", "subscribers" ], "type": "string", "description": "[optional] Who can reply: everyone, following (accounts you follow), mentionedUsers, verified or subscribers. Default everyone." }, "paid_partnership": { "type": "boolean", "description": "[optional] Label the post as a paid partnership. Default false." } } } }, "gbp": { "type": "object", "description": "gbp settings keyed by gbp account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "event": { "type": "object", "required": [ "title", "start_date", "end_date" ], "properties": { "title": { "type": "string", "maxLength": 300, "minLength": 1 }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "end_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "start_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" } }, "description": "[optional] Required for EVENT and OFFER. Dates YYYY-MM-DD, times HH:MM 24-hour in the business's own time; give both times or neither (no time shows as all day). Default none." }, "offer": { "type": "object", "properties": { "terms": { "type": "string", "maxLength": 1500 }, "redeem_url": { "type": "string", "format": "uri", "maxLength": 2048 }, "coupon_code": { "type": "string", "maxLength": 300 } }, "description": "[optional] OFFER only: coupon code, redeem link and terms, each optional. Default none." }, "topic_type": { "enum": [ "STANDARD", "EVENT", "OFFER" ], "type": "string", "description": "[optional] STANDARD is an update, EVENT an event, OFFER an offer. EVENT and OFFER need event. Default STANDARD." }, "language_code": { "type": "string", "description": "[optional] ISO 639-1 language of the post text, e.g. \"en\", \"ta\", \"es\". Default \"en\"." }, "call_to_action": { "type": "object", "required": [ "type" ], "properties": { "url": { "type": "string", "format": "uri", "maxLength": 2048 }, "type": { "enum": [ "BOOK", "ORDER", "SHOP", "LEARN_MORE", "SIGN_UP", "CALL" ], "type": "string" } }, "description": "[optional] A button on the post: BOOK, ORDER, SHOP, LEARN_MORE or SIGN_UP with a url, or CALL with no url (it rings the business phone). Not on OFFER. Default none." } } } }, "type": { "enum": [ "text", "image", "video", "story", "blog" ], "type": "string", "description": "Post type. Keep the type the draft already has unless the user asked to change it." }, "title": { "type": "string", "maxLength": 200, "description": "Title, used by platforms that have one (YouTube, Pinterest). Required for a blog post, where it becomes the WordPress page heading." }, "tiktok": { "type": "object", "description": "tiktok settings keyed by tiktok account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "delivery": { "enum": [ "direct_post" ], "type": "string", "description": "[optional] direct_post publishes the post to the account; it is the only value. Default direct_post." }, "location": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "pattern": "^\\d+$", "maxLength": 32 }, "name": { "type": "string", "maxLength": 300, "minLength": 1 } }, "description": "[optional] A place tagged on the post, as { id, name } from list_options req_type list_location with a query. TikTok Business accounts only (list_accounts shows api \"business\"); refused on a personal account. Default none." }, "ai_generated": { "type": "boolean", "description": "[optional] Label the post as AI-generated, on photo and video posts. Set it when the photos or the video were made or significantly edited with AI. TikTok does not let the label be removed after posting. Default false." }, "interactions": { "type": "object", "required": [ "comment", "duet", "stitch" ], "properties": { "duet": { "type": "boolean" }, "stitch": { "type": "boolean" }, "comment": { "type": "boolean" } }, "description": "[account default] Allow comments, duets and stitches on this post. Default: the switches saved on the account. Anything the creator turned off in TikTok stays off. Send only when the user asks." }, "brand_content": { "type": "boolean", "description": "[optional] Branded content for someone else. Needs commercial_content; cannot be SELF_ONLY. Default false." }, "brand_organic": { "type": "boolean", "description": "[optional] Promotes the creator's own brand. Needs commercial_content. Default false." }, "privacy_level": { "enum": [ "PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY" ], "type": "string", "description": "[optional] Who can see the post. SELF_ONLY when the user says \"only me\". Default PUBLIC_TO_EVERYONE." }, "commercial_content": { "type": "boolean", "description": "[optional] The post promotes a brand, product or service. Default false." } } } }, "tumblr": { "type": "object", "description": "tumblr settings keyed by tumblr account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A link Tumblr shows as a card on the post. A link in the caption stays plain text. Default none. Tags go in account_overrides hashtags." }, "source_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The post's Source credit. Default none." } } } }, "bluesky": { "type": "object", "description": "bluesky settings keyed by bluesky account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "alt_text", "labels" ], "properties": { "langs": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$" }, "maxItems": 3, "description": "[optional] The post's languages as BCP 47 codes (e.g. \"en\", \"pt-BR\"), at most 3. Bluesky uses them for language feeds. Default: none, Bluesky guesses." }, "labels": { "type": "array", "items": { "enum": [ "sexual", "nudity", "porn", "graphic-media" ], "type": "string" }, "description": "[optional] Content warnings: at most one of sexual (Suggestive), nudity, porn (Adult), plus graphic-media. Only on posts with images or video. Default []." }, "alt_text": { "type": "array", "items": { "type": "string" }, "description": "[optional] One description per file, in the order this account publishes its media; \"\" leaves a file undescribed. Exactly as many entries as files. Up to 2000 characters each. Default: no alt text." } } } }, "content": { "type": "string", "maxLength": 100000, "description": "The caption / body text." }, "post_id": { "type": "string", "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)$" }, "youtube": { "type": "object", "description": "youtube settings keyed by youtube account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "category_id": { "type": "string", "pattern": "^\\d{1,3}$", "description": "[optional] YouTube category id, e.g. \"22\" People & Blogs, \"27\" Education, \"28\" Science & Technology. Default \"22\". Tags go in account_overrides hashtags, 500 characters in all." }, "made_for_kids": { "type": "boolean", "description": "[optional] Made for kids. YouTube turns off comments and personalised ads when true. Default false." }, "privacy_status": { "enum": [ "public", "unlisted", "private" ], "type": "string", "description": "[optional] Who can watch: public, unlisted (anyone with the link) or private. Default public." } } } }, "facebook": { "type": "object", "description": "facebook settings keyed by facebook account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A web address Facebook shows as a preview card under a text post. When a Facebook text post's caption has one link, set it here too so the card shows; with several links, ask the user which one. Ignored on a post with images or video. A link only in the caption shows as plain text. Default none." }, "feeling": { "type": "object", "required": [ "activity" ], "properties": { "text": { "type": "string", "maxLength": 100, "minLength": 1 }, "feeling": { "enum": [ "accomplished", "adventurous", "afraid", "aggravated", "alive", "alone", "amazed", "amazing", "amused", "angry", "annoyed", "anxious", "appreciated", "ashamed", "asleep", "awake", "awesome", "awful", "awkward", "bad", "beautiful", "betrayed", "better", "bitter", "blah", "blessed", "blissful", "blue", "bored", "brave", "broke", "broken", "bummed", "busy", "butterflies", "calm", "challenged", "cheated", "chill", "clean", "cold", "comfortable", "complete", "concerned", "confident", "conflicted", "confused", "connected", "content", "cool", "cozy", "crafty", "crappy", "crazy", "creative", "curious", "cute", "deep", "defeated", "delighted", "depressed", "desperate", "determined", "devastated", "different", "dirty", "disappointed", "discouraged", "disgusted", "dizzy", "done", "down", "drained", "drunk", "dumb", "ecstatic", "embarrassed", "emotional", "empowered", "energized", "enraged", "entertained", "evil", "excited", "exhausted", "fabulous", "fantastic", "fat", "fed up", "festive", "fine", "flirty", "focused", "fortunate", "free", "freezing", "fresh", "frozen", "frustrated", "full", "funky", "funny", "furious", "generous", "giddy", "glad", "good", "goofy", "grateful", "great", "gross", "grumpy", "guilty", "happy", "healthy", "heartbroken", "helpless", "homesick", "honored", "hopeful", "hopeless", "horrible", "hot", "human", "hungover", "hungry", "hurt", "hyper", "ignored", "ill", "impatient", "important", "impressed", "in love", "inadequate", "incomplete", "insecure", "inspired", "insulted", "invisible", "irritated", "jealous", "jolly", "joyful", "kind", "lame", "lazy", "light", "lonely", "lost", "lousy", "loved", "lovely", "low", "lucky", "mad", "meh", "mighty", "mischievous", "miserable", "missing", "motivated", "naked", "naughty", "nauseous", "needed", "neglected", "nerdy", "nervous", "nice", "normal", "nostalgic", "numb", "offended", "ok", "okay", "old", "optimistic", "overwhelmed", "pained", "peaceful", "perfect", "perplexed", "pissed", "pissed off", "positive", "pretty", "pride", "privileged", "productive", "professional", "proud", "pumped", "puzzled", "qualified", "ready", "refreshed", "regret", "relaxed", "relieved", "renewed", "rested", "restless", "rich", "romantic", "rough", "sad", "safe", "sarcastic", "satisfied", "scared", "secure", "sexy", "shame", "shattered", "shocked", "shy", "sick", "silly", "sleepy", "small", "smart", "sneaky", "sore", "sorry", "special", "spoiled", "spooky", "stoked", "strange", "stressed", "strong", "stuck", "stuffed", "stupid", "super", "surprised", "terrible", "thankful", "thirsty", "thoughtful", "threatened", "tipsy", "tired", "trapped", "ugly", "unappreciated", "uncomfortable", "undecided", "uneasy", "unhappy", "unimportant", "unloved", "unsure", "unwanted", "unwell", "upset", "useless", "wanted", "warm", "weak", "weird", "welcome", "welcomed", "well", "wet", "whole", "wonderful", "worried", "worse", "worthless", "young", "yucky" ], "type": "string" }, "activity": { "enum": [ "feeling", "eating", "drinking", "watching", "listening", "reading", "playing", "traveling", "going", "celebrating", "attending" ], "type": "string" } }, "description": "[optional] The Page's feeling or activity shown beside its name. activity feeling with feeling a name from the list, e.g. { activity: \"feeling\", feeling: \"happy\" } shows \"is feeling happy\"; any other activity with text, up to 100 characters, e.g. { activity: \"playing\", text: \"Minecraft\" } shows \"is playing Minecraft\". On text and photo posts only; refused on a video, Reel or Story. Default none." }, "video_as": { "type": "string", "const": "reel", "description": "[optional] Publish a video as a Reel: 3 to 90 seconds, vertical 9:16, at most 30 Reels per Page per day. Default: a classic Page video." }, "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI (\"AI info\" on Facebook). On text posts, photo posts and Reels (video_as reel); refused on a classic Page video and on a Story. Default false." } } } }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "Without the # is fine." }, "cover_key": { "type": [ "string", "null" ], "description": "null clears the cover." }, "instagram": { "type": "object", "description": "instagram settings keyed by instagram account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "trial_reel": { "enum": [ "manual", "auto" ], "type": "string", "description": "[optional] Share a Reel as a Trial Reel, to non-followers first. manual: you decide whether it goes to followers; auto: Instagram decides on performance. Reels with one video only. Default: a normal Reel." } } } }, "pinterest": { "type": "object", "description": "pinterest settings keyed by pinterest account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "board_id" ], "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The Pin's clickable destination. A URL in the caption is never clickable on Pinterest. Default none." }, "alt_text": { "type": "string", "maxLength": 500, "description": "[optional] Describes the image for screen readers. Default none; the title is never used." }, "board_id": { "type": "string", "pattern": "^\\d+$", "description": "[account default] The board the Pin goes on. Default: the account's saved board, and no account has one yet, so every Pin needs this: ask the user which board, from list_options req_type list_board." } } } }, "wordpress": { "type": "object", "description": "wordpress settings keyed by wordpress account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "seo": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "focus_keyphrase": { "type": "string", "minLength": 1 } }, "description": "[optional] Yoast SEO fields. Only for an account whose list_accounts entry shows seo \"yoast\". Default: Yoast's own." }, "slug": { "type": "string", "maxLength": 200, "minLength": 1, "description": "[optional] The URL slug. Default: made from the title." }, "tags": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Tag names; a new one is created. Only for a post type that has tags. Default none." }, "terms": { "type": "object", "description": "[optional] Terms of the post type's own taxonomies, as { taxonomy slug: [names] }, e.g. { \"genre\": [\"Romance\"] }. list_post_type names each type's taxonomies. Names must already exist on the site; an unknown one is refused at schedule with the site's list. Default none.", "propertyNames": { "type": "string", "pattern": "^[a-z0-9_-]{1,32}$" }, "additionalProperties": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 } }, "status": { "enum": [ "publish", "draft", "pending", "private" ], "type": "string", "description": "[optional] publish; draft or pending (Pending review) to review it in wp-admin; private for logged-in editors only. Default publish." }, "excerpt": { "type": "string", "minLength": 1, "description": "[optional] Short summary for feeds and link previews. Default: WordPress makes one from the body." }, "post_type": { "type": "string", "pattern": "^[a-z0-9_-]{1,20}$", "description": "[optional] The post type to publish as, e.g. a short story instead of a blog post: a slug from list_options req_type list_post_type. Default post." }, "categories": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Category names that already exist on the site; an unknown one is refused at schedule with the site's list. Only for a post type that has categories. Default: the site's default category." }, "featured_image_alt": { "type": "string", "minLength": 1, "description": "[optional] Alt text for the featured image (the first image). Default none." } } } }, "media_keys": { "anyOf": [ { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20 }, { "type": "null" } ], "description": "Replaces the media; null clears it." }, "publish_at": { "type": "string", "description": "ISO 8601 with Z or an offset, in the user's own local time, like 2026-11-03T09:00:00+05:30. On a scheduled post: its new time, at least 10 minutes ahead. On a draft: the time it keeps until schedule_post." }, "account_ids": { "type": "array", "items": { "type": "string", "maxLength": 300, "minLength": 1 }, "maxItems": 10, "minItems": 1, "description": "Where this post goes: each account's ref from list_accounts (e.g. \"x:acme_studio\"), or its id. Prefer the ref; it is what the person reads when approving. Always the complete list, unlike the per-account maps: an account left out is removed from the post, with its text and settings." }, "description": { "type": "string" }, "cover_by_account": { "type": "object", "description": "One account's own video cover, keyed by account ref or id: a media_key, or null to use the post's cover.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] } }, "media_by_account": { "type": "object", "description": "One account's own media, keyed by account ref or id: its whole ordered list of media_key values; [] posts no media there, null goes back to the post's media.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20 }, { "type": "null" } ] } }, "account_overrides": { "type": "object", "description": "Text for one account, keyed by account ref or id: title, caption, hashtags. Send only the accounts you are changing; every other account keeps its text. An entry is that account's whole text (a field it leaves out is cleared); null clears the account's text. Wins over channel_overrides and the base text.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "channel_overrides": { "type": "object", "description": "Text for every account of one platform, keyed by platform id (e.g. \"instagram\"): \"the Instagram caption\". Send only the platforms you are changing; null clears the text of that platform's accounts. An account_overrides entry for the same account wins field by field.", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "actions_by_account": { "type": "object", "description": "What happens once the post is live, keyed by the account it goes out on (ref or id): that account's whole ordered list. Its own comments (no actor) each reply to the one above after their delay (X and Bluesky). A comment with an actor is written by that other account of the same platform; a repost or quote is done by its actor, the posting account itself or another account of the same platform. Both count their delay from the post (comments X and Bluesky; reposts X, Bluesky and Threads; quotes Bluesky and Threads, never X). At most 10 per account; [] removes them. Send only the accounts you are changing; every other account keeps its actions. An account that has already published keeps its actions as they are.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "array", "items": { "oneOf": [ { "type": "object", "required": [ "kind", "text", "delay_minutes" ], "properties": { "kind": { "type": "string", "const": "comment" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1 }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "Another account of the same platform that writes this comment (ref or id), replying to the post itself. Omit for the account's own comment, which replies to the one above it. X and Bluesky." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the comment above went out (the post, for the first one, or for another account's comment), 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "repost" }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that reposts the post (ref or id): the posting account itself or another account of the same platform. X, Bluesky and Threads." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "text", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "quote" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1, "description": "What the quoting account says above the quoted post." }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that quotes the post (ref or id): the posting account itself or another account of the same platform. Bluesky and Threads; X accounts repost only." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false } ] }, "maxItems": 10 } }, "cover_timestamp_ms": { "type": "integer", "maximum": 9007199254740991, "minimum": 0, "description": "The video frame, in milliseconds, used as the cover when no cover image is set." }, "publish_at_overrides": { "type": "object", "description": "Scheduled posts only: a different time for one account, keyed by account ref or id (ISO 8601 with Z or an offset, as publish_at).", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "string" } } } }arguments 1142 lineslist_workspaces unknown never probed
Lists every workspace the user belongs to, marks the one this connection acts on, and says what each allows through the connector: none (Free or no plan) or full (Solo, Growth, Pro). Use this when the user names another workspace or a tool reports a plan lock; then switch_workspace moves the connection. Returns workspaces[] (id, name, slug, isOwner, current, plan, access). Does NOT switch, create or change any workspace.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }arguments 5 linesswitch_workspace unknown never probed
A connection acts on one workspace at a time. This moves it onto another workspace the user belongs to (id or slug from list_workspaces) for every later call, until switched again, and returns the new context. Use this when the user names a workspace other than the current one; confirm with them before switching. Returns switched and the full get_context shape for the new workspace, which says what that workspace's plan allows. Does NOT create workspaces and does NOT touch posts or accounts.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "workspace" ], "properties": { "workspace": { "type": "string", "minLength": 1, "description": "Workspace id or slug from list_workspaces." } } }arguments 14 lineslist_groups unknown never probed
Lists channel groups (named sets of accounts) with their member account ids. Use this when the user names a group ("post to my brand accounts") to resolve it to the account ids schedule_post takes. Returns groups[] (id, name, accountIds, accountCount), nextCursor and hasMore. Does NOT create or edit groups.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "name": { "type": "string", "description": "Filter by exact group name." }, "sort": { "enum": [ "createdAt", "name" ], "type": "string", "description": "createdAt (default) or name." }, "limit": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Page size, 1–100." }, "cursor": { "type": "string", "description": "Opaque cursor from the previous page. Omit for the first page." } } }arguments 29 lineslist_posts unknown never probed
Lists posts in the workspace: drafts, scheduled, published and failed. Use this to find drafts to schedule, to review the queue, or to find a post id for get_post, update_post, schedule_post (publish_now on a scheduled post) or delete_post (any status). Returns posts[] (id, status, type, title, content, mediaUrls, scheduledFor), nextCursor and hasMore. Refer to posts by title or caption when talking to the user; ids are for tool calls. Does NOT include per-account results; call get_post for those.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "to": { "type": "string", "description": "ISO 8601 upper bound on the sort field." }, "from": { "type": "string", "description": "ISO 8601 lower bound on the sort field." }, "sort": { "enum": [ "createdAt", "scheduledFor" ], "type": "string", "description": "createdAt (default) or scheduledFor (only posts that have one)." }, "limit": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Page size, 1–100." }, "order": { "enum": [ "asc", "desc" ], "type": "string" }, "cursor": { "type": "string", "description": "Opaque cursor from the previous page. Omit for the first page." }, "status": { "type": "string", "description": "draft, scheduled, published or failed." }, "accountId": { "type": "string", "description": "Only posts targeting this account." } } }arguments 48 linesget_post unknown never probed
Fetches one post with its per-account rows: status, publish time, published time and any error per account. Use this after schedule_post to confirm what happened, or when the user asks why a post failed. Returns the post (content, media, metadata, socialAccountIds) and targets[] with platform and username. Refer to posts by title or caption and to accounts by platform and username when talking to the user; ids are for tool calls. Does NOT retry or change the post.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "post_id" ], "properties": { "post_id": { "type": "string", "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)$", "description": "The post id from list_posts or create_post." } } }arguments 15 linescreate_post unknown never probed
Creates a draft post with everything the composer saves: caption, title, description, hashtags, media, the accounts it goes to, per-account text (account_overrides, channel_overrides), per-account media and covers, and each platform's settings. Media can be public URLs (downloaded and stored server-side) or media keys from upload_media. Facebook text post with a link: also set platform_settings.facebook.link (see that field) so Facebook shows a preview card. Use this only once you have the full brief from the user: the post type, the text, and the media if the type needs it. `type` is required and is never guessed: use the type the user stated (text, image, video, story or blog); if they did not say, ask them before calling this tool. A story is an Instagram or Facebook Story: one image or one video, no caption on Instagram. A blog post goes to WordPress: title is required and becomes the page heading. Put the body in description, as HTML; it is sent exactly as written. Plain text also works: blank lines become paragraphs. WordPress keeps p, br, hr, h2 to h6 (with id), ul, ol, li, blockquote, strong, em, a (href, rel, target, title), code, pre, abbr, time, figure, figcaption, the table tags and img (src, alt, width, height). Do not use h1 (the title is already the page heading), script or style (WordPress removes the tag but leaves its text visible). The first image is the featured image; any others are added under the body in order. Images only, no video. Then schedule_post puts the draft on the calendar. To schedule straight away, call schedule_post with the content instead: it creates and schedules in one call. Pass the same idempotency_key on a retry so a network error never makes two drafts. Returns the draft (post) plus warnings[] naming any platform whose caption limit the content exceeds, and created=false when the idempotency_key matched an existing draft. Does NOT schedule or publish anything.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "type" ], "properties": { "x": { "type": "object", "description": "x settings keyed by x account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI. Default false." }, "reply_settings": { "enum": [ "everyone", "following", "mentionedUsers", "verified", "subscribers" ], "type": "string", "description": "[optional] Who can reply: everyone, following (accounts you follow), mentionedUsers, verified or subscribers. Default everyone." }, "paid_partnership": { "type": "boolean", "description": "[optional] Label the post as a paid partnership. Default false." } } } }, "gbp": { "type": "object", "description": "gbp settings keyed by gbp account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "event": { "type": "object", "required": [ "title", "start_date", "end_date" ], "properties": { "title": { "type": "string", "maxLength": 300, "minLength": 1 }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "end_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "start_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" } }, "description": "[optional] Required for EVENT and OFFER. Dates YYYY-MM-DD, times HH:MM 24-hour in the business's own time; give both times or neither (no time shows as all day). Default none." }, "offer": { "type": "object", "properties": { "terms": { "type": "string", "maxLength": 1500 }, "redeem_url": { "type": "string", "format": "uri", "maxLength": 2048 }, "coupon_code": { "type": "string", "maxLength": 300 } }, "description": "[optional] OFFER only: coupon code, redeem link and terms, each optional. Default none." }, "topic_type": { "enum": [ "STANDARD", "EVENT", "OFFER" ], "type": "string", "description": "[optional] STANDARD is an update, EVENT an event, OFFER an offer. EVENT and OFFER need event. Default STANDARD." }, "language_code": { "type": "string", "description": "[optional] ISO 639-1 language of the post text, e.g. \"en\", \"ta\", \"es\". Default \"en\"." }, "call_to_action": { "type": "object", "required": [ "type" ], "properties": { "url": { "type": "string", "format": "uri", "maxLength": 2048 }, "type": { "enum": [ "BOOK", "ORDER", "SHOP", "LEARN_MORE", "SIGN_UP", "CALL" ], "type": "string" } }, "description": "[optional] A button on the post: BOOK, ORDER, SHOP, LEARN_MORE or SIGN_UP with a url, or CALL with no url (it rings the business phone). Not on OFFER. Default none." } } } }, "type": { "enum": [ "text", "image", "video", "story", "blog" ], "type": "string", "description": "Required. The type the user asked for. Ask if they have not said. story is an Instagram or Facebook Story with one media. blog is a WordPress blog post." }, "title": { "type": "string", "maxLength": 200, "description": "Title, used by platforms that have one (YouTube, Pinterest). Required for a blog post, where it becomes the WordPress page heading." }, "tiktok": { "type": "object", "description": "tiktok settings keyed by tiktok account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "delivery": { "enum": [ "direct_post" ], "type": "string", "description": "[optional] direct_post publishes the post to the account; it is the only value. Default direct_post." }, "location": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "pattern": "^\\d+$", "maxLength": 32 }, "name": { "type": "string", "maxLength": 300, "minLength": 1 } }, "description": "[optional] A place tagged on the post, as { id, name } from list_options req_type list_location with a query. TikTok Business accounts only (list_accounts shows api \"business\"); refused on a personal account. Default none." }, "ai_generated": { "type": "boolean", "description": "[optional] Label the post as AI-generated, on photo and video posts. Set it when the photos or the video were made or significantly edited with AI. TikTok does not let the label be removed after posting. Default false." }, "interactions": { "type": "object", "required": [ "comment", "duet", "stitch" ], "properties": { "duet": { "type": "boolean" }, "stitch": { "type": "boolean" }, "comment": { "type": "boolean" } }, "description": "[account default] Allow comments, duets and stitches on this post. Default: the switches saved on the account. Anything the creator turned off in TikTok stays off. Send only when the user asks." }, "brand_content": { "type": "boolean", "description": "[optional] Branded content for someone else. Needs commercial_content; cannot be SELF_ONLY. Default false." }, "brand_organic": { "type": "boolean", "description": "[optional] Promotes the creator's own brand. Needs commercial_content. Default false." }, "privacy_level": { "enum": [ "PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY" ], "type": "string", "description": "[optional] Who can see the post. SELF_ONLY when the user says \"only me\". Default PUBLIC_TO_EVERYONE." }, "commercial_content": { "type": "boolean", "description": "[optional] The post promotes a brand, product or service. Default false." } } } }, "tumblr": { "type": "object", "description": "tumblr settings keyed by tumblr account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A link Tumblr shows as a card on the post. A link in the caption stays plain text. Default none. Tags go in account_overrides hashtags." }, "source_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The post's Source credit. Default none." } } } }, "bluesky": { "type": "object", "description": "bluesky settings keyed by bluesky account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "alt_text", "labels" ], "properties": { "langs": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$" }, "maxItems": 3, "description": "[optional] The post's languages as BCP 47 codes (e.g. \"en\", \"pt-BR\"), at most 3. Bluesky uses them for language feeds. Default: none, Bluesky guesses." }, "labels": { "type": "array", "items": { "enum": [ "sexual", "nudity", "porn", "graphic-media" ], "type": "string" }, "description": "[optional] Content warnings: at most one of sexual (Suggestive), nudity, porn (Adult), plus graphic-media. Only on posts with images or video. Default []." }, "alt_text": { "type": "array", "items": { "type": "string" }, "description": "[optional] One description per file, in the order this account publishes its media; \"\" leaves a file undescribed. Exactly as many entries as files. Up to 2000 characters each. Default: no alt text." } } } }, "content": { "type": "string", "maxLength": 100000, "description": "The caption / body text." }, "youtube": { "type": "object", "description": "youtube settings keyed by youtube account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "category_id": { "type": "string", "pattern": "^\\d{1,3}$", "description": "[optional] YouTube category id, e.g. \"22\" People & Blogs, \"27\" Education, \"28\" Science & Technology. Default \"22\". Tags go in account_overrides hashtags, 500 characters in all." }, "made_for_kids": { "type": "boolean", "description": "[optional] Made for kids. YouTube turns off comments and personalised ads when true. Default false." }, "privacy_status": { "enum": [ "public", "unlisted", "private" ], "type": "string", "description": "[optional] Who can watch: public, unlisted (anyone with the link) or private. Default public." } } } }, "facebook": { "type": "object", "description": "facebook settings keyed by facebook account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A web address Facebook shows as a preview card under a text post. When a Facebook text post's caption has one link, set it here too so the card shows; with several links, ask the user which one. Ignored on a post with images or video. A link only in the caption shows as plain text. Default none." }, "feeling": { "type": "object", "required": [ "activity" ], "properties": { "text": { "type": "string", "maxLength": 100, "minLength": 1 }, "feeling": { "enum": [ "accomplished", "adventurous", "afraid", "aggravated", "alive", "alone", "amazed", "amazing", "amused", "angry", "annoyed", "anxious", "appreciated", "ashamed", "asleep", "awake", "awesome", "awful", "awkward", "bad", "beautiful", "betrayed", "better", "bitter", "blah", "blessed", "blissful", "blue", "bored", "brave", "broke", "broken", "bummed", "busy", "butterflies", "calm", "challenged", "cheated", "chill", "clean", "cold", "comfortable", "complete", "concerned", "confident", "conflicted", "confused", "connected", "content", "cool", "cozy", "crafty", "crappy", "crazy", "creative", "curious", "cute", "deep", "defeated", "delighted", "depressed", "desperate", "determined", "devastated", "different", "dirty", "disappointed", "discouraged", "disgusted", "dizzy", "done", "down", "drained", "drunk", "dumb", "ecstatic", "embarrassed", "emotional", "empowered", "energized", "enraged", "entertained", "evil", "excited", "exhausted", "fabulous", "fantastic", "fat", "fed up", "festive", "fine", "flirty", "focused", "fortunate", "free", "freezing", "fresh", "frozen", "frustrated", "full", "funky", "funny", "furious", "generous", "giddy", "glad", "good", "goofy", "grateful", "great", "gross", "grumpy", "guilty", "happy", "healthy", "heartbroken", "helpless", "homesick", "honored", "hopeful", "hopeless", "horrible", "hot", "human", "hungover", "hungry", "hurt", "hyper", "ignored", "ill", "impatient", "important", "impressed", "in love", "inadequate", "incomplete", "insecure", "inspired", "insulted", "invisible", "irritated", "jealous", "jolly", "joyful", "kind", "lame", "lazy", "light", "lonely", "lost", "lousy", "loved", "lovely", "low", "lucky", "mad", "meh", "mighty", "mischievous", "miserable", "missing", "motivated", "naked", "naughty", "nauseous", "needed", "neglected", "nerdy", "nervous", "nice", "normal", "nostalgic", "numb", "offended", "ok", "okay", "old", "optimistic", "overwhelmed", "pained", "peaceful", "perfect", "perplexed", "pissed", "pissed off", "positive", "pretty", "pride", "privileged", "productive", "professional", "proud", "pumped", "puzzled", "qualified", "ready", "refreshed", "regret", "relaxed", "relieved", "renewed", "rested", "restless", "rich", "romantic", "rough", "sad", "safe", "sarcastic", "satisfied", "scared", "secure", "sexy", "shame", "shattered", "shocked", "shy", "sick", "silly", "sleepy", "small", "smart", "sneaky", "sore", "sorry", "special", "spoiled", "spooky", "stoked", "strange", "stressed", "strong", "stuck", "stuffed", "stupid", "super", "surprised", "terrible", "thankful", "thirsty", "thoughtful", "threatened", "tipsy", "tired", "trapped", "ugly", "unappreciated", "uncomfortable", "undecided", "uneasy", "unhappy", "unimportant", "unloved", "unsure", "unwanted", "unwell", "upset", "useless", "wanted", "warm", "weak", "weird", "welcome", "welcomed", "well", "wet", "whole", "wonderful", "worried", "worse", "worthless", "young", "yucky" ], "type": "string" }, "activity": { "enum": [ "feeling", "eating", "drinking", "watching", "listening", "reading", "playing", "traveling", "going", "celebrating", "attending" ], "type": "string" } }, "description": "[optional] The Page's feeling or activity shown beside its name. activity feeling with feeling a name from the list, e.g. { activity: \"feeling\", feeling: \"happy\" } shows \"is feeling happy\"; any other activity with text, up to 100 characters, e.g. { activity: \"playing\", text: \"Minecraft\" } shows \"is playing Minecraft\". On text and photo posts only; refused on a video, Reel or Story. Default none." }, "video_as": { "type": "string", "const": "reel", "description": "[optional] Publish a video as a Reel: 3 to 90 seconds, vertical 9:16, at most 30 Reels per Page per day. Default: a classic Page video." }, "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI (\"AI info\" on Facebook). On text posts, photo posts and Reels (video_as reel); refused on a classic Page video and on a Story. Default false." } } } }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "Without the # is fine." }, "cover_key": { "type": "string", "description": "media_key of a cover image for video posts." }, "instagram": { "type": "object", "description": "instagram settings keyed by instagram account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "trial_reel": { "enum": [ "manual", "auto" ], "type": "string", "description": "[optional] Share a Reel as a Trial Reel, to non-followers first. manual: you decide whether it goes to followers; auto: Instagram decides on performance. Reels with one video only. Default: a normal Reel." } } } }, "pinterest": { "type": "object", "description": "pinterest settings keyed by pinterest account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "board_id" ], "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The Pin's clickable destination. A URL in the caption is never clickable on Pinterest. Default none." }, "alt_text": { "type": "string", "maxLength": 500, "description": "[optional] Describes the image for screen readers. Default none; the title is never used." }, "board_id": { "type": "string", "pattern": "^\\d+$", "description": "[account default] The board the Pin goes on. Default: the account's saved board, and no account has one yet, so every Pin needs this: ask the user which board, from list_options req_type list_board." } } } }, "wordpress": { "type": "object", "description": "wordpress settings keyed by wordpress account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "seo": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "focus_keyphrase": { "type": "string", "minLength": 1 } }, "description": "[optional] Yoast SEO fields. Only for an account whose list_accounts entry shows seo \"yoast\". Default: Yoast's own." }, "slug": { "type": "string", "maxLength": 200, "minLength": 1, "description": "[optional] The URL slug. Default: made from the title." }, "tags": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Tag names; a new one is created. Only for a post type that has tags. Default none." }, "terms": { "type": "object", "description": "[optional] Terms of the post type's own taxonomies, as { taxonomy slug: [names] }, e.g. { \"genre\": [\"Romance\"] }. list_post_type names each type's taxonomies. Names must already exist on the site; an unknown one is refused at schedule with the site's list. Default none.", "propertyNames": { "type": "string", "pattern": "^[a-z0-9_-]{1,32}$" }, "additionalProperties": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 } }, "status": { "enum": [ "publish", "draft", "pending", "private" ], "type": "string", "description": "[optional] publish; draft or pending (Pending review) to review it in wp-admin; private for logged-in editors only. Default publish." }, "excerpt": { "type": "string", "minLength": 1, "description": "[optional] Short summary for feeds and link previews. Default: WordPress makes one from the body." }, "post_type": { "type": "string", "pattern": "^[a-z0-9_-]{1,20}$", "description": "[optional] The post type to publish as, e.g. a short story instead of a blog post: a slug from list_options req_type list_post_type. Default post." }, "categories": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Category names that already exist on the site; an unknown one is refused at schedule with the site's list. Only for a post type that has categories. Default: the site's default category." }, "featured_image_alt": { "type": "string", "minLength": 1, "description": "[optional] Alt text for the featured image (the first image). Default none." } } } }, "media_keys": { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20, "description": "media_key values from upload_media." }, "media_urls": { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20, "description": "Public http(s) URLs of the ORIGINAL files to download and attach, up to 100 MB each. Never a re-encoded copy." }, "account_ids": { "type": "array", "items": { "type": "string", "maxLength": 300, "minLength": 1 }, "maxItems": 10, "minItems": 1, "description": "Where this post goes: each account's ref from list_accounts (e.g. \"x:acme_studio\"), or its id. Prefer the ref; it is what the person reads when approving. Always the complete list, unlike the per-account maps: an account left out is removed from the post, with its text and settings." }, "description": { "type": "string" }, "idempotency_key": { "type": "string", "maxLength": 200, "description": "Any unique string; a repeat with the same key returns the same draft." }, "cover_by_account": { "type": "object", "description": "One account's own video cover, keyed by account ref or id: a media_key, or null to use the post's cover.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] } }, "media_by_account": { "type": "object", "description": "One account's own media, keyed by account ref or id: its whole ordered list of media_key values; [] posts no media there, null goes back to the post's media.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20 }, { "type": "null" } ] } }, "account_overrides": { "type": "object", "description": "Text for one account, keyed by account ref or id: title, caption, hashtags. Send only the accounts you are changing; every other account keeps its text. An entry is that account's whole text (a field it leaves out is cleared); null clears the account's text. Wins over channel_overrides and the base text.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "channel_overrides": { "type": "object", "description": "Text for every account of one platform, keyed by platform id (e.g. \"instagram\"): \"the Instagram caption\". Send only the platforms you are changing; null clears the text of that platform's accounts. An account_overrides entry for the same account wins field by field.", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "actions_by_account": { "type": "object", "description": "What happens once the post is live, keyed by the account it goes out on (ref or id): that account's whole ordered list. Its own comments (no actor) each reply to the one above after their delay (X and Bluesky). A comment with an actor is written by that other account of the same platform; a repost or quote is done by its actor, the posting account itself or another account of the same platform. Both count their delay from the post (comments X and Bluesky; reposts X, Bluesky and Threads; quotes Bluesky and Threads, never X). At most 10 per account; [] removes them. Send only the accounts you are changing; every other account keeps its actions. An account that has already published keeps its actions as they are.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "array", "items": { "oneOf": [ { "type": "object", "required": [ "kind", "text", "delay_minutes" ], "properties": { "kind": { "type": "string", "const": "comment" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1 }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "Another account of the same platform that writes this comment (ref or id), replying to the post itself. Omit for the account's own comment, which replies to the one above it. X and Bluesky." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the comment above went out (the post, for the first one, or for another account's comment), 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "repost" }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that reposts the post (ref or id): the posting account itself or another account of the same platform. X, Bluesky and Threads." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "text", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "quote" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1, "description": "What the quoting account says above the quoted post." }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that quotes the post (ref or id): the posting account itself or another account of the same platform. Bluesky and Threads; X accounts repost only." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false } ] }, "maxItems": 10 } }, "cover_timestamp_ms": { "type": "integer", "maximum": 9007199254740991, "minimum": 0, "description": "The video frame, in milliseconds, used as the cover when no cover image is set." } } }arguments 1125 linesdelete_post unknown never probed
Permanently deletes a post in any status (draft, scheduled, failed or published) from JuzPost, with its per-account rows. A scheduled post's timer is cancelled first, so it never publishes; a published post's analytics in JuzPost go with it. Use this only when the user explicitly asks to delete the post. Returns deleted=true, the post id and what the deleted post was (title, caption, type, media count). Does NOT remove anything already published on a platform: the post stays there and has to be deleted on the platform itself.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "post_id" ], "properties": { "post_id": { "type": "string", "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)$" } } }arguments 14 linesschedule_post unknown never probed
Schedules a post to one or more accounts at publish_at, or publishes immediately with publish_now=true. This publishes to real accounts. Times are ISO 8601 ending in Z or an offset, like 2026-11-03T09:00:00+05:30: use the user's own local time with its offset. workspace.timezone from get_context is the workspace's display zone, not necessarily where the user is; if you are unsure of their timezone, ask them. Facebook text post with a link: also set platform_settings.facebook.link (see that field) so Facebook shows a preview card. One call does it all: without post_id it creates the post from the content and settings given and schedules it; with post_id it schedules that draft, applying any fields sent first. type story is an Instagram or Facebook Story: one image or one video, no caption on Instagram. With the post_id of a post that is already scheduled and publish_now=true, it publishes that post now instead of at its time, after the same checks a post published now faces: a refused check leaves it scheduled as it was, and a post under 10 minutes from its time is refused. To change a scheduled post's content or time, use update_post. It takes everything the composer can set: caption, title, media, accounts, per-account text (account_overrides, channel_overrides), per-account media and covers, per-account times, and each platform's settings. With post_id, the per-account maps change only the accounts they name, as in update_post: every other account keeps what the draft has. account_ids is the complete list: an account left out is removed. Each platform setting says whether it is required, an account default or optional; a Pinterest account needs pinterest.board_id, from list_options. Every problem on every account is refused in one error, before anything is armed. Use this only after the user has confirmed the content, the accounts and the time. A refused call writes nothing: no draft is created and no draft is changed. Pass the same idempotency_key on a retry without post_id so a network error never makes two posts; with post_id a retry is safe as is: a post already publishing or published answers its current statuses and is never published twice. Returns success, post_id and results[] with one row per account (platform, username, status, error). Call get_post afterwards to show exactly what was scheduled. Does NOT publish now unless publish_now is true.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "x": { "type": "object", "description": "x settings keyed by x account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI. Default false." }, "reply_settings": { "enum": [ "everyone", "following", "mentionedUsers", "verified", "subscribers" ], "type": "string", "description": "[optional] Who can reply: everyone, following (accounts you follow), mentionedUsers, verified or subscribers. Default everyone." }, "paid_partnership": { "type": "boolean", "description": "[optional] Label the post as a paid partnership. Default false." } } } }, "gbp": { "type": "object", "description": "gbp settings keyed by gbp account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "event": { "type": "object", "required": [ "title", "start_date", "end_date" ], "properties": { "title": { "type": "string", "maxLength": 300, "minLength": 1 }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "end_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "start_time": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" } }, "description": "[optional] Required for EVENT and OFFER. Dates YYYY-MM-DD, times HH:MM 24-hour in the business's own time; give both times or neither (no time shows as all day). Default none." }, "offer": { "type": "object", "properties": { "terms": { "type": "string", "maxLength": 1500 }, "redeem_url": { "type": "string", "format": "uri", "maxLength": 2048 }, "coupon_code": { "type": "string", "maxLength": 300 } }, "description": "[optional] OFFER only: coupon code, redeem link and terms, each optional. Default none." }, "topic_type": { "enum": [ "STANDARD", "EVENT", "OFFER" ], "type": "string", "description": "[optional] STANDARD is an update, EVENT an event, OFFER an offer. EVENT and OFFER need event. Default STANDARD." }, "language_code": { "type": "string", "description": "[optional] ISO 639-1 language of the post text, e.g. \"en\", \"ta\", \"es\". Default \"en\"." }, "call_to_action": { "type": "object", "required": [ "type" ], "properties": { "url": { "type": "string", "format": "uri", "maxLength": 2048 }, "type": { "enum": [ "BOOK", "ORDER", "SHOP", "LEARN_MORE", "SIGN_UP", "CALL" ], "type": "string" } }, "description": "[optional] A button on the post: BOOK, ORDER, SHOP, LEARN_MORE or SIGN_UP with a url, or CALL with no url (it rings the business phone). Not on OFFER. Default none." } } } }, "type": { "enum": [ "text", "image", "video", "story", "blog" ], "type": "string", "description": "Required without post_id: the type the user asked for. Ask if they have not said. story is an Instagram or Facebook Story with one media. blog is a WordPress blog post." }, "title": { "type": "string", "maxLength": 200, "description": "Title, used by platforms that have one (YouTube, Pinterest). Required for a blog post, where it becomes the WordPress page heading." }, "tiktok": { "type": "object", "description": "tiktok settings keyed by tiktok account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "delivery": { "enum": [ "direct_post" ], "type": "string", "description": "[optional] direct_post publishes the post to the account; it is the only value. Default direct_post." }, "location": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string", "pattern": "^\\d+$", "maxLength": 32 }, "name": { "type": "string", "maxLength": 300, "minLength": 1 } }, "description": "[optional] A place tagged on the post, as { id, name } from list_options req_type list_location with a query. TikTok Business accounts only (list_accounts shows api \"business\"); refused on a personal account. Default none." }, "ai_generated": { "type": "boolean", "description": "[optional] Label the post as AI-generated, on photo and video posts. Set it when the photos or the video were made or significantly edited with AI. TikTok does not let the label be removed after posting. Default false." }, "interactions": { "type": "object", "required": [ "comment", "duet", "stitch" ], "properties": { "duet": { "type": "boolean" }, "stitch": { "type": "boolean" }, "comment": { "type": "boolean" } }, "description": "[account default] Allow comments, duets and stitches on this post. Default: the switches saved on the account. Anything the creator turned off in TikTok stays off. Send only when the user asks." }, "brand_content": { "type": "boolean", "description": "[optional] Branded content for someone else. Needs commercial_content; cannot be SELF_ONLY. Default false." }, "brand_organic": { "type": "boolean", "description": "[optional] Promotes the creator's own brand. Needs commercial_content. Default false." }, "privacy_level": { "enum": [ "PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY" ], "type": "string", "description": "[optional] Who can see the post. SELF_ONLY when the user says \"only me\". Default PUBLIC_TO_EVERYONE." }, "commercial_content": { "type": "boolean", "description": "[optional] The post promotes a brand, product or service. Default false." } } } }, "tumblr": { "type": "object", "description": "tumblr settings keyed by tumblr account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A link Tumblr shows as a card on the post. A link in the caption stays plain text. Default none. Tags go in account_overrides hashtags." }, "source_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The post's Source credit. Default none." } } } }, "bluesky": { "type": "object", "description": "bluesky settings keyed by bluesky account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "alt_text", "labels" ], "properties": { "langs": { "type": "array", "items": { "type": "string", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$" }, "maxItems": 3, "description": "[optional] The post's languages as BCP 47 codes (e.g. \"en\", \"pt-BR\"), at most 3. Bluesky uses them for language feeds. Default: none, Bluesky guesses." }, "labels": { "type": "array", "items": { "enum": [ "sexual", "nudity", "porn", "graphic-media" ], "type": "string" }, "description": "[optional] Content warnings: at most one of sexual (Suggestive), nudity, porn (Adult), plus graphic-media. Only on posts with images or video. Default []." }, "alt_text": { "type": "array", "items": { "type": "string" }, "description": "[optional] One description per file, in the order this account publishes its media; \"\" leaves a file undescribed. Exactly as many entries as files. Up to 2000 characters each. Default: no alt text." } } } }, "content": { "type": "string", "maxLength": 100000, "description": "The caption / body text." }, "post_id": { "type": "string", "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)$", "description": "A draft from create_post or list_posts, or a scheduled post to publish now with publish_now. Leave out to create the post in this call." }, "youtube": { "type": "object", "description": "youtube settings keyed by youtube account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "category_id": { "type": "string", "pattern": "^\\d{1,3}$", "description": "[optional] YouTube category id, e.g. \"22\" People & Blogs, \"27\" Education, \"28\" Science & Technology. Default \"22\". Tags go in account_overrides hashtags, 500 characters in all." }, "made_for_kids": { "type": "boolean", "description": "[optional] Made for kids. YouTube turns off comments and personalised ads when true. Default false." }, "privacy_status": { "enum": [ "public", "unlisted", "private" ], "type": "string", "description": "[optional] Who can watch: public, unlisted (anyone with the link) or private. Default public." } } } }, "facebook": { "type": "object", "description": "facebook settings keyed by facebook account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] A web address Facebook shows as a preview card under a text post. When a Facebook text post's caption has one link, set it here too so the card shows; with several links, ask the user which one. Ignored on a post with images or video. A link only in the caption shows as plain text. Default none." }, "feeling": { "type": "object", "required": [ "activity" ], "properties": { "text": { "type": "string", "maxLength": 100, "minLength": 1 }, "feeling": { "enum": [ "accomplished", "adventurous", "afraid", "aggravated", "alive", "alone", "amazed", "amazing", "amused", "angry", "annoyed", "anxious", "appreciated", "ashamed", "asleep", "awake", "awesome", "awful", "awkward", "bad", "beautiful", "betrayed", "better", "bitter", "blah", "blessed", "blissful", "blue", "bored", "brave", "broke", "broken", "bummed", "busy", "butterflies", "calm", "challenged", "cheated", "chill", "clean", "cold", "comfortable", "complete", "concerned", "confident", "conflicted", "confused", "connected", "content", "cool", "cozy", "crafty", "crappy", "crazy", "creative", "curious", "cute", "deep", "defeated", "delighted", "depressed", "desperate", "determined", "devastated", "different", "dirty", "disappointed", "discouraged", "disgusted", "dizzy", "done", "down", "drained", "drunk", "dumb", "ecstatic", "embarrassed", "emotional", "empowered", "energized", "enraged", "entertained", "evil", "excited", "exhausted", "fabulous", "fantastic", "fat", "fed up", "festive", "fine", "flirty", "focused", "fortunate", "free", "freezing", "fresh", "frozen", "frustrated", "full", "funky", "funny", "furious", "generous", "giddy", "glad", "good", "goofy", "grateful", "great", "gross", "grumpy", "guilty", "happy", "healthy", "heartbroken", "helpless", "homesick", "honored", "hopeful", "hopeless", "horrible", "hot", "human", "hungover", "hungry", "hurt", "hyper", "ignored", "ill", "impatient", "important", "impressed", "in love", "inadequate", "incomplete", "insecure", "inspired", "insulted", "invisible", "irritated", "jealous", "jolly", "joyful", "kind", "lame", "lazy", "light", "lonely", "lost", "lousy", "loved", "lovely", "low", "lucky", "mad", "meh", "mighty", "mischievous", "miserable", "missing", "motivated", "naked", "naughty", "nauseous", "needed", "neglected", "nerdy", "nervous", "nice", "normal", "nostalgic", "numb", "offended", "ok", "okay", "old", "optimistic", "overwhelmed", "pained", "peaceful", "perfect", "perplexed", "pissed", "pissed off", "positive", "pretty", "pride", "privileged", "productive", "professional", "proud", "pumped", "puzzled", "qualified", "ready", "refreshed", "regret", "relaxed", "relieved", "renewed", "rested", "restless", "rich", "romantic", "rough", "sad", "safe", "sarcastic", "satisfied", "scared", "secure", "sexy", "shame", "shattered", "shocked", "shy", "sick", "silly", "sleepy", "small", "smart", "sneaky", "sore", "sorry", "special", "spoiled", "spooky", "stoked", "strange", "stressed", "strong", "stuck", "stuffed", "stupid", "super", "surprised", "terrible", "thankful", "thirsty", "thoughtful", "threatened", "tipsy", "tired", "trapped", "ugly", "unappreciated", "uncomfortable", "undecided", "uneasy", "unhappy", "unimportant", "unloved", "unsure", "unwanted", "unwell", "upset", "useless", "wanted", "warm", "weak", "weird", "welcome", "welcomed", "well", "wet", "whole", "wonderful", "worried", "worse", "worthless", "young", "yucky" ], "type": "string" }, "activity": { "enum": [ "feeling", "eating", "drinking", "watching", "listening", "reading", "playing", "traveling", "going", "celebrating", "attending" ], "type": "string" } }, "description": "[optional] The Page's feeling or activity shown beside its name. activity feeling with feeling a name from the list, e.g. { activity: \"feeling\", feeling: \"happy\" } shows \"is feeling happy\"; any other activity with text, up to 100 characters, e.g. { activity: \"playing\", text: \"Minecraft\" } shows \"is playing Minecraft\". On text and photo posts only; refused on a video, Reel or Story. Default none." }, "video_as": { "type": "string", "const": "reel", "description": "[optional] Publish a video as a Reel: 3 to 90 seconds, vertical 9:16, at most 30 Reels per Page per day. Default: a classic Page video." }, "made_with_ai": { "type": "boolean", "description": "[optional] Label the post as made with AI (\"AI info\" on Facebook). On text posts, photo posts and Reels (video_as reel); refused on a classic Page video and on a Story. Default false." } } } }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "Without the # is fine." }, "cover_key": { "type": "string", "description": "media_key of a cover image for video posts." }, "instagram": { "type": "object", "description": "instagram settings keyed by instagram account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "trial_reel": { "enum": [ "manual", "auto" ], "type": "string", "description": "[optional] Share a Reel as a Trial Reel, to non-followers first. manual: you decide whether it goes to followers; auto: Instagram decides on performance. Reels with one video only. Default: a normal Reel." } } } }, "pinterest": { "type": "object", "description": "pinterest settings keyed by pinterest account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "required": [ "board_id" ], "properties": { "link": { "type": "string", "format": "uri", "maxLength": 2048, "description": "[optional] The Pin's clickable destination. A URL in the caption is never clickable on Pinterest. Default none." }, "alt_text": { "type": "string", "maxLength": 500, "description": "[optional] Describes the image for screen readers. Default none; the title is never used." }, "board_id": { "type": "string", "pattern": "^\\d+$", "description": "[account default] The board the Pin goes on. Default: the account's saved board, and no account has one yet, so every Pin needs this: ask the user which board, from list_options req_type list_board." } } } }, "wordpress": { "type": "object", "description": "wordpress settings keyed by wordpress account (ref or id). Each field says whether it is required, an account default or optional. Send only the accounts you are changing: an entry is that account's whole settings, and every other account keeps its own.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "seo": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "focus_keyphrase": { "type": "string", "minLength": 1 } }, "description": "[optional] Yoast SEO fields. Only for an account whose list_accounts entry shows seo \"yoast\". Default: Yoast's own." }, "slug": { "type": "string", "maxLength": 200, "minLength": 1, "description": "[optional] The URL slug. Default: made from the title." }, "tags": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Tag names; a new one is created. Only for a post type that has tags. Default none." }, "terms": { "type": "object", "description": "[optional] Terms of the post type's own taxonomies, as { taxonomy slug: [names] }, e.g. { \"genre\": [\"Romance\"] }. list_post_type names each type's taxonomies. Names must already exist on the site; an unknown one is refused at schedule with the site's list. Default none.", "propertyNames": { "type": "string", "pattern": "^[a-z0-9_-]{1,32}$" }, "additionalProperties": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 } }, "status": { "enum": [ "publish", "draft", "pending", "private" ], "type": "string", "description": "[optional] publish; draft or pending (Pending review) to review it in wp-admin; private for logged-in editors only. Default publish." }, "excerpt": { "type": "string", "minLength": 1, "description": "[optional] Short summary for feeds and link previews. Default: WordPress makes one from the body." }, "post_type": { "type": "string", "pattern": "^[a-z0-9_-]{1,20}$", "description": "[optional] The post type to publish as, e.g. a short story instead of a blog post: a slug from list_options req_type list_post_type. Default post." }, "categories": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "[optional] Category names that already exist on the site; an unknown one is refused at schedule with the site's list. Only for a post type that has categories. Default: the site's default category." }, "featured_image_alt": { "type": "string", "minLength": 1, "description": "[optional] Alt text for the featured image (the first image). Default none." } } } }, "media_keys": { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20, "description": "media_key values from upload_media." }, "media_urls": { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20, "description": "Without post_id: public http(s) URLs of the ORIGINAL files to download and attach, up to 100 MB each." }, "publish_at": { "type": "string", "description": "ISO 8601 with Z or an offset, in the user's own local time, like 2026-11-03T09:00:00+05:30. At least 10 minutes ahead. Either this or publish_now." }, "account_ids": { "type": "array", "items": { "type": "string", "maxLength": 300, "minLength": 1 }, "maxItems": 10, "minItems": 1, "description": "Where this post goes: each account's ref from list_accounts (e.g. \"x:acme_studio\"), or its id. Prefer the ref; it is what the person reads when approving. Always the complete list, unlike the per-account maps: an account left out is removed from the post, with its text and settings." }, "description": { "type": "string" }, "publish_now": { "type": "boolean", "description": "true to publish immediately, a scheduled post included. Either this or publish_at." }, "idempotency_key": { "type": "string", "maxLength": 200, "description": "Without post_id: any unique string; a retry with the same key never makes a second post." }, "cover_by_account": { "type": "object", "description": "One account's own video cover, keyed by account ref or id: a media_key, or null to use the post's cover.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] } }, "media_by_account": { "type": "object", "description": "One account's own media, keyed by account ref or id: its whole ordered list of media_key values; [] posts no media there, null goes back to the post's media.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "array", "items": { "type": "string", "maxLength": 512 }, "maxItems": 20 }, { "type": "null" } ] } }, "account_overrides": { "type": "object", "description": "Text for one account, keyed by account ref or id: title, caption, hashtags. Send only the accounts you are changing; every other account keeps its text. An entry is that account's whole text (a field it leaves out is cleared); null clears the account's text. Wins over channel_overrides and the base text.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "channel_overrides": { "type": "object", "description": "Text for every account of one platform, keyed by platform id (e.g. \"instagram\"): \"the Instagram caption\". Send only the platforms you are changing; null clears the text of that platform's accounts. An account_overrides entry for the same account wins field by field.", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "maxLength": 10000 }, "hashtags": { "type": "array", "items": { "type": "string", "maxLength": 100 }, "maxItems": 30 }, "description": { "type": "string", "description": "This account's caption. \"\" posts no text on this account." } } }, { "type": "null" } ] } }, "actions_by_account": { "type": "object", "description": "What happens once the post is live, keyed by the account it goes out on (ref or id): that account's whole ordered list. Its own comments (no actor) each reply to the one above after their delay (X and Bluesky). A comment with an actor is written by that other account of the same platform; a repost or quote is done by its actor, the posting account itself or another account of the same platform. Both count their delay from the post (comments X and Bluesky; reposts X, Bluesky and Threads; quotes Bluesky and Threads, never X). At most 10 per account; [] removes them. Send only the accounts you are changing; every other account keeps its actions. An account that has already published keeps its actions as they are.", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "array", "items": { "oneOf": [ { "type": "object", "required": [ "kind", "text", "delay_minutes" ], "properties": { "kind": { "type": "string", "const": "comment" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1 }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "Another account of the same platform that writes this comment (ref or id), replying to the post itself. Omit for the account's own comment, which replies to the one above it. X and Bluesky." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the comment above went out (the post, for the first one, or for another account's comment), 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "repost" }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that reposts the post (ref or id): the posting account itself or another account of the same platform. X, Bluesky and Threads." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false }, { "type": "object", "required": [ "kind", "text", "delay_minutes", "actor" ], "properties": { "kind": { "type": "string", "const": "quote" }, "text": { "type": "string", "maxLength": 100000, "minLength": 1, "description": "What the quoting account says above the quoted post." }, "actor": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The account that quotes the post (ref or id): the posting account itself or another account of the same platform. Bluesky and Threads; X accounts repost only." }, "delay_minutes": { "type": "integer", "maximum": 1440, "minimum": 0, "description": "Minutes to wait after the post went out, 0 to 1440." } }, "additionalProperties": false } ] }, "maxItems": 10 } }, "cover_timestamp_ms": { "type": "integer", "maximum": 9007199254740991, "minimum": 0, "description": "The video frame, in milliseconds, used as the cover when no cover image is set." }, "publish_at_overrides": { "type": "object", "description": "A different publish time for one account, keyed by account ref or id (ISO 8601 with Z or an offset, as publish_at).", "propertyNames": { "type": "string", "maxLength": 300, "minLength": 1 }, "additionalProperties": { "type": "string" } } } }arguments 1148 linesupload_file unknown never probed
Shows an upload card where the user picks images or videos from their device (images up to 20 MB, videos up to 1 GB); the card stores the original files in the workspace. Use this in a chat app that shows cards (Claude.ai, Claude Desktop, Claude mobile) whenever the user attached a file in the chat or wants to add one from their device: you cannot read their attachment, so let them pick it here. When they finish, the card adds each file name and media_key to your context and asks the user to send a message; pass those media_key values to create_post or update_post. Returns nothing to attach by itself. Does NOT work in Claude Code or a terminal (use create_upload_url there) and does NOT take a link (use upload_media).
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": {} }arguments 5 linesupload_media unknown never probed
Stores the original image or video in the workspace from a file the chat app hands over, a public URL (up to 1 GB for a video) or inline base64 (up to 3 MB), checking the real file type and the storage quota. Use this when the user gives you a link to attach to a post, or when the chat app hands you their attachment as `file` (ChatGPT does); then pass the returned media_key to create_post or update_post. `file` is filled by the chat app with an https download link, never by you: a path you see such as /mnt/user-data/uploads/… is on the user's side and cannot be read here. For a file the user attached or has on their device, call upload_file in a chat app that shows cards (Claude), or create_upload_url in Claude Code or a terminal. Use `base64` only with the original bytes of a small image you read from disk; never draw, reconstruct, re-encode or compress an image you have only seen. Returns media_key, bytes, content_type and source. Does NOT attach the file to any post by itself and does NOT accept private or local-network URLs.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "url": { "type": "string", "description": "Public http(s) URL of the original file. Either this, file or base64." }, "file": { "type": "object", "required": [ "download_url", "file_id" ], "properties": { "file_id": { "type": "string" }, "file_name": { "type": "string" }, "mime_type": { "type": "string" }, "download_url": { "type": "string" } }, "description": "Filled by the chat app (ChatGPT) with the attachment's https download_url; never a local path. Either this, url or base64.", "additionalProperties": false }, "base64": { "type": "string", "description": "The original file bytes as base64, read from disk (a data: URI is fine). Either this, file or url." }, "filename": { "type": "string", "description": "File name for a base64 upload; a file or url is named by its import." }, "content_type": { "type": "string", "description": "MIME type of the base64 bytes, e.g. image/jpeg. Required with base64, used with nothing else: a file or url is typed from its own bytes." } } }arguments 45 linescreate_upload_url unknown never probed
Reserves storage for one file and returns a presigned upload_url (valid 1 day) plus the media_key it will be stored under. Images up to 20 MB, videos up to 1 GB. Use this in Claude Code, a terminal or a script, for a local file or any video: PUT the ORIGINAL file bytes, unmodified, to upload_url with the returned content-type header and exactly `bytes` bytes, then pass media_key to create_post or update_post. Never re-encode, resize or compress the file first. In a chat app that shows cards (Claude.ai, Claude Desktop, Claude mobile) call upload_file instead: the user picks the file and nothing has to be allowed. The PUT goes to the storage host in upload_url (<account>.r2.cloudflarestorage.com). A code sandbox that blocks it needs that host allowed: On Claude.ai a Pro or Max user allows it in Settings → Capabilities; on a Team or Enterprise plan the organization owner adds it in Admin settings → Capabilities → Additional allowed domains. Returns upload_url, media_key, headers and expires_in. Does NOT upload anything by itself, and does NOT accept a URL or base64; use upload_media for those.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "filename", "content_type", "bytes" ], "properties": { "bytes": { "type": "integer", "maximum": 9007199254740991, "description": "Exact size of the file in bytes. The URL only accepts a body of this length.", "exclusiveMinimum": 0 }, "filename": { "type": "string", "maxLength": 200, "minLength": 1, "description": "The file name with its extension, e.g. clip.mp4." }, "content_type": { "type": "string", "description": "MIME type of the file, e.g. video/mp4 or image/png." } } }arguments 27 linesupload_begin unknown never probed
Called only by the JuzPost upload card, never by the model. Reserves storage for one file and starts a multipart upload. Returns media_key, upload_id, part_size and parts.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "filename", "content_type", "bytes" ], "properties": { "bytes": { "type": "integer", "maximum": 9007199254740991, "exclusiveMinimum": 0 }, "filename": { "type": "string", "maxLength": 200, "minLength": 1 }, "content_type": { "type": "string" } } }arguments 24 linesupload_part unknown never probed
Called only by the JuzPost upload card, never by the model. Stores one part of a file started with upload_begin: the original bytes as base64, exactly part_size bytes except the last part. Returns part_number and bytes.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "media_key", "upload_id", "part_number", "data" ], "properties": { "data": { "type": "string", "description": "The part bytes as base64." }, "media_key": { "type": "string" }, "upload_id": { "type": "string" }, "part_number": { "type": "integer", "maximum": 9007199254740991, "minimum": 1 } } }arguments 27 linesupload_finish unknown never probed
Called only by the JuzPost upload card, never by the model. Completes an upload once every part is stored. Returns media_key, bytes and content_type.
{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "media_key", "upload_id" ], "properties": { "media_key": { "type": "string" }, "upload_id": { "type": "string" } } }arguments 16 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's id6979a971ac947fa4.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/6979a971ac947fa4/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/6979a971ac947fa4?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.