Look something up on a channel
Runs one of a channel's lookups, like the channels of a Discord server or the boards on Pinterest.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Which channels on our Discord server can you post in?
Your agent callssocial_channel_lookupFree*
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",
"method": "channels"
}Use it when
A post needs a setting only the network knows, such as a Discord channel id.
What it does
Run one of a channel's lookups (social_channel_rules lists them), e.g. "channels" on Discord and Slack for the channel ids posts need, "boards" on Pinterest, "publications" on Medium. Free.
What comes back
The channel_id, the method, and result: what the network answered, like the channels with their ids and names. 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_-]+$. |
methodRequired | string | Matches ^[A-Za-z][A-Za-z0-9_]{0,63}$. |
data | object |
The call
Over MCP, call social_channel_lookup on https://api.conecto.chat/mcp/social. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/social_channel_lookup \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"channel_id":"clx0d6k2v0003","method":"channels"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | The channel has no lookup by that name, or the channel is unknown. | Call social_channel_rules and use one of its lookups. |
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* - Read a channel's rules
social_channel_rulesWhat a channel's network accepts: lengths, media counts, the settings a post needs, and its lookups.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