Connect your AI agent
Give Claude, ChatGPT, Cursor or another AI agent its own flayr API key, so it can draft, schedule and report on your posts over MCP. Connect it with Read + Write and keep Post review on, so nothing posts without your approval.
Connect your AI agent to flayr. Watch on YouTube
One key per agent, with the recommended scope: Read + Write, no Publish.
- 1
- 2
Name the key after the agent
For example "Claude Code". With one key per agent, you can revoke one without breaking the others.
- 3
Pick Read + Write, leave Publish off
This is the recommended scope, and the default. The agent drafts posts, media and campaigns. Nothing goes live until you schedule or publish it in flayr.
- 4
Create the key and copy it
Choose Create key and use the copy button. flayr shows the full key once. Store it like a password.
- 5
Check the key
Run this in a terminal, with your new key in place of flayr_sk_YOUR_KEY.
Check the key
curl -s https://flayr.social/api/v2/ping -H "Authorization: Bearer flayr_sk_YOUR_KEY"
A working key answers
{"ok":true,"authenticated":true,"userId":"<your user id>","tier":"<your plan>","brandId":null,"brandName":null,"ts":<time>}
Read the full guide
Create a key for the agent, keep approval on, connect it and check that it works. About five minutes.
Two settings keep you in control of what goes live.
- 1
Keep Publish off the key
A key without the Publish scope can never post. The agent can only prepare drafts.
- 2
Set Post review to Required
Open Brand Intelligence, then Post review, and choose Required. Scheduled posts then wait for your review, including posts scheduled by an agent whose key has the Publish scope.
The agent works through tools. The scopes on its key decide which ones it may use.
- 1
- 2
- 3
Publish
Publish tools act on your real accounts and need a key with the Publish scope. A key without it can never post.
- 4
See every tool
The full list, grouped by Read, Write and Publish, is in the agent reference.
Give the agent the MCP server URL and its key.
- 1
Claude Code
Run this in a terminal with your key in place of flayr_sk_YOUR_KEY, then run /mcp to see flayr listed.
Claude Code command
claude mcp add --transport http flayr https://flayr.social/api/mcp --header "Authorization: Bearer flayr_sk_YOUR_KEY"
- 2
Any other agent
Claude Desktop, Claude.ai, Cursor and other MCP clients are in Connect over MCP. Scripts and automation tools are in Use the API.
One question tells you the agent is connected to the right brand.
- 1
Ask your agent
Ask the question below. A working setup calls the whoami tool and answers with your brand (or "all your brands" for an account-wide key) and your plan.
Ask your agent
What brand am I connected to in flayr?
Related
Videos
Written guide
- 1Open Developers, then API Keys
Choose Developers in the sidebar and find API Keys.
- 2Name the key after the agent
For example "Claude Code". With one key per agent, you can revoke one without breaking the others.
- 3Pick Read + Write, leave Publish off
This is the recommended scope, and the default. The agent drafts posts, media and campaigns. Nothing goes live until you schedule or publish it in flayr.
- 4Create the key and copy it
Choose Create key and use the copy button. flayr shows the full key once. Store it like a password.
- 5Check the key
Run this in a terminal, with your new key in place of flayr_sk_YOUR_KEY.
Official recording
One walkthrough from the flayr team per section, the first card in every row. Until it is recorded, the written steps still work.
Community perspectives
How members really use it, with their own steps. Approved videos earn 100 Embers.
Submit a video