1. What HilltopAds MCP is and what you can do with it

What is HilltopAds MCP?

The MCP server (Model Context Protocol) is an official HilltopAds connector for AI clients. Once connected, the AI can read your account data and, when you approve it, make changes – such as creating or updating campaigns – through a secure, dedicated channel, without you pasting numbers back and forth. Your login and password are never shared with the AI client; the connection is authorized with an API key that you generate in your account.

The connector exposes your HilltopAds account through a set of operations (tools). The AI picks the right tool for your request, calls it, and turns the result into a readable answer – a table, a summary or even a chart.

What can you do with it?

The tools do two kinds of things. Read operations pull data – balances, inventory, statistics, a single campaign, or a campaign's source lists. Action operations change your account – create or update campaigns, start and stop them, adjust bids and destination URLs, and manage source black/whitelists. Which tools you see depends on your account type – advertiser, publisher, or both. Right now the grant covers 27 operations: 23 for advertisers and 4 for publishers.

Action operations run only when you approve them. The AI clients label the tools as read-only or write/delete and ask for your confirmation before any change is made.

Account & reporting tools

Tool	What it does
`advertiser_get_balance`	The advertiser account's current balance.
`advertiser_list_inventory`	Your campaigns and their ads.
`advertiser_get_stats`	Statistics filtered or grouped by date, zone, GEO, campaign, OS, hour or source.
`advertiser_get_campaign`	Full details for a single campaign by its ID.

Campaign management tools

Note: in the walkthroughs below the assistant creates each campaign inactive so you can review it before it spends. That is a reasonable default the assistant chose – not a fixed rule. If you want a campaign created inactive (or launched right away), say so explicitly in your request.

Tool	What it does
`advertiser_create_campaign`	Create a new campaign.
`advertiser_update_campaign`	Partially update a campaign's settings.
`advertiser_start_campaign`	Activate an approved campaign.
`advertiser_stop_campaign`	Deactivate a running campaign.
`advertiser_archive_campaign`	Move a campaign to the archive.
`advertiser_unarchive_campaign`	Restore a campaign from the archive.
`advertiser_set_bid`	Change the wildcard-GEO bid.
`advertiser_set_destination_url`	Change a Popunder destination URL.
`advertiser_replace_domain`	Replace a domain across all ads in the advertiser account.

Source blacklist

Tool	What it does
`advertiser_get_blacklist`	A campaign's source blacklist.
`advertiser_add_to_blacklist`	Add sources to the blacklist.
`advertiser_remove_from_blacklist`	Remove sources from the blacklist.
`advertiser_clear_campaign_blacklist`	Clear a campaign's blacklist.
`advertiser_set_blacklist`	Replace the whole list and switch the campaign to BLACKLIST mode.

Source whitelist

Tool	What it does
`advertiser_get_whitelist`	A campaign's source whitelist.
`advertiser_add_to_whitelist`	Add sources to the whitelist.
`advertiser_remove_from_whitelist`	Remove sources from the whitelist.
`advertiser_clear_campaign_whitelist`	Clear a campaign's whitelist.
`advertiser_set_whitelist`	Replace the whole list and switch the campaign to WHITELIST mode.