MCP tools

Tool names, arguments, and what each Socioi MCP tool does.

All tools act on the authorized workspace (same org as the API key or OAuth grant).

Tool	Description	Key args
`socioi_is_connected`	Validate credentials; returns `organizationId` / `userId`	—
`socioi_list_channels`	Connected social accounts	—
`socioi_channel_quota`	Plan channel limit vs used	—
`socioi_list_posts`	List posts	Optional `status`: `DRAFT` \| `SCHEDULED` \| `PUBLISHED` \| `FAILED`
`socioi_get_post`	Fetch one post	`id`
`socioi_create_post`	Draft, schedule, or publish now	`type`, `content`, `date`, `channelIds`, `mediaIds`, `posts[]`
`socioi_schedule_post`	Set schedule on an existing post	`id`, `scheduledAt` (ISO)
`socioi_delete_post`	Delete a post	`id`
`socioi_list_media`	Media library	—
`socioi_upload_media_from_url`	Import remote image/video into library	`url`

Create post shapes

Simple schedule:

{
  "type": "schedule",
  "date": "2026-09-20T10:00:00.000Z",
  "content": "Hello from MCP",
  "channelIds": ["CHANNEL_ID"]
}

type may be draft, schedule, or now. Provider-specific settings (e.g. Pinterest board) follow the same rules as the Public API.

MCP write tools share an org-level limit of about 100 writes / hour across create / schedule / delete / upload (separate from Public API media HTTP limits)
Expired free trials return TRIAL_EXPIRED until Billing is upgraded
Connect channels in the app before asking the agent to post