Skip to content
Tecrübetecrube.com
Assistant tools · Optimisation and protection

General tools

Account status, campaign summary, reports, approval queue, brand profile and channel-independent change tools.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools22 tools

get_status

Read1 credits

Account overview: brand, plan, connected platforms, campaigns (7 days), pending approvals, open customer chats, spend guard. Call first when context is unknown.

This tool takes no parameters.

list_accounts

Read1 credits

Connected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. A platform can have several connections (logins): each row has connection_id, account_key (login), is_default and the ad accounts known for it; pass one of them to a platform tool via per_call_argument (customer_id / account_id / advertiser_id) to run that call in it. 'sample' connections are demo data, not live.

ParameterTypeDescription
platformOptionalstringoptional filter, e.g. google, meta, microsoft
all_accessibleOptionalbooleanalso name the tool that lists every accessible account of each platform

list_campaigns

Read1 credits

Campaigns with the last N days of spend, clicks, orders and revenue. Use the returned campaign ids for update_campaign / add_negative_keywords.

ParameterTypeDescription
daysOptionalinteger (1–90)—

get_report

Read1 credits

One report tool for every connected platform. Without platform: the period report (period) or, with days/start_date, ledger numbers per channel and campaign. With platform: that platform's own live report at the given level/breakdown/date range (the result names the source tool). Read only.

ParameterTypeDescription
periodOptionalday | week | month—
platformOptionalstringall (default) | google | meta | microsoft | tiktok | linkedin | openai-ads | ga4 | search-console
accountOptionalstringaccount id on platforms that take one per call (microsoft, linkedin, openai-ads, ga4 property, search-console site)
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
levelOptionalstringcampaign | ad_group | adset | ad | keyword | location | device | age_gender (what the platform supports)
breakdownOptionalstringplatform breakdown, e.g. device, age, placement
limitOptionalinteger (1–500)—

search_terms_report

Read2 credits

Google Ads search terms with spend, clicks and conversions for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Google Ads account; otherwise returns a note, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–90)—
campaign_idOptionalstring—

account_audit

Read3 credits

Account hygiene audit as prioritised findings: spend without results, missing budgets, no spend cap, wasted search terms, pending approvals. Read only.

This tool takes no parameters.

list_pending_approvals

Read1 credits

Changes waiting for the user's approval — only those the user did not ask for themselves (automation rules in ask mode, proactive suggestions): id, kind, title.

This tool takes no parameters.

get_brand_profile

Read1 credits

Brand knowledge base: sector, location, products, audience, goals, tone, competitors.

This tool takes no parameters.

research

Read4 credits

Web research (competitor, price, sector rule). If no research provider is configured, returns a note; never invent results.

ParameterTypeDescription
queryRequiredstring—

list_customers

Read1 credits

Customer conversations in the inbox (WhatsApp, Messenger, Instagram): who wrote, last message, waiting for reply.

ParameterTypeDescription
stateOptionalneeds_you | waiting | auto | done—
limitOptionalinteger—

list_entities

Read1 credits

List the campaigns, ad groups / ad sets, ads or keywords of any connected ad platform with their ids, paginated — instead of looking for the platform-specific list tool (the result names the source tool). Read only.

ParameterTypeDescription
platformOptionalstringgoogle | meta | microsoft | tiktok | linkedin | openai-ads (empty = ledger campaigns of all platforms)
entityOptionalcampaigns | ad_groups | ads | keywords—
parent_idOptionalstringcampaign id for ad groups, ad group id for ads/keywords (where the platform needs it)
accountOptionalstringaccount id on platforms that take one per call
daysOptionalinteger (1–90)ledger campaigns: numbers of the last N days
limitOptionalinteger (1–500)—
offsetOptionalinteger (0–…)—

account_snapshot

Read1 credits

One-call picture of an ad account (or all): connections, live/paused campaign counts, recent spend, orders, revenue, ROAS per platform and campaign, pending approvals and the latest applied changes. Use before any review. Read only, no external calls.

