MCP tools reference

MCP tools reference

All 20 tools available through Model Context Protocol.

Posts

create_post

Draft and publish or schedule a new post. Accepts content (a brief description or full copy), content type (text or image), target channels, optional media, and optional scheduling.

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.

delete_post

Remove a post record. AgentReacher attempts remote deletion for platforms that support it and returns warnings for platforms that do not.

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 local image/video files as base64. Returns an assetId to use when creating or updating posts.

Social accounts

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 opens the secure credentials dialog in the chat UI.

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. Pass channelId when multiple Pinterest accounts are connected.

create_pinterest_board

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

Workspaces

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 the current MCP session. Returns workspace details and an API key.

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.

Team

invite_team_member

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

list_members

View all current members of the active workspace.

Feedback

submit_feedback

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

Each tool accepts structured parameters, but you do not need to know the exact format. Your AI assistant handles the mapping. Just describe what you want in plain language.

For setup instructions, see MCP overview.