flayr
Server Details
Create, schedule and publish social posts to 13 platforms for your brands.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 32 tools
Almost every tool maps to a distinct resource+action (publish vs create_content vs update_scheduled_post vs cancel_scheduled_post vs reschedule_post are clearly bounded by their descriptions). The main soft spots are the analytics pair (get_analytics overview vs query_insights flexible query) and a four-tool meta cluster (search_tools, describe_tool, enable_toolset, call_tool) whose boundaries are related rather than disjoint. These overlaps are explained well enough that misselection is unlikely but possible.
Overwhelmingly consistent snake_case verb_noun (create_content, archive_content, list_brands, cancel_scheduled_post, upload_media). Minor deviations: bare `publish`, the classic `whoami`, and `read_content` using a `read` verb with internal list/get modes where legacy `list_content`/`get_content` names once existed. Still highly predictable overall.
32 exposed tools is above the comfortable band and several are shortened stubs that require describe_tool round-trips to use. The domain is genuinely broad (content, publishing, brands, approvals, billing, media, analytics, agent signup), so most tools earn their place, but the surface feels heavy rather than tight. Toolset gating (search_tools/enable_toolset) mitigates but does not eliminate the load.
Core lifecycle is covered: create/update/archive/delete content, upload media, publish, reschedule/update/cancel scheduled posts, read posts and failed backlog, approvals, brands, plans/billing, analytics. Notable gaps: no way to list scheduled or published posts in bulk (only get_post by id), and no brand update/delete or account reconnect tool in this list. Those are referenced as existing elsewhere, so they are reachable via discovery rather than truly missing.
Available Tools
32 toolsaccount_trial_getGet the account trialARead-onlyIdempotentInspect
[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 includes posting, with no re-booking. terms are the configured trial terms.
(Wraps GET /api/v2/account/trial.)
Inputs: no named parameters.
agent_signupCreate a flayr account (agent)AInspect
[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_verify then returns a capped key on that account.
(Wraps POST /api/v2/agent-signup.)
Inputs: email (required), agentName (required), intendedUse (required), ownerEmail.
agent_signup_verifyVerify agent sign-upAInspect
[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 account holder and every organization owner/admin get email and in-app notices plus a dashboard banner and can revoke it, and accounts with SSO or with "Allow agent login" off refuse (403). Reconnect to this MCP server with Authorization: Bearer <apiKey>.
(Wraps POST /api/v2/agent-signup/verify.)
Inputs: code (required), email (required).
approvals_decideApprove or reject one inbox itemADestructiveInspect
[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 request lets the agent repeat its exact call once within 7 days. If the workspace requires money approvals to be restated, the answer is 409 confirmation_required: repeat with confirmAmountMinor equal to amountMinor (null for "remove the limit"), only after the user confirmed that amount. Held content works as in decide_approval (approve or approvals:decide; a workflow approval may resume a run that publishes). Repeating the same decision is safe (alreadyDecided: true). Every decision is audited with who, when and that it came through MCP.
(Wraps POST /api/v2/approvals/{id}.)
Inputs: id (required), decision (required), note, confirmAmountMinor.
approvals_listList everything waiting for your approvalARead-onlyIdempotentInspect
[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. kind "manual" or "workflow" is held content (needs approve or approvals:decide, Agency plan). Read summary to the user before deciding anything.
(Wraps GET /api/v2/approvals.)
Inputs: status, brandId.
archive_contentArchive a draftAInspect
[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 connection only reaches its own brand.
(Wraps POST /api/v2/content/{id}/archive.)
Inputs: id (required).
brand_profile_getGet a brand profileARead-onlyIdempotentInspect
[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.
(Wraps GET /api/v2/brand/intelligence.)
Inputs: brandId.
call_toolCall a flayr tool by nameADestructiveInspect
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.
Inputs: name (required), arguments.
cancel_scheduled_postCancel a scheduled postADestructiveIdempotentInspect
[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 posts for the month. Confirm with the user first.
(Wraps DELETE /api/v2/posts/{id}.)
Inputs: id (required).
create_brandCreate a brandAInspect
[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 call is a 402 and nothing is created (relay the message). Optional profile, voice, colors and fonts (the brand_profile_update shapes) and logoStorageId (an image from upload_media) are saved in the same call. Full description and schema: describe_tool {"name":"create_brand"}.
(Wraps POST /api/v2/brands.)
Inputs: name (required), fonts, orgId, voice, +4 more.
create_contentCreate a draftAInspect
[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 platforms, brandId (from list_brands; omitted → the brand last active in the dashboard; required once the account is in more than one organization), per-platform captions (platformText), creator credits, labels and YouTube options. More optional arguments, not listed: instanceLabels, youtube, library, sourceLabel, contentType, copyFromContentId, referralFooter, credits. Full description and schema: describe_tool {"name":"create_content"}.
(Wraps POST /api/v2/content.)
Inputs: text, images, labels, altText, +8 more.
delete_contentDelete a content itemADestructiveIdempotentInspect
[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.
(Wraps DELETE /api/v2/content/{id}.)
Inputs: id (required).
describe_toolDescribe a flayr toolARead-onlyIdempotentInspect
[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.
Inputs: name (required).
enable_toolsetLoad a toolsetARead-onlyIdempotentInspect
[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, to the MCP URL.
Inputs: name (required).
get_analyticsAnalytics overviewBRead-onlyIdempotentInspect
[read-only] Engagement overview for the last 7, 30 or 90 days. Pro plan or higher. (Wraps GET /api/v2/analytics.)
Inputs: range, groupBy, labelKey, experimentId.
get_job_statusGet a render/generation job statusARead-onlyIdempotentInspect
[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.
(Wraps GET /api/v2/generate/status/{jobId}.)
Inputs: jobId (required).
get_postGet a scheduled post's first commentsARead-onlyIdempotentInspect
[read-only] A post (id = convexPostId from publish, or posts[].id from get_content): status, slot, platforms, its full caption text (never cut), its name displayTitle, its contentId, 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.
(Wraps GET /api/v2/posts/{id}.)
Inputs: id (required).
list_brandsList brandsARead-onlyIdempotentInspect
[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, adsConnected): set a missing website with brand_profile_update; add a brand with create_brand (account-wide connections only); a brand API key is created by the owner in Settings, never by an agent.
(Wraps GET /api/v2/brands.)
Inputs: limit, cursor, fields.
list_connected_accountsList connected social accountsARead-onlyIdempotentInspect
[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 pick platforms; for an account that is not healthy, account_reconnect returns the link the user opens to reconnect it.
(Wraps GET /api/v2/accounts.)
Inputs: limit, cursor, fields, brandId.
list_failedList the Failed tabARead-onlyIdempotentInspect
[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, slotAfter / slotBefore. Follow cursor until it is null; a page can be short. Full description and schema: describe_tool {"name":"list_failed"}.
(Wraps GET /api/v2/failed.)
Inputs: limit, state, cursor, fields, +6 more.
list_plansList plansARead-onlyIdempotentInspect
[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.
(Wraps GET /api/v2/billing/plans.)
Inputs: no named parameters.
publishPublish or schedule a post (goes live)ADestructiveInspect
[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 connected accounts. Always pass an idempotencyKey so a retry never double-posts. More optional arguments, not listed: followUpComments, instanceLabels, youtube, poll, firstComment, images, instagram, pinterest, onBooked, labels, facebook, reshare, memo, mediaCampaignId, requiresApproval, strictMedia, allowDuplicateBooking, autoFirstComment, onPublishTasks, aiGenerated. Full description and schema: describe_tool {"name":"publish"}.
(Wraps POST /api/v2/publish.)
Inputs: platforms (required), parody, altText, brandId, +8 more.
query_insightsRun a custom insight queryARead-onlyIdempotentInspect
[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:, 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, never counted as 0. Pro plan or higher. Full description and schema: describe_tool {"name":"query_insights"}.
(Wraps POST /api/v2/insights/query.)
Inputs: dateTo, format, metric, window, +8 more.
read_contentRead contentARead-onlyIdempotentInspect
[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.
Inputs: mode (required), id, limit, cursor, +3 more.
reschedule_postMove a scheduled post to a new timeADestructiveIdempotentInspect
[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 a brand whose scheduled posts require review. Needs the publish scope (or admin) and the Pro plan or higher; each publish counts against the plan's direct posts for the month. Confirm the new time (and its timezone) with the user first.
(Wraps PATCH /api/v2/posts/{id}.)
Inputs: id (required), scheduledAt (required).
search_toolsSearch flayr toolsARead-onlyIdempotentInspect
[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.
Inputs: limit, query, toolset.
start_checkoutStart a checkoutAInspect
[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.
(Wraps POST /api/v2/billing/checkout.)
Inputs: plan (required), interval.
subscription_statusSubscription statusARead-onlyIdempotentInspect
[read-only] The current plan and Embers balance of the connected flayr account, with the link where the owner manages billing. (Wraps GET /api/v2/billing/subscription.)
Inputs: no named parameters.
update_contentEdit a draftAIdempotentInspect
[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 once a queue booked it. labels, opus, videoWatermarked, library and aiGenerated may be changed on published items too. aiGenerated is the post's AI label: false for real footage, null back to automatic. More optional arguments, not listed: credits, youtube, youtubeAbTestResult, imageContentIds, videoUrl, imageUrl, platforms, text, videoStorageId, imageStorageId, platformText, opus, images, labels. Full description and schema: describe_tool {"name":"update_content"}.
(Wraps PATCH /api/v2/content/{id}.)
Inputs: id (required), title, altText, library, +6 more.
update_scheduled_postEdit a scheduled post (caption, first comments, platforms)ADestructiveIdempotentInspect
[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 comment where none is set; removePlatforms drops platforms from this booking (e.g. a duplicate TikTok); labels replaces the post's own labels (e.g. ["repost:evergreen"]; alone it never touches the booking, status "labeled"). More optional arguments, not listed: instanceLabels. Full description and schema: describe_tool {"name":"update_scheduled_post"}.
(Wraps PATCH /api/v2/posts/{id}.)
Inputs: id (required), text, dryRun, labels, +7 more.
upload_mediaGet a media upload URLAInspect
[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, or collect 2-20 ids into imageStorageIds for a carousel on create_content or update_content. get_uploaded_media returns the public URL without a draft. For music-library audio, pass storageId to music_tracks_create instead. For media already on the web, skip this and pass videoUrl / imageUrl instead. Returns 413 when the account's storage is full.
(Wraps POST /api/v2/media/upload-url.)
Inputs: no named parameters.
whoamiCheck this connectionARead-onlyIdempotentInspect
[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. (Wraps GET /api/v2/ping.)
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Draft, schedule and publish social posts in your own voice across 11 platforms.
Schedule, publish and manage social media posts across platforms.
Schedule and publish social media posts to Facebook, X, LinkedIn, Instagram, Threads and more.
Draft, schedule and publish social posts, upload media and list posts across 15 platforms.
Related MCP Servers
AlicenseBqualityBmaintenanceSchedule, publish, and measure social posts on Facebook, Instagram, TikTok, LinkedIn, Threads, Pinterest, and X for one brand or many.38MIT- AlicenseNot gradedqualityDmaintenanceEnables posting and managing content across 13+ social media platforms with scheduling, analytics, AI generation, and approval workflows through natural language.2MIT
- AlicenseAqualityDmaintenanceAI-powered social media posting across 14 platforms. Post to Twitter, Instagram, TikTok, Facebook, LinkedIn, YouTube and more with one command. AI adapts content per platform, schedules posts, and generates 30-day content calendars.6MIT
- AlicenseBqualityBmaintenanceEnables scheduling and publishing social posts across 18 platforms from MCP clients, with media uploads, analytics, comment replies, and Google Business review management.731,614 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.