PilotMCP
Platforms and tools

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

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.

ParameterTypeRequiredDescription
account_idstringnoID 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.

ParameterTypeRequiredDescription
levelstringyesThe level of the rows. Values: "ACCOUNT", "CAMPAIGN", "AD_GROUP", "STORE".
granularitystringnoDAY (default): one row per entity and per day; TOTAL: one row per entity over the period. Values: "DAY", "TOTAL".
start_datestringyesFirst day, YYYY-MM-DD, inclusive.
end_datestringyesLast day, YYYY-MM-DD, inclusive; at most 92 days after the first.
metricsstring[]noThe 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_idsstring[]noRead only these campaigns (200 at most).
store_idsstring[]noRead only these stores (200 at most).
account_idstringnoID 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.

ParameterTypeRequiredDescription
campaign_idstringnoRead only the ad groups of this campaign (recommended).
ad_group_idstringnoRead only this ad group (with campaign_id).
max_itemsintegernoItems to read (default 100, maximum 2000); reponse.tronque says whether more remain.
account_idstringnoID 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.

ParameterTypeRequiredDescription
campaign_idstringyesThe campaign of the ad group.
ad_group_idstringyesThe ad group.
max_itemsintegernoItems to read (default 100, maximum 2000); reponse.tronque says whether more remain.
account_idstringnoID 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.

ParameterTypeRequiredDescription
campaign_idstringnoRead only this campaign.
max_itemsintegernoItems to read (default 100, maximum 2000); reponse.tronque says whether more remain.
account_idstringnoID 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.

ParameterTypeRequiredDescription
max_itemsintegernoItems to read (default 100, maximum 2000); reponse.tronque says whether more remain.
account_idstringnoID 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.

ParameterTypeRequiredDescription
campaign_idstringyes
ad_group_idstringyes
account_idstringnoID 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_amountnumberyesAmount 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.

ParameterTypeRequiredDescription
campaign_idstringyes
ad_group_idstringyes
account_idstringnoID 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.
amountnumberyesAmount in units of the account currency (12.5 for 12.50). Never zero: an empty budget would remove the budget.
unitstringyesDaily, 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.

ParameterTypeRequiredDescription
campaign_idstringyes
ad_group_idstringyes
account_idstringnoID 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.
statusstringyesACTIVE 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.

ParameterTypeRequiredDescription
campaign_idstringyes
ad_group_idstringyes
account_idstringnoID 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_idstringyes
statusstringyesACTIVE 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.

ParameterTypeRequiredDescription
campaign_idstringyes
amountnumberyesAmount in units of the account currency (12.5 for 12.50). Never zero: an empty budget would remove the budget.
unitstringyesDaily, weekly or total. Values: "BUDGET_UNIT_DAILY", "BUDGET_UNIT_WEEKLY", "BUDGET_UNIT_FIXED".
account_idstringnoID 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.

ParameterTypeRequiredDescription
campaign_idstringyes
statusstringyesACTIVE to deliver, PAUSED to pause. Values: "ACTIVE", "PAUSED".
account_idstringnoID 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.

On this page