ParameterTypeDescription
platformOptionalstring—
accountOptionalstringfilter connections by account id
recent_daysOptionalinteger (1–90)—
include_inactiveOptionalbooleanalso list paused/ended campaigns without spend

get_billing_status

Read0 credits

Current plan, account status, trial end date and the credit balance (period, limit, used, remaining, seats).

This tool takes no parameters.

start_subscription

Read0 credits

Give the user the dashboard link where they choose a paid plan, accept the legal terms and pay on the secure payment page themselves. Nothing is charged from chat and no card details are asked.

ParameterTypeDescription
planOptionalpro | agency | enterprise—

issue_status

Read0 credits

Status of a reported problem: open/answered/closed, when it was reported and the support team's answer once there is one.

ParameterTypeDescription
issue_idOptionalstringdefault: the latest ticket

list_open_problems

Read1 credits

Open problems the assistant's nightly scan found in this account and has not seen resolved, most severe first: problem code, area (delivery, policy, budget, bidding, tracking, account, connection, sync, feed, seo, production, plan), severity, platform, target name, the platform's own status code, first_seen / last_seen, and the catalogue fixes for each problem with their mode (auto = safe maintenance, ask = needs the user's approval because it changes money or a live ad, manual = the user does it on the platform; `where` says where). Read only: it applies no fix and makes no external call. An empty list means the last scan saw no open problem.

ParameterTypeDescription
severityOptionalhigh | medium | lowoptional filter
platformOptionalstringoptional filter, e.g. google, meta, search-console
limitOptionalinteger (1–25)—

describe

Read0 credits

Find tools and read their full input schema. With name/names: description, schema, credits, read-only/destructive flags. With query/platform: a ranked short list. Use it to reach tools that are not in the visible list.

ParameterTypeDescription
nameOptionalstring—
namesOptionalarray<string>—
queryOptionalstringwords to search in tool names and descriptions
platformOptionalstring—
read_onlyOptionalboolean—
limitOptionalinteger (1–100)—

list_brands

Read0 credits

List the account's projects (brands): id, name, default flag, how many ad/analytics accounts each one uses, and which project the tools currently work with. Every tool also accepts an optional `brand` argument (project id or name) to run once in another project.

This tool takes no parameters.

list_rules

Read0 credits

Automation rules set up with create_rule: id, condition (if) and action (then), mode (ask = asks first, auto = applies itself, off = only watches), on/off, how often and when it last fired, plus the latest rule runs and their outcome. Read-only, free.

This tool takes no parameters.

list_whatsapp_templates

Read1 credits

Approved WhatsApp message templates of the connected business account: name, language and category. Templates are needed for messages outside the 24-hour window. Read only.

This tool takes no parameters.

community_summary

Read1 credits

Community overview: each community's status, price, active member count, open content reports and how many members gave e-mail / WhatsApp permission, the plan's community limit, this month's estimated Tecrübe fee and the connected payment accounts. No member personal data. Read only.

This tool takes no parameters.

list_integration_recipes

Read1 credits

Integration recipes: the catalogue (automation recipes such as new lead → e-mail / Telegram / WhatsApp, new order → notification, campaign alert → channel, webhook, Slack; and setup guides), whether the plan allows each one and which plan unlocks it, which are 'soon', the installed recipes with last run, this month's runs and channel readiness. Read only.

This tool takes no parameters.

Write tools21 tools

connect_account

Write0 credits

Start connecting a platform account. Returns an authorisation link the user must open (OAuth); nothing is connected without the user signing in.

ParameterTypeDescription
providerRequiredgoogle | meta | microsoft | tiktok | linkedin | apple | ga4 | search-console | gbp | whatsapp | shopify | youtube | ikas | x | pinterest | snapchat | reddit | yandex | tiktok-social—
shopOptionalstringstore address for shopify / ikas (e.g. store.myshopify.com)

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_campaign

Write2 credits

Create a campaign DRAFT (paused). Going live is a separate step: update_campaign(op=publish) when the user asks. Platforms without a live adapter return can_go_live=false with steps.

ParameterTypeDescription
nameRequiredstring—
platformRequiredgoogle | meta | microsoft | tiktok | linkedin | apple—
kindOptionalstringsearch | pmax | display | message | traffic | conversion
daily_budgetOptionalnumber—
goalOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_campaign

Write2 credits

Pause / resume / change daily budget / publish a campaign. The user's request is the consent: the change is applied at once (applied: true, undo: action_id for undo_action) unless a guard refuses it (plan limit, +50% per change, daily spend cap → status not applied with the reason); without a connected account it is a dry run. op=budget amount is in the ad account currency; a different currency is rejected (currency_mismatch).

ParameterTypeDescription
campaign_idRequiredstring—
opRequiredpause | resume | budget | publish—
amountOptionalnumberdaily budget for op=budget, in the ad account currency
currencyOptionalstringoptional ISO 4217 check; must equal the ad account currency

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_budget

Write2 credits

Set ONE campaign's daily budget (campaign_id). A platform-wide amount without campaign_id is rejected with campaign_required and the campaign list — one amount is never copied to every campaign. Amount is in the ad account currency; a different currency is rejected (currency_mismatch). Applied at once when the user asks (applied: true, undo: action_id); increases above 50% per change or above the daily spend cap are refused with the reason.

ParameterTypeDescription
platformRequiredstring—
amountRequirednumber—
campaign_idOptionalstringrequired: budgets change per campaign (list_campaigns)
currencyOptionalstringISO 4217; must equal the ad account currency (no conversion)
periodOptionalday | week | month—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_negative_keywords

Write2 credits

Add negative keywords to a Google Ads campaign. Applied directly when the user asks (the result shows the preview); applied to Google only with a connected account.

ParameterTypeDescription
campaign_idRequiredstring—
keywordsRequiredarray<string>—
match_typeOptionalBROAD | PHRASE | EXACT—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_rule

Write2 credits

Turn an 'if … then …' sentence into an automation rule (the rule did not come from the user's own request each time, so mode=ask puts each trigger into approval; auto applies within the spend guard). See or switch off rules later with list_rules and set_rule_status.

ParameterTypeDescription
sentenceRequiredstring—
modeOptionalask | auto—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_spend_guard

Write1 credits

Change the profit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot. Applied at once when the user asks (the result shows old → new and undo: action_id); raise a cap here when a change was refused by it.

ParameterTypeDescription
daily_cap_tryOptionalnumber (0–…)—
monthly_cap_tryOptionalnumber (0–…)—
target_cpa_tryOptionalnumber (0–…)—
margin_pctOptionalnumber (0–…)—
aov_tryOptionalnumber (0–…)—
autopilotOptionalboolean—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

approve_action

WriteIrreversible5 credits

Apply a pending change from a rule or a proactive suggestion (changes the user asks for are applied by their own tool; never needed for those). Two steps: without confirm it applies NOTHING and returns the preview to show the user. Only call with confirm=true after the user explicitly approved that preview. A change proposed through this same connection can't be approved here: the result gives approve_url, where the user approves it on the dashboard. Returns applied / dry run / failed.

ParameterTypeDescription
action_idRequiredstring—
confirmRequiredbooleanmust be true; only after the user explicitly approved

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

reject_action

Write0 credits

Reject a pending change (from list_pending_approvals) so it is never applied. Use it when the user declines a preview; nothing is sent to any platform and the change disappears from the approval queue.

ParameterTypeDescription
action_idRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_brand_profile

Write1 credits

Write brand profile fields when the user describes the business.

ParameterTypeDescription
fieldsRequiredobjectbusiness.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

draft_ad_copy

Write2 credits

Ad copy drafts (headlines, descriptions, call to action) from the brand profile.

ParameterTypeDescription
platformOptionalgoogle | meta | instagram—
kindOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

reply_customer

WriteIrreversible2 credits

Send a reply to a customer thread on the user's behalf — only when the user dictated or explicitly chose the text. It is sent at once and a sent message can't be taken back.

ParameterTypeDescription
thread_idRequiredstring—
textRequiredstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

report_issue

Write0 credits

Open a support ticket for a problem the user hits (a tool error, wrong data, a missing feature). It lands in the support inbox; the answer shows in the dashboard. Returns issue_id for issue_status.

ParameterTypeDescription
subjectRequiredstring—
descriptionOptionalstring—
categoryOptionalgenel | fatura | baglanti | kampanya | hata | oneri—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upload_image

Write1 credits

Turn an image (base64 or a public URL) into a signed, time-limited public image URL that tools needing an image_url accept. Stored in the account's private file area; PNG, JPEG, WEBP or GIF up to 5 MB.

ParameterTypeDescription
image_base64OptionalstringPNG/JPEG/WEBP/GIF, optionally as a data: URL
source_urlOptionalstringpublic http(s) image URL to copy instead
filenameOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

call_write_tool

Write0 credits

Run any tool by name — the gateway to capabilities not shown in a reduced tool list. The named tool keeps its own rules: changes are applied at once when the user asks (guards still refuse unsafe ones), read-only connections cannot write, and the named tool's credits apply (the gateway itself is free).

ParameterTypeDescription
nameRequiredstringexact tool name (see describe)
argumentsOptionalobjectthat tool's arguments

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

generate_content

Write3 credits

One-step generation of a plain image, short video, UGC video, voice-over or script from a brief: it STARTS AT ONCE when called and the production's credits are used without a price confirmation (if the remaining credits do not cover it nothing starts: credits_exhausted). No quality tier or recipe. To show the price first and get the user's approval, or for any recipe of the Production screen (product photo, edit, AI influencer / avatar, brand film, dubbing, pack, variations), use quote_production then start_production instead. The script is immediate; files take minutes — check them and get the file URL with list_productions.

ParameterTypeDescription
kindRequiredstringimage | short_video | ugc_video | voice | script
briefOptionalstring—
campaign_idOptionalstring—
resolutionOptional1K | 2K | 4Kimages only

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

select_brand

Write0 credits

Choose the project (brand) the tools work with from now on — reports, changes and drafts then use that project's own Google/Meta accounts, site and counters. The choice is kept for your next sessions; 'default' goes back to the default project. Use list_brands to see the names.

ParameterTypeDescription
brandRequiredstringproject id or name; 'default' returns to the default project

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_rule_status

Write0 credits

Switch an automation rule on or off, or change its mode (ask first / apply automatically / only watch). Use it when a rule fires wrongly or the member wants to pause it. Free.

ParameterTypeDescription
rule_idRequiredstringid from list_rules
enabledOptionalbooleanfalse switches the rule off, true back on
modeOptionalask | auto | offask | auto | off

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

send_message_to_opted_in

WriteIrreversible2 credits

Send one message to every customer who gave permission on a channel (WhatsApp, SMS or e-mail). Shows the recipient count first and goes through approval. A sent message can't be undone. People without consent are never included. If the channel's carrier isn't connected the message waits in the outbox. To answer one conversation use reply_customer.

ParameterTypeDescription
channelRequiredemail | sms | whatsappwhatsapp, sms or email
textRequiredstringmessage body, at most 1600 characters

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

send_community_announcement

WriteIrreversible2 credits

Publish an announcement in a community feed and e-mail it to active members who gave e-mail permission (optionally WhatsApp). Shows the recipient count first and goes through approval; uses the bulk e-mail allowance. A sent message cannot be undone. Members without permission never receive it.

ParameterTypeDescription
community_idRequiredstringfrom community_summary
titleRequiredstringannouncement title, at most 200 characters
bodyOptionalstringplain text body, at most 8000 characters
whatsappOptionalbooleanalso send on the business's own WhatsApp to members who gave WhatsApp permission

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

install_integration_recipe

Write1 credits

Install an automation recipe that notifies the owners and admins (e-mail, Telegram, WhatsApp or panel) when its trigger happens. Goes through approval; checks the plan first and warns if the channel is not connected. Recipes that need a webhook address or secret must be installed in the dashboard.

ParameterTypeDescription
recipe_keyRequiredstringautomation recipe key from list_integration_recipes
channelOptionalemail | panel | telegram | whatsappfor channel recipes: email, telegram, whatsapp or panel

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.