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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 6 |
| Create and change (€29) | 6 |
Other tools
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 · 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 · 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 · 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 · 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 · 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)
Served with the €29 plan.
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 · 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 · 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 · 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 · 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 · 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. |