# Uber Ads

Source: https://pilot.braike.com/en/docs/regies/uber-ads

The 12 tools Pilot MCP serves for Uber Ads: 6 read-only, and 6 that write with the €29 plan, taken from the server.

Pilot MCP serves **6 read-only tools** for Uber Ads, on every plan. With the €29 plan, it also serves **6** that create or change. Their names start with `uber_ads_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 6 |
| [Create and change (€29)](#modification) | 6 |

## Other tools [#autres]

### `uber_ads_get_ad_account` [#uber_ads_get_ad_account]

**Uber Ads: Get Ad Account** · read-only · idempotent

The Uber Ads ad account linked to the workspace: name, currency, country, account type (OFD: food delivery; USER\_STORES\_GROUP: account created automatically for a merchant's stores; CPG: product brands; AGENCY…) and billing mode. The type tells which ad products the account can buy (Sponsored Listing, Sponsored Search, Sponsored Item, Sponsored Brands). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_get_statistics` [#uber_ads_get_statistics]

**Uber Ads: Get Statistics** · read-only · idempotent

The Uber Ads statistics of the linked account, by level (ACCOUNT, CAMPAIGN, AD\_GROUP, STORE: the Uber Eats store), per day (DAY) or over the whole period (TOTAL), 92 days at most, within the last two years: impressions, clicks, spend, orders and sales attributed by Uber over 7 days by click (counted on the click day, or on the order day) and by exposure, new customers, customers returning after 42 days away or loyal to the brand (not additive from one day to the next). CTR, CPC, CPM, ROAS, cost per order and average basket recomputed. No ad level at Uber. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `level` | `string` | yes | The level of the rows. Values: `"ACCOUNT"`, `"CAMPAIGN"`, `"AD_GROUP"`, `"STORE"`. |
| `granularity` | `string` | no | DAY (default): one row per entity and per day; TOTAL: one row per entity over the period. Values: `"DAY"`, `"TOTAL"`. |
| `start_date` | `string` | yes | First day, YYYY-MM-DD, inclusive. |
| `end_date` | `string` | yes | Last day, YYYY-MM-DD, inclusive; at most 92 days after the first. |
| `metrics` | `string[]` | no | The metrics; when omitted, all of them. Values: `"impressions"`, `"clicks"`, `"ad_spend"`, `"orders_7d_on_click_date"`, `"sales_7d_on_click_date"`, `"exposed_orders_7d_on_impression_date"`, `"exposed_sales_7d_on_impression_date"`, `"roas_7d_on_click_date"`, `"orders_7d_on_order_date"`, `"sales_7d_on_order_date"`, `"exposed_orders_7d_on_order_date"`, `"exposed_sales_7d_on_order_date"`, `"new_to_brand_customers"`, `"42d_lapsed_to_brand_customers"`, `"42d_existing_to_brand_customers"`. |
| `campaign_ids` | `string[]` | no | Read only these campaigns (200 at most). |
| `store_ids` | `string[]` | no | Read only these stores (200 at most). |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_list_ad_groups` [#uber_ads_list_ad_groups]

**Uber Ads: List Ad Groups** · read-only · idempotent

The Uber Ads ad groups (the level that holds ad product, budget, bid, schedule and targeted stores): configured and effective status, product (Sponsored Listing, Sponsored Search…), budget, bid strategy (auto, manual, goal\_based) with the manual bid or the ROAS goal, dates, targeted stores, summary of the ads. With a campaign named: its ad groups; otherwise the ad groups of the first 25 campaigns. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | no | Read only the ad groups of this campaign (recommended). |
| `ad_group_id` | `string` | no | Read only this ad group (with campaign\_id). |
| `max_items` | `integer` | no | Items to read (default 100, maximum 2000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_list_ads` [#uber_ads_list_ads]

**Uber Ads: List Ads** · read-only · idempotent

The Uber Ads ads of an ad group: id, name, creative (Sponsored Brands), configured and effective status with its reasons. Uber reports no statistics at the ad level: get\_statistics goes down to the ad group. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes | The campaign of the ad group. |
| `ad_group_id` | `string` | yes | The ad group. |
| `max_items` | `integer` | no | Items to read (default 100, maximum 2000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_list_campaigns` [#uber_ads_list_campaigns]

**Uber Ads: List Campaigns** · read-only · idempotent

The Uber Ads campaigns of the linked account: id, name, configured status and effective status (what can actually deliver) with its reasons, campaign budget (amount in units of the account currency, unit BUDGET\_UNIT\_DAILY, \_WEEKLY or \_FIXED, co-funded share), summary of the ad groups. Dates live on the ad groups, not on the campaign. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | no | Read only this campaign. |
| `max_items` | `integer` | no | Items to read (default 100, maximum 2000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_list_stores` [#uber_ads_list_stores]

**Uber Ads: List Stores** · read-only · idempotent

The Uber Eats stores linked to the Uber Ads ad account: id, name, currency, city, postal code, country. The id is the one used by the STORE dimension of get\_statistics and by the stores an ad group targets. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `max_items` | `integer` | no | Items to read (default 100, maximum 2000); reponse.tronque says whether more remain. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `uber_ads_update_ad_group_bid` [#uber_ads_update_ad_group_bid]

**Uber Ads: Update Ad Group Bid** · create or change, €29 plan · creates an object on each call

Changes the manual bid of an Uber Ads ad group of the linked account, in units of the account currency. Refuses an ad group on automatic or goal-based bidding: this tool does not change the strategy.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `ad_group_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |
| `bid_amount` | `number` | yes | Amount in units of the account currency (12.5 for 12.50). Never zero: an empty budget would remove the budget. |

### `uber_ads_update_ad_group_budget` [#uber_ads_update_ad_group_budget]

**Uber Ads: Update Ad Group Budget** · create or change, €29 plan · creates an object on each call

Changes the budget of an Uber Ads ad group of the linked account: amount in units of the account currency and unit. Reads the ad group back before and after. Never removes the budget.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `ad_group_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |
| `amount` | `number` | yes | Amount in units of the account currency (12.5 for 12.50). Never zero: an empty budget would remove the budget. |
| `unit` | `string` | yes | Daily, weekly or total. Values: `"BUDGET_UNIT_DAILY"`, `"BUDGET_UNIT_WEEKLY"`, `"BUDGET_UNIT_FIXED"`. |

### `uber_ads_update_ad_group_status` [#uber_ads_update_ad_group_status]

**Uber Ads: Update Ad Group Status** · create or change, €29 plan · creates an object on each call

Pauses or reactivates an Uber Ads ad group of the linked account (configured\_status). Reads the ad group back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `ad_group_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |
| `status` | `string` | yes | ACTIVE to deliver, PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |

### `uber_ads_update_ad_status` [#uber_ads_update_ad_status]

**Uber Ads: Update Ad Status** · create or change, €29 plan · creates an object on each call

Pauses or reactivates an Uber Ads ad of the linked account (configured\_status). Reads the ad back before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `ad_group_id` | `string` | yes |   |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |
| `ad_id` | `string` | yes |   |
| `status` | `string` | yes | ACTIVE to deliver, PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |

### `uber_ads_update_campaign_budget` [#uber_ads_update_campaign_budget]

**Uber Ads: Update Campaign Budget** · create or change, €29 plan · creates an object on each call

Changes the budget of an Uber Ads campaign of the linked account: amount in units of the account currency and unit (daily, weekly or total). Reads the campaign back before and after. Never removes the budget.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `amount` | `number` | yes | Amount in units of the account currency (12.5 for 12.50). Never zero: an empty budget would remove the budget. |
| `unit` | `string` | yes | Daily, weekly or total. Values: `"BUDGET_UNIT_DAILY"`, `"BUDGET_UNIT_WEEKLY"`, `"BUDGET_UNIT_FIXED"`. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |

### `uber_ads_update_campaign_status` [#uber_ads_update_campaign_status]

**Uber Ads: Update Campaign Status** · create or change, €29 plan · creates an object on each call

Pauses or reactivates an Uber Ads campaign of the linked account (configured\_status). Reads the campaign back before and after. Archives nothing and creates nothing.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_id` | `string` | yes |   |
| `status` | `string` | yes | ACTIVE to deliver, PAUSED to pause. Values: `"ACTIVE"`, `"PAUSED"`. |
| `account_id` | `string` | no | ID of the workspace's Uber Ads ad account to read, when the workspace links several. Omitted: the workspace's only Uber Ads account. An account that is not linked is refused, never replaced by another one. |
