Social

List the social networks

social_networks · Reads only · Markdown

Every 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*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which social networks can you post to for us?

Your agent callssocial_networksFree*

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.

With these arguments
{}
What comes back
{
  "networks": [
    {
      "network": "bluesky",
      "name": "Bluesky",
      "connect": "login",
      "enabled": true,
      "fields": [
        "password",
        "service"
      ],
      "how": "username: the handle (e.g. acme.bsky.social); password: an app password made in Bluesky's settings (two-factor sign-in must be off); service only for another server than bsky.social."
    },
    {
      "network": "discord",
      "name": "Discord",
      "connect": "link",
      "enabled": true,
      "own": {
        "fields": [
          "webhook_url"
        ],
        "how": "webhook_url: a webhook made in the Discord channel's settings (Integrations, Webhooks). Posts carry the webhook's name and picture."
      }
    }
  ]
}

Use it when

Before connecting an account, to learn how its network connects.

What it does

Every network Conecto can post to and how each connects: link (OAuth: you get a link for the owner to open), login (you pass the account's login or key to social_connect; how says which) or telegram. enabled says whether it is switched on for Conecto yet; the others wait for the network's app review. Telegram, Discord and Slack also connect with the business's own bot or webhook (own: the fields for social_connect and how to get them), which needs no app review, so it works enabled or not.

What comes back

Every network with its id, name, how it connects (link, login or telegram) and enabled; a login network also lists the fields it needs and how to get them. Telegram, Discord and Slack also list own: the fields for the business's own bot or webhook and how to get them, which work whether the network is enabled or not. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call social_networks on https://api.conecto.chat/mcp/social. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/social_networks \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md