Post for Me

List the social accounts connected to your Post for Me workspace. Optionally filter by platform (instagram, tiktok, x, ...). Returns account ids you pass to create_post via social_accounts.

{
  "tool": "list_social_accounts",
  "arguments": {
    "platform": "instagram",
    "username": "…",
    "id": []
  }
}

Get a single connected social account by id, including platform, username and status.

{
  "tool": "get_social_account",
  "arguments": {
    "id": "…"
  }
}

Manually create/connect a social account by supplying its platform and credentials/tokens. For the standard interactive OAuth flow, prefer create_auth_url instead.

{
  "tool": "create_social_account",
  "arguments": {
    "platform": "instagram"
  }
}

Update a connected social account (e.g. refresh stored credentials or metadata).

{
  "tool": "update_social_account",
  "arguments": {
    "id": "…"
  }
}

Start the OAuth connect flow for a platform. Returns a URL — open it in a browser to authorize the account; once approved, it appears in list_social_accounts. Use this to connect a new Instagram/TikTok/X/etc.

{
  "tool": "create_auth_url",
  "arguments": {
    "platform": "instagram"
  }
}

Disconnect a social account — revokes Post for Me's access. The account stops being usable for posting until reconnected via create_auth_url.

{
  "tool": "disconnect_social_account",
  "arguments": {
    "id": "…"
  }
}

ANALYTICS: list the recent feed for a connected account — the posts on that platform, optionally with engagement metrics (likes, comments, views, etc.). Use this to pull performance data for a given account.

{
  "tool": "list_account_feeds",
  "arguments": {
    "social_account_id": "…"
  }
}

Create a social post across one or more connected accounts/platforms. This is the primary publishing tool. Set scheduled_at (ISO-8601) to schedule, status='draft' to save without publishing, or omit both to publish immediately. Use platform_configurations for per-network tweaks. For common cases the shortcuts publish_now / schedule_post / create_draft are simpler.

{
  "tool": "create_post",
  "arguments": {
    "social_accounts": []
  }
}

Shortcut: publish a post immediately to the given accounts. Equivalent to create_post with no scheduled_at and status='published'.

{
  "tool": "publish_now",
  "arguments": {
    "social_accounts": []
  }
}

Shortcut: schedule a post for a future time. Equivalent to create_post with scheduled_at set and status='scheduled'.

{
  "tool": "schedule_post",
  "arguments": {
    "social_accounts": [],
    "scheduled_at": "…"
  }
}

Shortcut: save a post as a draft without publishing or scheduling it. Equivalent to create_post with status='draft'.

{
  "tool": "create_draft",
  "arguments": {
    "social_accounts": []
  }
}

Get a single social post by id, including its status, caption, media and target accounts.

{
  "tool": "get_post",
  "arguments": {
    "id": "…"
  }
}

List social posts, optionally filtered by status (draft/scheduled/published/error) and paginated. Use this to review queued, scheduled or published content.

{
  "tool": "list_posts",
  "arguments": {
    "status": "draft",
    "external_id": "…",
    "limit": 0
  }
}

Update an existing post by id — change the caption, media, target accounts, schedule or platform_configurations. Works on drafts and scheduled posts.

{
  "tool": "update_post",
  "arguments": {
    "id": "…"
  }
}

Shortcut: move a scheduled post to a new time. Equivalent to update_post with only scheduled_at set.

{
  "tool": "reschedule_post",
  "arguments": {
    "id": "…",
    "scheduled_at": "…"
  }
}

Delete a social post by id (drafts, scheduled or published records).

{
  "tool": "delete_post",
  "arguments": {
    "id": "…"
  }
}

ANALYTICS: list publishing results across posts — each row is the outcome of one post on one platform (success/error, native post id & URL). Filter by social_post_id to see how a specific post fared on every target account.

{
  "tool": "list_post_results",
  "arguments": {
    "social_post_id": "…",
    "limit": 0,
    "offset": 0
  }
}

Get a single post result by id — the detailed outcome of one post on one platform, including the native post URL/id and any error message.

{
  "tool": "get_post_result",
  "arguments": {
    "id": "…"
  }
}

Generate a preview of how a post would appear on each target platform, without publishing it. Pass the same caption/media/social_accounts/platform_configurations you'd send to create_post. Great for a confirm-before-publish step.

{
  "tool": "create_post_preview",
  "arguments": {
    "caption": "…",
    "social_accounts": [],
    "media": []
  }
}

Get a signed URL to upload a media file. Returns an upload_url (PUT your bytes there) and the media URL to reference in a post. Prefer upload_media if you want the upload done for you in one step.

{
  "tool": "create_media_upload_url",
  "arguments": {
    "content_type": "…",
    "file_name": "…"
  }
}