Read a channel's rules
What a channel's network accepts: lengths, media counts, the settings a post needs, and its lookups.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
What does our Discord server need before you can post there?
Your agent callssocial_channel_rulesFree*
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"channel_id": "clx0d6k2v0003"
}Use it when
Before posting to a network for the first time, or when a post was refused.
What it does
What a channel's network accepts: its rules (media counts, lengths), max_length, the settings a post may or must carry (a JSON schema, e.g. Discord's channel, Medium's title) and its lookups (for social_channel_lookup). Free.
What comes back
The channel's rules (media counts, lengths), max_length, the settings a post may or must carry (as a JSON schema), and the lookups social_channel_lookup can run. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
channel_idRequired | string | A channel_id from social_channels. 1 to 64 characters, matches ^[A-Za-z0-9_-]+$. |
The call
Over MCP, call social_channel_rules on https://api.conecto.chat/mcp/social. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/social_channel_rules \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"channel_id":"clx0d6k2v0003"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No channel of the business has that channel_id. | Call social_channels and use one of its channel_ids. |
no_channels409 | The business has no connected channel yet. | Connect one with social_connect. |
not_switched_on503 | Social posting is not switched on yet. | Try again later; nothing was charged. |
social_unavailable503 | The posting service did not answer, or could not open the business's social workspace. | Call again in a minute; when the message says so, tell Conecto's support. |
refused400 | The posting service refused the request; the message gives its reason. | Fix what the reason names, then call again. |
refused422 | The posting service reported a conflict with what is there. | Read the channel or post again, then call again. |
rate_limited429 | The posting service's limit of posts an hour was reached. | Try again later. |
More Social tools
All 13 tools- List the social networks
social_networksEvery network the business can post to, how each connects (a link, a login, Telegram's code, or its own bot or webhook), and whether it is switched on yet.Free* - Connect a social account
social_connectConnects one of the business's own social accounts as a channel: by a link for the owner, a login, or a code posted in a Telegram channel.Free - List the connected channels
social_channelsThe business's connected social accounts (channels), with their network, name and profile.Free* - Look something up on a channel
social_channel_lookupRuns one of a channel's lookups, like the channels of a Discord server or the boards on Pinterest.Free* - Find a free time to post
social_find_slotThe next free time to post on a channel, from its posting times and what is already scheduled.Free* - Post to social channels
social_postPosts now or at a set time to one or several channels, with pictures, video or a thread.$0.02 per channel posted to - Read a post waiting for its owner
social_post_checkReads a TikTok post waiting for its owner, with what to show and ask them from TikTok just now.Free* - Answer for the owner of a post
social_confirm_postPosts a TikTok post waiting for its owner with the choices they made in your chat, or drops it.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md