Developers
Limits and errors
What the MCP server allows, and what the errors mean.
Plan access
MCP access is part of your Feedlio plan. If your plan doesn't include it, tools return an error saying so; upgrade on the pricing page. Everything else follows your plan too: number of workspaces, posts per day and AI credits.
The same rules as the dashboard
Posts created through MCP pass the same checks as posts made by hand:
- Character limits for each platform.
- Media rules for each platform and post type (for example Instagram's 4:5 to 1.91:1 shape, or Pinterest needing an image or video).
- TikTok requires you to choose a privacy level each time (
get_tiktok_creator_info). - Pinterest pins need a board (
list_pinterest_boards).
When a check fails, the tool returns a plain-language reason the assistant can pass on.
Timing rules
scheduled_atmust be in the future and include a timezone offset orZ.- Scheduled posts can't be edited, rescheduled or cancelled once publishing has started, or within a few minutes of their time.
publish_nowpublishes immediately and can't be undone; assistants are told to use it only when you ask.
Media
- Upload links from
create_upload_linkare valid for 30 minutes, for one file up to 500 MB. - WebP images are converted to JPG or PNG.
add_media_from_urlneeds a publicly reachable URL.
Rate limits
There is no fixed request quota today beyond your plan's limits. New OAuth client registrations are limited per IP. Please keep automated scripts reasonable; we may add fair-use limits.
Common errors
| Error | What to do |
|---|---|
| 401 Unauthorized | Sign in again, or check the token and its scopes |
| Plan doesn't include MCP | Upgrade, or ask the workspace owner |
| Account can't post | Use an account with can_post: true from list_social_accounts |
| Workspace locked by plan | Upgrade, or choose which workspaces stay active |
| Post can't be edited | It has started publishing or is due within minutes |