social-media-posts6.66 KB
View saved version →
---
name: social-media-posts
description: >-
Draft, schedule, publish, edit and review social media posts through the user's Fuxux
account. Use when the user wants to post or schedule something on Instagram, Facebook,
TikTok, YouTube, LinkedIn, X (Twitter), Threads, Bluesky, Pinterest, Discord, Kick,
Twitch, Telegram or Slack, asks what is scheduled or published, wants to move or rewrite a scheduled post,
or asks why a post failed.
---
# Social media posts with Fuxux
Fuxux is a social media scheduler. The `fuxux` MCP server gives you nine tools that act on the signed-in user's Fuxux account. Use them instead of describing what the user should do in the web app.
## Tools
| Tool | Use it to |
|------|-----------|
| `whoami` | Confirm the connection works and see the user's plan |
| `list_connected_accounts` | See which social accounts can be posted to, with their `id`, `platform` and `status` |
| `get_dashboard` | Get a quick summary: counts, upcoming posts, accounts needing attention |
| `get_analytics` | Read post performance: likes, comments, views and reach per platform, and the top posts. Optional `days` (7, 14, 30 or 90). Needs a plan that includes analytics; if the plan doesn't, say so plainly |
| `list_posts` | Read the queue. Filters: `month` (`YYYY-MM`), `status` (`scheduled`, `published`, `draft`, `failed`, `all`), `limit` (1 to 50), `offset`, `order` (`upcoming`, `newest`, `recently_published`, `recently_updated`) |
| `get_post` | Read one post with its per-platform variants (you need the variant ids to edit captions) |
| `create_post` | Publish now, schedule (`scheduled_at`) or save a draft (`draft: true`) |
| `update_post` | Reschedule, change captions (`variant_updates`) or replace media on a draft or scheduled post |
| `delete_post` | Delete a draft or scheduled post so it never publishes |
## Before you create a post
1. Call `list_connected_accounts` once per conversation. Only write captions for platforms that appear there with `status: "connected"`. If an account is `expired`, tell the user to reconnect it in Fuxux under Connections; do not try to post to it.
2. Decide between draft, schedule and publish now:
- If the user asked you to write or prepare something, save it with `draft: true` and tell them it is waiting in Fuxux.
- If they gave a date or time, set `scheduled_at`.
- **`create_post` without `scheduled_at` or `draft` publishes immediately and publicly.** Only do that when the user clearly asked to post now. If you are not sure, show the captions and ask.
3. A post that is already published cannot be edited or recalled through Fuxux. Deleting it removes only Fuxux's record; it stays on the social platform.
## Writing captions
`captions` is a map of platform id to text, one caption per platform. Write each one for its platform rather than copying the same text everywhere.
| Platform | Id | Caption limit |
|----------|----|---------------|
| X (Twitter) | `twitter` | 280 |
| Instagram | `instagram` | 2200 |
| LinkedIn | `linkedin` | 3000 |
| Facebook | `facebook` | 63206 |
| TikTok | `tiktok` | 2200 |
| YouTube | `youtube` | 5000 |
| Bluesky | `bluesky` | 300 |
| Threads | `threads` | 500 |
| Pinterest | `pinterest` | 500 |
| Discord | `discord` | 2000 |
| Kick | `kick` | 140 |
| Twitch | `twitch` | 140 |
| Telegram | `telegram` | 4096 |
| Slack | `slack` | 4000 |
Platform rules that catch people out:
- **Instagram, TikTok, YouTube and Pinterest need media.** A text-only post to them fails. TikTok and YouTube need a video.
- **Kick and Twitch have no posts.** The first line of the caption becomes the channel's stream title. No media.
- **Telegram and Slack post to one channel each.** On Telegram, text under a photo or video is limited to 1024 characters; longer text is sent as its own message right after the media. On Slack, images show in the message and videos are added as links.
- **Reddit and Google Business Profile are not supported.** Say so plainly rather than retrying.
## Choosing accounts
Without `targets`, each captioned platform posts to the user's first connected account on that platform. When the user has more than one account on a platform, or names a specific one, pass `targets` with the `account_id` and `platform` from `list_connected_accounts`. Optional per target: `format` (`feed` or `story`, Instagram and Facebook only) and `board_id` (Pinterest).
## Media
`media_urls` takes up to four public `https` URLs to images or videos. The URLs must be reachable without a login. You cannot upload a file from the conversation; ask the user for a public link, or have them add the media to the draft in Fuxux.
## Scheduling
`scheduled_at` is an ISO 8601 datetime in the future. Users speak in their own local time: if you do not know their timezone, ask once, then convert and include the offset (for example `2026-05-20T09:00:00+02:00`). Repeat the final date and time back to the user after scheduling.
To move a scheduled post, call `update_post` with a new `scheduled_at`. To change wording, call `get_post` first to get each variant's id, then `update_post` with `variant_updates`.
## Reading results
When you publish now, `create_post` returns a `results` list with one entry per platform:
- `success: true` with a `platform_post_id` means it is live.
- `still_processing: true` means the platform accepted it and is still working. Do not retry and do not call it a failure. Check again with `get_post` after about a minute, once.
- `inbox_pending: true` means the platform put it in its own inbox (TikTok does this) and the user finishes posting in that platform's app.
- Otherwise `error` says why it failed. Tell the user the reason in plain words and what would fix it.
For "why did my post fail?", use `list_posts` with `status: "failed"` and read each variant's `error_message`.
## Limits
- If a tool says a plan limit was reached (for example the monthly post allowance), tell the user what the message says and stop. Do not suggest plans or upgrades; if they ask, plan details are at https://www.fuxux.com/pricing.
- If a tool says to wait a number of seconds, wait that long before trying again. Do not poll in a loop; post status changes over minutes, so checking once a minute is plenty.
- If a tool returns an authentication error, the user's access has expired or been removed. Ask them to connect Fuxux again.
## Safety
- Confirm before publishing immediately, before deleting, and before creating more than a few posts in one go.
- Never ask the user for a Fuxux password or API key. Connecting accounts and sign-in happen in the browser.
- New social accounts are connected by the user in Fuxux under Connections, not through these tools.
