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`
`socioi_tiktok_creator_info`	TikTok nickname + allowed privacy levels — call before a direct TikTok post and let the user choose	`channelId`
`socioi_tiktok_analytics`	TikTok profile, stats, engagement (7/30/90 days), recent videos	`channelId`, `days?`

Create post shapes

Simple schedule:

JSON

{
  "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, YouTube title / description / audience, TikTok postMode / visibility) follow the same rules as the Public API. For a TikTok direct post, call socioi_tiktok_creator_info first and let the user choose the visibility — agents must not pick it. LinkedIn channels (authMode linkedin_profile or linkedin_page) accept text and/or image; video is not supported yet.

Limits & gating

Create post shares the Public API bucket: 100 / hour / organization (socioi_create_post + POST /public/v1/posts)
Read tools share 600 / minute / org with Public API GETs
Upload from URL shares 30 / minute / org with POST /media/upload-from-url
Expired free trials return TRIAL_EXPIRED until Billing is upgraded
Connect channels in the app before asking the agent to post

See Errors & rate limits.

Example agent flow

socioi_is_connected
socioi_list_channels → pick channel ids
socioi_upload_media_from_url (optional)
socioi_create_post with type: "schedule"