Posts and media
schedule_post
Schedule a post. Schedules one post to one or more accounts, now or at publishAt, and returns it with a target per account. Get account ids from list_accounts first. Pass the same idempotencyKey when retrying, or the post may go out twice. list_platforms says which need media.
TL;DR
| Question | Answer |
|---|---|
| What does it do? | Schedules one post to one or more accounts, now or at publishAt, and returns it with a target per account. Get account ids from list_accounts first. Pass the same idempotencyKey when retrying, or the post may go out twice. list_platforms says which need media. |
| Does it change anything? | Changes something. |
| Which endpoint does it call? | POST /v1/posts |
| Which server? | https://mcp.flung.dev/mcp-oauth (sign in) or https://mcp.flung.dev/mcp (API key). |
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
content | string | yes | The text, within each platform's limit. at least 1 character; at most 10000 characters. |
accountIds | string[] | yes | The accounts to post to. |
mediaIds | string[] | no | Files from import_media, in order. |
publishAt | string | no | ISO 8601 with offset; omit for now. See suggest_posting_times. pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$. |
platformOverrides | object | no | Per platform: other text, a Pinterest board, or the TikTok audience. |
idempotencyKey | string | no | Any unique string; reuse it when retrying so the post is scheduled once. at least 1 character; at most 255 characters. |
Example call
json
{ "name": "schedule_post", "arguments": { "content": "We are live. #launch", "accountIds": [ "acct_aaaaaaaaaaaaaaaaaaaaaaaa" ], "publishAt": "2026-11-02T09:00:00+10:00" }}Things a person might say
- "Post "We are live" to LinkedIn and X tomorrow at 9am."
- "Schedule this announcement for Monday."
Annotations
| Hint | Value |
|---|---|
readOnlyHint | false |
destructiveHint | false |
idempotentHint | false |
openWorldHint | true |
See also
| Doc | Why |
|---|---|
| MCP tools | Every tool |
| Connect an AI agent | Install the server in your client |
POST /v1/posts | The same operation over HTTP |