PilotMCP
Platforms and tools

Reddit Ads

The 18 tools Pilot MCP serves for Reddit Ads: 5 read-only, and 13 that write with the €29 plan, taken from the server.

Pilot MCP serves 5 read-only tools for Reddit Ads, on every plan. With the €29 plan, it also serves 10 that create or change and 3 that delete. Their names start with reddit_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

reddit_ads_get_ad_account

Reddit Ads: Get Ad Account · read-only · idempotent

The Reddit Ads ad account linked to the workspace: name, currency, time zone of the days, status at Reddit (VALID, PENDING, SUSPENDED…) and suspension reason, account type, click-through and view-through conversion attribution windows. Read-only.

ParameterTypeRequiredDescription
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_get_statistics

Reddit Ads: Get Statistics · read-only · idempotent

The Reddit Ads statistics of the linked account, by level (ACCOUNT, CAMPAIGN, AD_GROUP, AD), per day (DAY) or over the whole period (TOTAL), days in the account time zone, 92 days at most: impressions, clicks, spend (units of the account currency), key conversions (click and view), value of attributed purchases, conversion breakdown by type (purchases, leads, sign-ups, add to cart, page views) by click and by view, video plays and quartiles, reach and frequency (not additive). CTR, CPC, CPM and cost per conversion recomputed. Conversions follow the account attribution windows. Read-only.

ParameterTypeRequiredDescription
levelstringyesThe level of the rows. Values: "ACCOUNT", "CAMPAIGN", "AD_GROUP", "AD".
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", "SPEND", "KEY_CONVERSION_TOTAL_COUNT", "KEY_CONVERSION_CLICKS", "KEY_CONVERSION_VIEWS", "CONVERSION_PURCHASE_CLICKS", "CONVERSION_PURCHASE_VIEWS", "CONVERSION_PURCHASE_TOTAL_VALUE", "CONVERSION_LEAD_CLICKS", "CONVERSION_LEAD_VIEWS", "CONVERSION_SIGN_UP_CLICKS", "CONVERSION_SIGN_UP_VIEWS", "CONVERSION_ADD_TO_CART_CLICKS", "CONVERSION_ADD_TO_CART_VIEWS", "CONVERSION_PAGE_VISIT_CLICKS", "CONVERSION_PAGE_VISIT_VIEWS", "VIDEO_STARTED", "VIDEO_WATCHED_25_PERCENT", "VIDEO_WATCHED_50_PERCENT", "VIDEO_WATCHED_75_PERCENT", "VIDEO_WATCHED_100_PERCENT", "REACH", "FREQUENCY".
idsstring[]noRead only these entities of the requested level (200 at most; not at the ACCOUNT level).
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_list_ad_groups

Reddit Ads: List Ad Groups · read-only · idempotent

The Reddit Ads ad groups of the linked account (the level that most often holds budget, bid, dates and targeting): configured and applied status, budget (amount in units of the account currency, DAILY_SPEND or LIFETIME_SPEND; absent under a campaign with a campaign budget), bid and its type (CPC, CPM, CPV), bid strategy, optimization goal, dates. Can be filtered by campaign. Read-only.

ParameterTypeRequiredDescription
campaign_idstringnoRead only the ad groups of this campaign.
ad_group_idsstring[]noRead only these ad groups (200 at most).
max_itemsintegernoItems to read (default 100, maximum 1000); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_list_ads

Reddit Ads: List Ads · read-only · idempotent

The Reddit Ads ads of the linked account: configured and applied status, rejection reason, destination URL, post that carries the ad and preview (temporary URL). Can be filtered by ad group, campaign and status. Read-only.

ParameterTypeRequiredDescription
ad_group_idstringnoRead only the ads of this ad group.
campaign_idstringnoRead only the ads of this campaign.
configured_statusstringnoFilter by configured status (ACTIVE, PAUSED, ARCHIVED).
effective_statusanynoFilter by the status applied by Reddit (ACTIVE, REJECTED, PENDING_APPROVAL…).
max_itemsintegernoItems to read (default 100, maximum 1000); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_list_campaigns

Reddit Ads: List Campaigns · read-only · idempotent

The Reddit Ads campaigns of the linked account: id, name, configured status (ACTIVE, PAUSED, ARCHIVED) and status applied by Reddit, objective, campaign budget when it is optimized at the campaign level (amount in units of the account currency, DAILY_SPEND or LIFETIME_SPEND), spend cap, dates. Read-only.

ParameterTypeRequiredDescription
campaign_idsstring[]noRead only these campaigns (200 at most).
max_itemsintegernoItems to read (default 100, maximum 1000); reponse.tronque says whether more remain.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

Create and change (€29)

Served with the €29 plan.

reddit_ads_create_ad

Reddit Ads: Create Ad · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads ad under an ad group of the account linked to the workspace, always PAUSED, from a Reddit post (post_id) and a destination URL. The ad group is read first and refused if it belongs to another account. Delete it with delete_ad.

ParameterTypeRequiredDescription
ad_group_idstringyes
namestringyesAd name.
post_idstringyesReddit post that carries the ad (t3_...).
click_urlstringnoDestination URL.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_create_ad_group

Reddit Ads: Create Ad Group · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads ad group under a campaign of the account linked to the workspace, always PAUSED (manual setup). The campaign is read first and refused if it belongs to another account. bid_strategy: BIDLESS, MAXIMIZE_VOLUME or TARGET_CPX; bid_type: CPC, CPM, CPV6 or CPV15. targeting is passed as is (Reddit v3 targeting object). Delete it with delete_ad_group.

