MCP tools reference

create_post

Create a post draft for one or more connected targets after the user has chosen the exact caption text. Supports shared content, media, target selection, scheduling options, and per-platform overrides.

list_posts

View recent posts including drafts, scheduled, in-flight, and published. Supports an optional limit.

get_post

Inspect a single post and its delivery status across all targets. Returns detailed information including per-target publish status.

update_post

Edit an existing post's content, media, channel overrides, targets, or schedule. Published targets are edited live where the platform supports it; Pinterest board selection is locked after creation.

delete_post

Delete a post from AgentReacher. This removes the post record regardless of status, but does not remove already-published content from the social platform itself.

schedule_post

Set or change when a post publishes. Supports a single scheduled time or per-target schedules (e.g. Instagram at 9am, LinkedIn at noon).

publish_post_now

Publish a post immediately across its current targets.

upload_media

Import remote image/video URLs or upload tiny local files as base64. Returns an assetId to use when creating or updating posts.

create_upload_url

Create a direct upload URL for larger local image or video files without placing bytes in MCP tool arguments. Upload the file to the returned URL, then use the returned assetId in a post.

add_replies_to_post

Attach an ordered text-only reply chain to an existing post. Replies inherit the parent post's targets and schedule, and unsupported platforms skip the chain.

list_connected_social_accounts

List all connected social media accounts for the active workspace. Returns account details for each connected platform.

connect_social_account

Start a social account connection flow. OAuth platforms return an authorization URL; Bluesky returns a secure AgentReacher setup URL for entering the handle and app password outside the chat.

disconnect_social_account

Disconnect a social account from the active workspace. Pass channelId from list_connected_social_accounts when multiple accounts exist for the same provider.

list_pinterest_boards

List boards for a connected Pinterest account. Use the returned board id in Pinterest post overrides when a specific board is needed.

create_pinterest_board

Create a Pinterest board on the connected account and use the returned board id for Pinterest posts.

list_workspaces

List all workspaces available to your account, including IDs, names, slugs, and your role in each.

create_workspace

Create a new workspace and make it the active workspace for later MCP tool calls.

switch_workspace

Switch the MCP session to a different workspace. All subsequent tool calls will operate on the new workspace.

delete_workspace

Delete a workspace, defaulting to the active workspace. Blocked if it is your only workspace. Automatically switches to another workspace after deletion.

invite_team_member

Invite someone to the active workspace by email. The invitee receives an email with a link to join.

list_members

View current members and pending invitations for the active workspace.

submit_feedback

Send product feedback directly to the AgentReacher team. Supports categories: bug, idea, ux, onboarding, and other.