Use flayr in Claude and ChatGPT

Claude (claude.ai and Claude Desktop)

From the Claude connectors directory:

1. In Claude, open Settings, then Connectors.
2. Find flayr in the directory and choose Connect.
3. Sign in to flayr and finish the steps below.

Or add flayr as a custom connector:

1. In Claude, open Settings, then Connectors, and choose Add custom connector.
2. Name it flayr and use the URL https://flayr.social/api/mcp/claude.
3. Add it, choose Connect, and sign in to flayr.

ChatGPT

1. In ChatGPT, open Settings, then Apps & Connectors.
2. Find flayr and choose Connect.
3. Sign in to flayr and finish the steps below.

Where ChatGPT lets you add an app by URL (developer mode), use https://flayr.social/api/mcp/chatgpt with OAuth sign-in.

Claude Code

Add the server, then run /mcp in Claude Code and choose Authenticate to sign in:

claude mcp add --transport http flayr https://flayr.social/api/mcp

Other MCP clients

Add https://flayr.social/api/mcp as a remote MCP server (Streamable HTTP). Clients that support MCP sign-in (OAuth) take you through the flayr sign-in below. Clients that don't can send a flayr API key instead, as the header Authorization: Bearer flayr_sk_…. Create keys in Developers.

In Claude and ChatGPT

• Check this connectionReadwhoami

  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).

• List brandsReadlist_brands

  Lists the brands this connection can file content into and publish through.

• List connected social accountsReadlist_connected_accounts

  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) and whether flayr can post there right now (`postable`; Reddit is paused because Reddit closed its API to third-party apps).

• List YouTube playlistsReadlist_youtube_playlists

  Playlists of the YouTube channel(s) a brand publishes to.

• Get a media upload URLWriteupload_media

  Step 1 of attaching a LOCAL file (video or image) to a draft.

• List contentReadlist_content

  Lists content items (drafts), newest first.

• Get a content item and its post statusReadget_content

  One content item plus its live posting status: `postState` and `posts[]` (up to 20, newest first) with each post's status (scheduled · publishing · published · partial · failed · review_held · held), scheduledAt, and per-platform status, live URL and error.

• Create a draftWritecreate_content

  Creates a DRAFT content item.

• Edit a draftWriteupdate_content

  Edits a draft in place; only the fields you pass change.

• Delete a content itemDeletedelete_content

  DESTRUCTIVE: permanently deletes a content item from the library.

• Publish or schedule a post (goes live)Publishpublish

  PUBLISHES TO REAL SOCIAL ACCOUNTS.

• Get a scheduled post's first commentsReadget_post

  A post (`id` = convexPostId from publish, or posts[].id from get_content): status, slot, platforms, and while it is scheduled the first comment each platform will publish and whether it can be changed now.

• Edit a scheduled post (caption, first comments, platforms)Publishupdate_scheduled_post

  CHANGES WHAT A SCHEDULED POST WILL PUBLISH on real accounts, keeping its slot, accounts, options, labels and draft.

• Cancel a scheduled postPublishcancel_scheduled_post

  Takes a SCHEDULED post off the platform schedule and marks it cancelled (the draft stays, so it can be published again).

• List scheduled-post reviewsReadlist_reviews

  Scheduled posts waiting for (or given) a human sign-off, oldest slot first.

• List content waiting for your approvalReadlist_approvals

  Content held for approval that waits on the account owner's decision, newest first: posts filed with publish `requiresApproval: true`, drafts submitted for review, and workflow runs parked at an approval gate.

• List posting queuesReadlist_queues

  Posting (drip) queues of one brand.

• Get a posting queueReadget_queue

  A queue and its items in order, with each item's state (queued · publishing · scheduled · posted · failed · skipped), booked or projected slot, and attribution status.

• Create a posting queuePublishcreate_queue

  Creates a posting queue.

• Update, pause or resume a queuePublishupdate_queue

  `status: "paused"` stops new bookings (already-booked posts stay booked); "active" resumes.

• Delete a posting queueDeletedelete_queue

  DESTRUCTIVE: deletes the queue (its drafts stay in the library).

• Add drafts to a queuePublishadd_queue_items

  Appends drafts (content ids) to the end of a queue — they will be BOOKED AND POSTED on the queue's schedule.

