TraceeDocs

Tools

inbox

Social inbox

MCP tool

Comments on the workspace's posts, direct messages and mentions from every connected social channel (Facebook, Instagram, YouTube, X, Threads, Reddit, LinkedIn where allowed), each sorted as lead, question, complaint, praise, spam or other.

Actions

list

list [view=needs_reply|drafts|leads|questions|complaints|all|done|spam] [platforms[]] [channel_id] [query] [limit]

Conversations, the ones waiting on the team first; platforms keeps only those networks.

RESTGET/inbox·CLItracee inbox list

get

get thread_id

One conversation with every message, the post it is on, any draft, and whether Tracee can answer there.

RESTGET/inbox/{thread_id}·CLItracee inbox get <thread_id>

draft

draft thread_id [instruction] [save=true]

Three replies in the brand's voice to their latest message. The first is saved as the conversation's draft (in the reply box for a person to send) unless save=false. Nothing is sent.

RESTPOST/inbox/{thread_id}/draft·CLItracee inbox draft <thread_id>

save_draft

save_draft thread_id text

Leave your own reply as the draft. action=discard_draft thread_id.

RESTPUT/inbox/{thread_id}/draft·CLItracee inbox save-draft <thread_id>

reply

reply thread_id text [close]

Send it. Waits for a person's approval when the workspace requires approval to publish.

RESTPOST/inbox/{thread_id}/reply·CLItracee inbox reply <thread_id>

close

close thread_ids[] | action=reopen thread_ids[] | action=spam thread_ids[]

Mark handled, open again, or spam.

RESTPOST/inbox/close·CLItracee inbox close

settings

How new conversations are handled on their own. action=set_auto mode=off|draft [intents[]] [instruction]: auto-draft writes a reply to every new conversation of those kinds and leaves it for a person (mode=reply, sending on its own, is a person's choice in the app).

RESTGET/inbox/settings·CLItracee inbox settings

sync

Read every channel's inbox now (it also refreshes every 10 minutes on its own).

RESTPOST/inbox/sync·CLItracee inbox sync

Prefer drafts when unsure: a person can read and send them with one click.

Inputs

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

  • actionstringrequired

    What to do: list, get, draft, save_draft, discard_draft, reply, close, reopen, spam, settings, set_auto or sync. Each is described in the tool description.

    Available options:listgetdraftsave_draftdiscard_draftreplyclosereopenspamsettingsset_autosync

  • viewstring

    For list: the view.

    Available options:needs_replydraftsleadsquestionscomplaintsalldonespam

  • channel_idstring

    list: one channel, from channels action=list

    uuid

  • platformsstring[]

    list: only these networks, e.g. ["instagram", "facebook"]; all by default

    up to 20 itemseach up to 30 characters

  • querystring

    For list: the query.

    up to 200 characters

  • limitinteger

    For list: the limit.

    1–100

  • thread_idstring

    For get, draft, save_draft, discard_draft, reply, close, reopen and spam: the thread id. From inbox action=list.

    uuid

  • thread_idsstring[]

    For close, reopen and spam: the thread ids. From inbox action=list.

    up to 100 itemseach uuid

  • textstring

    For reply and save_draft

    1–10,000 characters

  • instructionstring

    For draft: what to say. For set_auto: what every reply should keep in mind

    up to 600 characters

  • saveboolean

    For draft: keep the first as the draft (default true)

  • closeboolean

    For reply: mark the conversation handled once sent

  • modestring

    For set_auto

    Available options:offdraftreply

  • intentsstring[]

    For set_auto: which conversations it handles

    Available options:leadquestioncomplaintpraiseother