TraceeDocs

Tools

apps

Actions in connected apps

MCP toolcan change or delete

Any action of any app this workspace connected (CRM, LinkedIn, Slack, Gmail, Notion, Google Sheets…), found on demand.

Actions

search

search query=<what you want to do> [apps=[slugs]]

Matching actions with their slug, risk (read | write | destructive) and required inputs.

RESTGET/apps/actions·CLItracee apps search

schema

schema slug=<SLUG>

One action's inputs in full.

RESTGET/apps/actions/{slug}·CLItracee apps schema <slug>

run

Slug=<SLUG> args={...} [connection_id] [note]: run it. read actions run straight away; write and destructive ones become an approval request for a person, and run as soon as they approve.

RESTPOST/apps/actions/{slug}/run·CLItracee apps run <slug>

request

App=<toolkit slug> method=<GET|POST|PUT|PATCH|DELETE> endpoint=<path on the app's API, e.g. /crm/v3/objects/contacts> [params={query}] [body={...}] [connection_id] [note]: a direct call to the app's own API, signed with the workspace's connection, for anything no action covers. GET runs straight away; anything else becomes an approval request, like a write action.

RESTPOST/apps/{app}/request·CLItracee apps request <app>

Prefer posts for publishing (it adds UTM tracking and guardrails); use apps for everything else, and search for an action before making a direct request.

Inputs

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

  • actionstringrequired

    What to do: search, schema, run or request. Each is described in the tool description.

    Available options:searchschemarunrequest

  • appstring

    For request: the toolkit slug, e.g. hubspot. From channels action=list (connectedApps[].app).

    up to 60 characters

  • methodstring

    For request; default GET

    Available options:GETPOSTPUTPATCHDELETE

  • endpointstring

    For request: a path relative to the app's API, or a full URL on its domain

    up to 1,000 characters

  • paramsobject

    For request: query string parameters

    any keys

  • bodyany

    For request: the JSON body

  • querystring

    For search and request: the query.

    up to 300 characters

  • appsstring[]

    Limit search to these toolkit slugs

  • slugstring

    For schema, run, search and request: the slug. From apps action=search query=<what you want to do>.

    up to 200 characters

  • argsobject

    For run: the args.

    any keys

  • connection_idstring

    Which connection, if the app has several. From channels action=list (connectedApps[].connection_id).

  • notestring

    Context for the approver

    up to 500 characters

  • limitinteger

    The limit.

    1–25