TraceeDocs

Tools

channels

Channels and connections

MCP tool

Where posts can go and which apps are connected.

Actions

list

Channels (with the channel_id posts need), connected apps, and apps that could be connected.

RESTGET/connections·CLItracee connections list

connect_link

connect_link app=<slug>

A link for a person to open to connect an app (CRM, social network, Gmail…); the agent can't sign in itself. Bluesky, Mastodon, Telegram, Lemmy, Nostr, WordPress, Listmonk, Medium and Farcaster connect directly: the link opens their card, where the person pastes a key or password once.

RESTPOST/connections/link·CLItracee connections link

refresh

refresh connection_id=<id>

Look for new pages, boards or channels on a social connection.

RESTPOST/connections/{connection_id}/refresh·CLItracee connections refresh <connection_id>

rules

rules [platforms]

Each platform's posting rules: max length, required and allowed media, the settings a variant takes (and their allowed values), how follow-up parts work (thread replies or first comments), and the image and video sizes that fit. Read it before drafting for a platform you haven't posted to.

RESTGET/channels/rules·CLItracee channels rules

customers

The client groups channels belong to (agencies), with their channel ids. list takes customer_id to show one client's channels, and platforms to show only some networks.

RESTGET/customers·CLItracee channels customers

options

options channel_ids[]

What each channel's settings can be set to, read live from the platform: Reddit flairs (settings.flairId) and the subreddits the account follows, Pinterest boards, YouTube playlists, and the pages or boards on the same connection that aren't channels yet. Per-channel results: one failing doesn't fail the others.

RESTGET/channels/options·CLItracee channels options

mentions

mentions [query]

People and pages saved for @mentions, with their handle on each network. Write "@Name" in a post and each platform gets its own handle.

RESTGET/mentions·CLItracee channels mentions

save_mention

save_mention name handles={linkedin, x, instagram, …} [mention_id]

Save (or change) one, so "@Name" tags them everywhere.

RESTPOST/mentions·CLItracee channels save-mention

Posting times per channel come back in list (timeSlots, timeZone); a person changes them in the app.

Inputs

Every call takes action and the fields that action names above.

  • actionstringrequired

    What to do: list, connect_link, refresh, rules, customers, options, mentions or save_mention. Each is described in the tool description.

    Available options:listconnect_linkrefreshrulescustomersoptionsmentionssave_mention

  • querystring

    mentions: part of a name or handle

    up to 100 characters

  • namestring

    save_mention: the name written as "@Name" in posts

    up to 60 characters

  • handlesobject

    save_mention: their handle per network, e.g. {"x": "dana", "linkedin": "https://www.linkedin.com/in/dana"}

    any keys

  • mention_idstring

    save_mention: change this one instead, from channels action=mentions

    uuid

  • platformsstring[]

    rules and list: only these platforms, e.g. ["linkedin", "x"]; all by default

    up to 40 itemseach up to 30 characters

  • customer_idstring

    list: only this client's channels. From channels action=customers.

    uuid

  • channel_idsstring[]

    options: the channels to look up, from channels action=list

    1–25 itemseach uuid

  • channel_idstring

    options: one channel, from channels action=list

    uuid

  • appstring

    Toolkit slug from action=list, e.g. hubspot, linkedin

  • connection_idstring

    For refresh, from action=list