• Skip, retry, unschedule, retitle or move a queue itemPublishqueue_item_action

  `action`: "skip" passes over a queued item; "retry" puts a failed/skipped item back in line; "unschedule" deletes a booked platform post and puts the item back in line.

• Remove an item from a queueDeleteremove_queue_item

  DESTRUCTIVE: removes an item (the draft stays in the library).

• Reorder waiting queue itemsPublishreorder_queue_items

  Send every waiting (queued) item id exactly once, in the new order.

• Analytics overviewReadget_analytics

  Engagement overview for the last 7, 30 or 90 days.

• Run a custom insight queryReadquery_insights

  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.

• Compare posts by a label (A/B)Readcompare_labels

  Splits every labelled post by the values of one label key (e.g.

• List experimentsReadlist_experiments

  A/B experiments.

• Get an experimentReadget_experiment

  One experiment: hypothesis, variants, compareKey, window and status.

• Create an experimentWritecreate_experiment

  Creates an A/B experiment.

• Update an experimentWriteupdate_experiment

  Changes an experiment's fields (e.g.

• Delete an experimentDeletedelete_experiment

  DESTRUCTIVE: deletes the experiment record (content keeps its labels).

• Experiment resultsReadget_experiment_results

  The experiment's posts split by its compareKey, with the leading variant by its primary metric and n per arm.

• List formats (text templates)Readlist_text_templates

  Reusable text shapes per brand: sections, length targets, hook patterns, CTA slots and guardrails.

• Get a formatReadget_text_template

  One format (text template) with its full structure and example.

• Create a formatWritecreate_text_template

  Creates a reusable format (text template) in a brand.

• Update a formatWriteupdate_text_template

  Changes a format; only the fields you pass change.

• Delete a formatDeletedelete_text_template

  DESTRUCTIVE: deletes a format (drafts started from it keep their text).

• List creator-credit rulesReadlist_attribution_rules

  The brand's "posts like this must carry a credit" rules and its mode (flag / push_down).

• List share rulesReadlist_share_rules

  The brand's share rules: "when <account> publishes, reshare to <accounts> (or comment on it) after N minutes with text T", each with its approval mode.

• Create a share rulePublishcreate_share_rule

  Creates a rule that reshares (or comments on) every new post of the source accounts.

• List comments after publish and resharesReadlist_publish_actions

  Pending, sent and failed comments-after-publish and reshares of the brand (filter by `status`, e.g.

• Approve, reject, retry or cancel a reshare / commentPublishact_on_publish_action

  approve lets a rule's reshare / comment go out at its time; retry re-sends a failed one (same idempotency key); reject / cancel stop it.

• Add comments after publish to a postPublishadd_post_comments

  Schedules comments on a post, sent once after it is live on that platform and its tokens resolve ({{postUrl}}, {{parentPostUrl:<post id>}}, {{youtubeUrl:<post id>}}), optionally at sendAt.

• List a post's comments after publishReadlist_post_comments

  A post's comments-after-publish and reshares, with status (waiting, needs_approval, sent, failed) and the resolved text.

• List framesReadlist_frames

  The brand's frames (borders, overlays, lower thirds, corner tags, quote-card frames, ribbons) plus the built-in flayr frames in the brand colors.

• Get a frameReadget_frame

  One library frame with its sizes and content areas.

• Add a frame to the libraryWritecreate_frame

  Copy a flayr frame into the brand library (`defaultKey`, optional colors/texts), or add uploaded PNG/SVG art (upload_media first; `variants` of storageIds, the content area is detected from transparency).

• Frame an imageWriteapply_frame

  Draws a frame over an image and returns a new image URL (the original is untouched).

• Get auto-frame settingsReadget_frame_settings

  Which frame each platform's images get automatically when a post is published or scheduled.

• Set auto-frame for a platformWriteupdate_frame_settings

  Frame every image posted to a platform automatically (frameRef), or stop (frameRef null).

A social account needs reconnecting

If the assistant says an account needs reauthorization or is disconnected, reconnect it in flayr under Connect, then ask again. You don't need to reconnect the assistant.

Posting to Reddit

Paused: Reddit is temporarily unavailable, so flayr cannot post there.

“This plan doesn’t include using flayr from AI agents”

The connection works, but your flayr plan is below the one these tools need (see Plan). Once the plan includes it, the same connection works; there's no need to reconnect.

The assistant can't see a brand or can't publish

The connection only reaches the brand and permissions you picked. Disconnect it and connect again to pick differently.