MCP Tools
MCP Tools
The MCP server exposes seven tools. All operate on the account tied to your API key.
schedule_post
Schedule a post to one or more connected platforms. Leave scheduled_at empty to publish immediately.
| Parameter | Type | Required | Notes |
|---|---|---|---|
content |
string | yes | Post text, ≤ 10,000 characters. |
platforms |
string[] | yes | One or more of x, linkedin, linkedin_page, facebook, instagram, pinterest, youtube, tiktok. |
scheduled_at |
string | no | ISO 8601. Omit to publish now. |
media_ids |
integer[] | no | Media library ids to attach. |
Returns the new post_id, status, platforms, and scheduled_at.
get_accounts
List all connected social accounts and their status. No parameters. Returns each account's id, platform, account_name, username, and is_active.
list_scheduled
List upcoming scheduled posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
limit |
integer | no | Default 10, max 50. |
cancel_post
Cancel a scheduled post before it publishes. Only posts in the scheduled state can be cancelled.
| Parameter | Type | Required | Notes |
|---|---|---|---|
post_id |
integer | yes | Id of the scheduled post. |
get_stats
Return posting statistics: total, published, scheduled, draft, and failed post counts, plus media and connected-account totals. No parameters.
browse_media
Search and browse the media library. Returns media items with ids you can attach to schedule_post.
| Parameter | Type | Required | Notes |
|---|---|---|---|
search |
string | no | Match filename. |
type |
string | no | image or video. |
folder |
string | no | Filter by folder. |
limit |
integer | no | Default 10, max 50. |
upload_media
Upload a media file by downloading it from a public URL. Returns a media_id to attach to posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
url |
string | yes | Public URL of the image or video. |
filename |
string | yes | Original filename with extension, e.g. launch.png. |
folder |
string | no | Folder to organize the media. |
tags |
string[] | no | Optional tags. |