Tool catalog: all 32 PaidHelm Google Ads tools

Every tool is one task. Tools marked write change your account and require explicit object IDs that the assistant obtains from a read first. Campaign-creation tools always create the campaign paused.

Account and plan

Tool	Type	What it does
`listar_contas`	read	Lists the Google Ads accounts your login can access, with names, hierarchy and manager flag.
`plan_usage`	free	Shows your plan, tasks used this cycle and the renewal date.
`upgrade_plan`	free	Generates a personal checkout link to upgrade or change plan. Access updates automatically after payment.

Reporting

Tool	Type	What it does
`consultar_relatorio`	read	Runs any read-only GAQL query. Covers every Google Ads report: campaigns, ad groups, keywords, search terms, ads, assets, geographic, device, hour of day, conversions, change history and more. See Reports and GAQL.

Campaign management

Tool	Type	What it does
`alterar_status`	write	Pauses, enables or removes a campaign, ad group, ad or keyword.
`renomear`	write	Renames a campaign or ad group.
`alterar_orcamento`	write	Changes the daily budget of an existing campaign, in the account currency.
`listar_estrategias_portfolio`	read	Lists shared (portfolio) bid strategies in the account.
`definir_estrategia_lance`	write	Sets the campaign bid strategy: manual CPC, maximize clicks, maximize conversions (optional target CPA), maximize conversion value (optional target ROAS) or a portfolio strategy.

Targeting

Tool	Type	What it does
`buscar_localizacao`	read	Finds official geo-target IDs by name (city, state, country, region).
`segmentar_localizacao`	write	Adds location targeting (or exclusions) to a campaign using those IDs.
`buscar_idioma`	read	Finds official language codes.
`segmentar_idioma`	write	Sets the languages a campaign targets.

Keywords

Tool	Type	What it does
`planejar_palavras_chave`	read	Keyword Planner: discovers new keyword ideas from seed terms or a URL with volume, competition and bid ranges.
`metricas_palavras_chave`	read	Returns search volume, competition and bid range for a specific list of keywords.
`adicionar_palavras_chave`	write	Adds positive keywords to an ad group with match types.
`adicionar_negativas`	write	Adds negative keywords at campaign or ad group level.

Ads and extensions

Tool	Type	What it does
`criar_grupo_anuncios`	write	Creates an ad group inside an existing campaign.
`criar_anuncio`	write	Creates a responsive search ad (RSA) with up to 15 headlines and 4 descriptions.
`editar_anuncio`	write	Updates headlines and descriptions of an existing RSA.
`adicionar_sitelinks`	write	Adds sitelink assets to a campaign.
`adicionar_frases_destaque`	write	Adds callout assets to a campaign.
`enviar_imagem`	write	Uploads an image from a public URL to the account's asset library (for Display, Demand Gen and Performance Max).

Campaign creation

Tool	Type	What it does
`criar_campanha_pesquisa`	write	Creates a Search campaign: name, budget, locations, languages, bid strategy, network settings. Paused.
`criar_campanha_pmax`	write	Creates a Performance Max campaign with its asset group: business name, headlines, long headlines, descriptions, images, logo, final URL. Paused.
`criar_campanha_display`	write	Creates a Display campaign with a responsive display ad (texts plus the three required image formats). Paused.
`criar_campanha_demand_gen`	write	Creates a Demand Gen campaign with audience control, texts, business name and images. Paused.
`criar_campanha_shopping`	write	Creates a Shopping campaign. Requires a Merchant Center account already linked to Google Ads. Paused.
`criar_campanha_app`	write	Creates an App campaign given the app ID and store (Google Play or App Store). Paused.
`campanha_video_como_fazer`	read	Explains why Video (YouTube) campaigns cannot be created through the API and the fastest manual path.

Advanced

Tool	Type	What it does
`executar_operacao_servico`	read/write	Calls Google Ads API service endpoints outside the mutate flow (for example recommendations, reach planning, billing setup queries).
`executar_operacao_avancada`	write	Runs any Google Ads API mutate operation that has no dedicated tool, with the full request body. For experienced users; the assistant will show the request before sending.

Frequently asked questions

Why are tool names in Portuguese?

PaidHelm's server was first deployed for Brazilian advertisers and tool names are stable identifiers that assistants call by name. Descriptions and parameters are documented in English and every modern assistant maps your English request to the right tool automatically. English aliases are on the roadmap.

Does every call count as a task?

Yes, except plan_usage and upgrade_plan, which are free. Reading the tool list when the connector loads is not a task.

Can I restrict which tools the assistant may use?

Yes. Most clients let you disable individual tools per connector. You can also instruct the assistant, for example 'only use read-only tools in this chat'.