{"id":"social.flayr/flayr","slug":"social-flayr-flayr","title":"flayr","description":"Create, schedule and publish social posts to 13 platforms for your brands.","version":"1.2.0","publisher":{"kind":"domain","id":"flayr.social","label":"flayr.social","url":"https://flayr.social"},"website":"https://flayr.social","repository":"","remotes":[{"type":"streamable-http","url":"https://flayr.social/api/mcp"}],"packages":[],"published":"2026-10-29","updated":"2026-10-29","status":"online","auth":"","latency_ms":1028,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"whoami","title":"Check this connection","description":"[read-only] Returns who this connection (an OAuth sign-in or an API key) belongs to: userId, the account's current plan tier, and brandId/brandName when the connection is bound to one brand (null = account-wide). Call this first to learn what the connection can reach.\n(Wraps GET /api/v2/ping.)","read_only":true},{"name":"list_brands","title":"List brands","description":"[read-only] Lists the brands this connection can file content into and publish through. Use an `id` as `brandId` on create_content, publish, queues and analytics tools; \"personal\" means the account owner's personal accounts. A connection bound to one brand sees only that brand (and personal is null). Each brand has its `website` and a `setup` checklist (hasBrandKey, hasWebsite, hasCtaGoal, adsConn","read_only":true},{"name":"create_brand","title":"Create a brand","description":"[writes flayr data · `write` scope] Creates a new brand in the account owner's organization, the same as \"New brand\" in the dashboard. Send `name` and optionally `website`, like `{ name: \"Dragon Shop\", website: \"https://shop.example.com\" }`. Only an ACCOUNT-WIDE connection with the write scope can do this; a connection bound to one brand gets 403. The plan's brand limit applies: at the limit the c","read_only":false},{"name":"brand_profile_get","title":"Get a brand profile","description":"[read-only] A brand's profile (website, companyName, tagline, industry, audience, values, pillars, hashtag sets), its default voice, colors and fonts. `brandId` comes from list_brands; a brand-bound connection may omit it.\n(Wraps GET /api/v2/brand/intelligence.)","read_only":true},{"name":"list_connected_accounts","title":"List connected social accounts","description":"[read-only] The social accounts a brand can post to — the same set publish would use for that `brandId`: platform, handle, display name, health (healthy, needs_reauth, disconnected), whether it is the brand's default for its platform (`isDefault`) and whether flayr can post there right now (`postable`; Reddit is paused because Reddit closed its API to third-party apps). Call this before publish to","read_only":true},{"name":"account_trial_get","title":"Get the account trial","description":"[read-only] The connected account's trial: which one it is on (`current.label`, e.g. the 14-day posting trial, a plan trial or a comped plan), the day and days left, the end date, what it falls back to (`current.fallsBackTo`) and what happens at the end (`current.after`). `posts.heldCount` / `heldPosts`: booked posts held after a trial ended; they are never deleted and post again once the plan inc","read_only":true},{"name":"upload_media","title":"Get a media upload URL","description":"[writes flayr data · `write` scope] Step 1 of attaching a LOCAL file (video, image or audio) to a draft. Returns a single-use, short-lived `uploadUrl`. Step 2: POST the raw file bytes to it with the file's Content-Type, e.g. `curl -X POST -H \"Content-Type: video/mp4\" --data-binary @clip.mp4 \"<uploadUrl>\"` — the JSON response has a `storageId`. Step 3: pass it as `videoStorageId` or `imageStorageId","read_only":false},{"name":"create_content","title":"Create a draft","description":"[writes flayr data · `write` scope] `altText` is a string for one image or one string per carousel slide in images / imageStorageIds order. Creates a DRAFT content item. Nothing is posted. Give `text` plus optional media (`videoUrl` / `imageUrl`, or `videoStorageId` / `imageStorageId` from upload_media, or `imageStorageIds` for 2-20 uploaded carousel images / `images` for 2-20 URLs), target `platf","read_only":false},{"name":"update_content","title":"Edit a draft","description":"[writes flayr data · `write` scope] `altText` edits image descriptions: a string for one image or an ordered array for carousel slides; refused after booking. Edits a draft in place; only the fields you pass change. Any media field replaces the draft's media as a set (keeps the id, so queue items still point at it). Refused (409) for archived or already-published items, and a media swap is refused","read_only":false},{"name":"archive_content","title":"Archive a draft","description":"[writes flayr data · `write` scope] Soft-archives an uncommitted draft or failed generation. Keeps its content and media; Restore is available in the Library Archive view. Repeating the call is safe. Refused (409) for ready, staged, scheduled or published content, or any posting queue, post or approval history. Needs write scope and the same owner/admin authority as Library archive. A brand-bound ","read_only":false},{"name":"delete_content","title":"Delete a content item","description":"[DESTRUCTIVE] DESTRUCTIVE: permanently deletes a content item from the library. Posts already live on a platform are not removed. Needs the `write` scope. Ask the user before calling.\n(Wraps DELETE /api/v2/content/{id}.)","read_only":false},{"name":"get_job_status","title":"Get a render/generation job status","description":"[read-only] Status of an async job (combine_clips, render_motion_ad, or an API video generation): pending, processing, completed or failed. For a combine or a motion ad, `resultContentId` is the new draft once completed; a failed combine is refunded automatically. Poll every 10-30 s — renders take about a minute.\n(Wraps GET /api/v2/generate/status/{jobId}.)","read_only":true},{"name":"publish","title":"Publish or schedule a post (goes live)","description":"[PUBLISHES to social accounts · `publish` scope] `altText` overrides image descriptions for this booking: one string per image (array for a carousel). PUBLISHES TO REAL SOCIAL ACCOUNTS. Posts now, or at `scheduledAt` (ISO-8601, future). Prefer `contentId` (a draft from create_content: its text and media become the post) over inline `content`. The post goes out through the target brand's own connec","read_only":false},{"name":"get_post","title":"Get a scheduled post's first comments","description":"[read-only] A post (`id` = convexPostId from publish, or posts[].id from get_content): status, slot, platforms, its internal labels and per-platform/account instanceLabels, and while it is scheduled the first comment each platform will publish and whether it can be changed now.\n(Wraps GET /api/v2/posts/{id}.)","read_only":true},{"name":"update_scheduled_post","title":"Edit a scheduled post (caption, first comments, platforms)","description":"[PUBLISHES to social accounts · `publish` scope] CHANGES WHAT A SCHEDULED POST WILL PUBLISH on real accounts, keeping its slot, accounts, options, labels and draft. `firstComment` sets per-platform first comments (linkedin, facebook, instagram, threads, youtube; null removes; X/Bluesky have none); `text` / `platformText` change the caption; `applyAutoFirstComment: true` adds the brand's auto first","read_only":false},{"name":"reschedule_post","title":"Move a scheduled post to a new time","description":"[PUBLISHES to social accounts · `publish` scope] MOVES A SCHEDULED POST to `scheduledAt` (ISO 8601 with a timezone, e.g. \"2026-11-19T15:00:00Z\"; more than 5 minutes ahead). The booking keeps its id, caption, media, accounts and options; its posting-queue slot follows. Returns { status: \"rescheduled\", scheduledAt }. Refused within 5 minutes of the current slot, while it is posting or posted, and in","read_only":false},{"name":"cancel_scheduled_post","title":"Cancel a scheduled post","description":"[PUBLISHES to social accounts · `publish` scope] Takes a SCHEDULED post off the platform schedule and marks it cancelled (the draft stays, so it can be published again). Safe to repeat. Refused within 5 minutes of the slot, and when the platform will not remove it (some YouTube uploads). Needs the `publish` scope (or admin) and the Pro plan or higher; each publish counts against the plan's direct ","read_only":false},{"name":"list_failed","title":"List the Failed tab","description":"[read-only] The Schedule → Failed backlog of the brand: one row per platform of a post that did not go out, with its row `id`, postId, contentId, account, slot, lastError, reasonClass and `coverage` (\"live\" / \"rebooked\" when the platform is now covered elsewhere, null when nothing known covers it). Filters: state (open = what the tab shows, the default), platform, zernioAccountId, reasonClass, slo","read_only":true},{"name":"approvals_list","title":"List everything waiting for your approval","description":"[read-only] The approvals inbox: everything that waits on the user's decision, in one list. `kind` \"ad_budget\" is an ad agent's request above the owner's ceiling (a spend cap, a spending limit, a campaign budget), with `amount`, `changes` and a one-line `summary` of before → after; it shows only with the `approvals:decide` scope, to an owner or admin, and never a request this same connection made.","read_only":true},{"name":"approvals_decide","title":"Approve or reject one inbox item","description":"[PUBLISHES to social accounts · `publish` scope] Decides ONE item from approvals_list (`id`): decision \"approve\" or \"reject\", optional `note`. ALWAYS show the user the item's `summary` (e.g. \"Monthly ad spend cap: $500.00 → $1,200.00\") and get a clear yes before approving. Ad budget requests (\"ad_budget\") need `approvals:decide`: approving a cap change applies it at once; approving any other reque","read_only":false},{"name":"get_analytics","title":"Analytics overview","description":"[read-only] Engagement overview for the last 7, 30 or 90 days. Pro plan or higher.\n(Wraps GET /api/v2/analytics.)","read_only":true},{"name":"query_insights","title":"Run a custom insight query","description":"[read-only] Read-only analytics query: one `metric` aggregated (median by default) over posts, broken down by up to a few dimensions (platform, weekday, hour, brand, campaign, postType, label:<key>, arm), at a fixed post age `window` (48h / 7d / 30d / lifetime) so posts are compared fairly. Every row carries its sample size n; platforms that do not report the metric are listed in `availability`, n","read_only":true},{"name":"list_plans","title":"List plans","description":"[read-only] The plans flayr sells today: price (USD monthly, USD per year annual), monthly Embers, seats, brands, connected accounts and features. `intervals` lists what start_checkout accepts for each plan; `checkout` says how it is bought.\n(Wraps GET /api/v2/billing/plans.)","read_only":true},{"name":"start_checkout","title":"Start a checkout","description":"[writes flayr data · `write` scope] Returns a checkout link for a plan from list_plans (`interval` monthly or annual, default monthly). A HUMAN opens it and pays: Stripe Checkout for individual plans, the organization set-up page for org plans, or the plan page when the account already has a card. This call never charges anything. Only call it when the user asks to upgrade.\n(Wraps POST /api/v2/bil","read_only":false},{"name":"subscription_status","title":"Subscription status","description":"[read-only] The current plan and Embers balance of the connected flayr account, with the link where the owner manages billing.\n(Wraps GET /api/v2/billing/subscription.)","read_only":true},{"name":"agent_signup","title":"Create a flayr account (agent)","description":"[writes flayr data · `write` scope] Creates a flayr account for an AI agent, no key or browser needed: sends a 6-digit code to `email` (an inbox you read, e.g. AgentMail). Calling it accepts the flayr Terms of Service and Privacy Policy for the account. Every agent account starts on the Free plan. If the address already has a flayr account, the same call is how an agent logs in: agent_signup_verif","read_only":false},{"name":"agent_signup_verify","title":"Verify agent sign-up","description":"[writes flayr data · `write` scope] Checks the emailed code and returns an API key (shown once). New address: the new account's first key (`account: \"new\"`). Address that already has a flayr account: a NEW key on that account, capped at read + write (`account: \"existing\"`); the owner is emailed and can revoke it, and accounts with SSO or with \"Allow agent login\" off refuse (403). Reconnect to this","read_only":false},{"name":"read_content","title":"Read content","description":"[read-only] Read content. mode=\"list\" returns one page of summaries (limit, cursor, fields); mode=\"get\" requires id and returns the full item. Use only the chosen mode's arguments. Full mode definitions: describe_tool {\"name\":\"list_content\"} or {\"name\":\"get_content\"}. Legacy names list_content and get_content remain callable.","read_only":true},{"name":"search_tools","title":"Search flayr tools","description":"[read-only] Finds flayr tools that are not in this list (ads, studio, campaigns, stores, …). Returns name, one-line purpose and toolset. Then call the tool by name, or load its toolset with enable_toolset to get its full schema.","read_only":true},{"name":"enable_toolset","title":"Load a toolset","description":"[read-only] Returns the full definitions (description and input schema) of every tool in one toolset, so you can call them. Call them by name, or through call_tool if your client only calls listed tools. To list a toolset on every connection, add ?toolsets=core,<name> to the MCP URL.","read_only":true},{"name":"call_tool","title":"Call a flayr tool by name","description":"Runs any flayr tool, listed or not, with the same scopes, plan checks and confirmations as calling it directly. The inner tool's own risk applies: confirm PUBLISHES or DESTRUCTIVE tools with the user first.","read_only":false},{"name":"describe_tool","title":"Describe a flayr tool","description":"[read-only] Returns one tool's full description and input schema. Some listed tools are shortened to save tokens: they end with \"Full description and schema: describe_tool\". Every argument in the full schema is accepted.","read_only":true}],"server_info":{"name":"flayr","version":"1.3.18","title":"flayr"},"category":"news","tags":["social","agents","analytics"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-29","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/social-flayr-flayr/"}