ParameterTypeRequiredDescription
campaign_idstringyes
namestringyesAd group name.
bid_strategystringyesBid strategy. Values: "BIDLESS", "MAXIMIZE_VOLUME", "TARGET_CPX".
bid_typestringyesBid type. Values: "CPC", "CPM", "CPV6", "CPV15".
bid_amountnumbernoRequired by Reddit for TARGET_CPX.
budget_amountnumbernoThe ad group budget, in units of the account currency (12.5 for 12.50).
budget_typestringnoRequired with budget_amount. Values: "DAILY_SPEND", "LIFETIME_SPEND".
start_timestringnoStart, ISO 8601.
end_timestringnoEnd, ISO 8601.
targetingobjectnoReddit v3 targeting object.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_create_campaign

Reddit Ads: Create Campaign · create or change, €29 plan · creates an object on each call

Creates ONE Reddit Ads campaign in the account linked to the workspace, always PAUSED (manual setup). objective: APP_INSTALLS, BRAND_AWARENESS, CATALOG_SALES, CLICKS, CONVERSIONS, IMPRESSIONS, LEAD_GENERATION, SALES or VIDEO_VIEWABLE_IMPRESSIONS. A campaign budget (budget_amount + budget_type) makes it a campaign-budget campaign. Read back after creation. Delete it with delete_campaign.

ParameterTypeRequiredDescription
namestringyesCampaign name.
objectivestringyesCampaign objective. Values: "APP_INSTALLS", "BRAND_AWARENESS", "CATALOG_SALES", "CLICKS", "CONVERSIONS", "IMPRESSIONS", "LEAD_GENERATION", "SALES", "VIDEO_VIEWABLE_IMPRESSIONS".
budget_amountnumbernoThe campaign budget, in units of the account currency (12.5 for 12.50).
budget_typestringnoRequired with budget_amount. Values: "DAILY_SPEND", "LIFETIME_SPEND".
funding_instrument_idstringnoFunding instrument (payment method) of the account.
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_ad_group_bid

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

Changes the bid of a Reddit Ads ad group, in units of the account currency. Refused for an ad group with no bid to set (BIDLESS, MAXIMIZE_VOLUME). Reads it back before and after.

ParameterTypeRequiredDescription
ad_group_idstringyes
bid_amountnumberyesThe bid, in units of the account currency (12.5 for 12.50).
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_ad_group_budget

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

Changes the budget of a Reddit Ads ad group, in units of the account currency. Refused under a campaign with a campaign budget (change the campaign budget instead). Reads it back before and after.

ParameterTypeRequiredDescription
ad_group_idstringyes
budget_amountnumberyesThe budget, in units of the account currency (12.5 for 12.50).
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_ad_group_status

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

Pauses (PAUSED) or reactivates (ACTIVE) an ad group of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

ParameterTypeRequiredDescription
ad_group_idstringyes
statusstringyesACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: "ACTIVE", "PAUSED".
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_ad_status

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

Pauses (PAUSED) or reactivates (ACTIVE) an ad of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

ParameterTypeRequiredDescription
ad_idstringyes
statusstringyesACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: "ACTIVE", "PAUSED".
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_campaign_budget

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

Changes the budget of a Reddit Ads campaign that has a campaign budget, in units of the account currency. Refused for a campaign without a campaign budget (the budget then lives on its ad groups). Reads it back before and after.

ParameterTypeRequiredDescription
campaign_idstringyes
budget_amountnumberyesThe budget, in units of the account currency (12.5 for 12.50).
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_campaign_spend_cap

Reddit Ads: Update Campaign Spend Cap · create or change, €29 plan · creates an object on each call

Changes the lifetime spend cap of a Reddit Ads campaign, in units of the account currency. Reads it back before and after.

ParameterTypeRequiredDescription
campaign_idstringyes
spend_cap_amountnumberyesThe spend cap, in units of the account currency (12.5 for 12.50).
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_update_campaign_status

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

Pauses (PAUSED) or reactivates (ACTIVE) a campaign of the Reddit Ads account linked to the workspace. Reads the object back before and after; refuses an object of another account. Reactivating puts money back at stake.

ParameterTypeRequiredDescription
campaign_idstringyes
statusstringyesACTIVE to reactivate (spend becomes possible), PAUSED to pause. Values: "ACTIVE", "PAUSED".
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

Delete (€29)

Served with the €29 plan. A deletion targets one object at a time.

reddit_ads_delete_ad

Reddit Ads: Delete Ad · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE ad of the Reddit Ads account linked to the workspace (configured_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

ParameterTypeRequiredDescription
ad_idstringyes
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_delete_ad_group

Reddit Ads: Delete Ad Group · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE ad group of the Reddit Ads account linked to the workspace (configured_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

ParameterTypeRequiredDescription
ad_group_idstringyes
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

reddit_ads_delete_campaign

Reddit Ads: Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call

Deletes ONE campaign of the Reddit Ads account linked to the workspace (configured_status DELETED: irreversible, Reddit has no DELETE call). To stop it instead, pause it. Reads it back before and after; refuses an object of another account.

ParameterTypeRequiredDescription
campaign_idstringyes
account_idstringnoID of the workspace's Reddit Ads ad account to read, when the workspace links several. Omitted: the workspace's only Reddit Ads account. An account that is not linked is refused, never replaced by another one.

On this page