AI agents
Rules file for your agent
A block to paste into CLAUDE.md, AGENTS.md or an editor's rules file, so an agent uses Flung the right way. It is the guidance the MCP server sends when a client connects.
TL;DR
| Question | Answer |
|---|---|
| What do I paste? | The block below, as it is. |
| Where does it go? | In the rules file your agent reads; the table below names it for each client. |
| Does it need the MCP server? | It names the tools, so connect them first: Connect an AI agent. |
The block
Markdown
## Social media with Flung
Flung connects social media accounts and publishes posts to them. Use its MCP tools (or its API) for every post; never post to a platform directly.
- Flung connects social media accounts and schedules posts to them.- To keep accounts working, start with find_accounts_needing_attention. Accounts with renewal "automatic" renew themselves; the others need a person before reconnectBy.- Connecting or reconnecting needs a person: call connect_account or reconnect_account, give the person the authorizationUrl, then poll get_connect_session until it is not pending. The link expires in ten minutes.- To post, call list_accounts for ids, then schedule_post with an idempotencyKey you reuse on retry, then get_post for the outcome.- A refused call is an answer, not a fault: its text says what to do next.- Never put a Flung API key in browser code or a commit; pages use a connect token from their server.
Tools: find_accounts_needing_attention, list_accounts, get_account, connect_account, reconnect_account, get_connect_session, refresh_account, disconnect_account, schedule_post, update_post, cancel_post, retry_post, import_media, get_post, list_posts, list_inbox, reply_to_inbox_item, get_post_metrics, get_experience, list_platforms, suggest_posting_times, get_posting_options, list_templates, deploy_template, list_variables, set_variable, list_feeds, follow_feed.Docs for agents: https://docs.flung.dev/llms.txtWhere to put it
| Client | File |
|---|---|
| Claude Code | CLAUDE.md in the project, or ~/.claude/CLAUDE.md for every project |
| Codex and most other coding agents | AGENTS.md in the project |
| Cursor | A rule in .cursor/rules/, such as .cursor/rules/flung.mdc |
| GitHub Copilot | .github/copilot-instructions.md |
| Gemini CLI | GEMINI.md in the project |