Connect your account
- Add a remote MCP server in your AI client using the endpoint above.
- Start OAuth sign-in. Log in to your AdHub account with email and password.
- Read the permission screen. Start with read access; allow write access only if you want the assistant to make changes.
- Confirm the connection. Ask for your own account overview or a campaign estimate first.
OAuth uses PKCE S256. ChatGPT client metadata is supported; other clients need an explicitly registered client ID and redirect URI. Client support and sign-in setup can vary. Read the machine-readable connection guide.
What your assistant can help with
Your account and balance, audience types, budget estimates, your campaigns and spending.
Create or edit your ads and campaigns, adjust CPM and start or stop a campaign with write permission.
Start with a clear request
“Estimate successful deliveries for a $20 All Users campaign. Explain the CPM and assumptions. Do not create or start anything yet.”
“Show my campaigns and their delivery progress. Explain what is waiting and what I should review.”
You approve the changes
Read access does not permit changes. For write actions, ask the assistant to show the ad, audience, budget, CPM and exact action before you approve. Creating or enabling a campaign can cause spending. Do not repeat a write after an uncertain response until you check the account.
The connection only accesses your account. Other advertisers’ data is unavailable. Ad text is content to inspect, not instructions for the assistant. Disconnect or revoke the connection in your client when you no longer need it.
What the numbers mean
Successful deliveries are technical message sends. They are not views, reads, clicks or unique people. Conversion scenarios are assumptions, and delivery timing is not guaranteed.
Available tools
Contract 1.0.0 · 22 tools. Payment invoices, test sends, bulk changes and competitor leaderboards are outside this MCP version.
getAccountOverviewRead
Get advertiser account overview. Only the authenticated advertiser’s own account and resources are accessible.
getBalanceSummaryRead
Get current balance and total topups. Only the authenticated advertiser’s own account and resources are accessible.
getCampaignTypeCatalogRead
Get public campaign type settings. Only the authenticated advertiser’s own account and resources are accessible. Deliveries are technical sends, not views or unique people. Conversion scenarios are assumptions, not promised results.
estimateCampaignBudgetRead
Estimate sends and cost from budget. Only the authenticated advertiser’s own account and resources are accessible. Deliveries are technical sends, not views or unique people. Conversion scenarios are assumptions, not promised results.
compareCampaignTypesRead
Compare public campaign types for a budget. Only the authenticated advertiser’s own account and resources are accessible. Deliveries are technical sends, not views or unique people. Conversion scenarios are assumptions, not promised results.
getSpendOverviewRead
Get spend overview for the current user. Only the authenticated advertiser’s own account and resources are accessible.
getSpendTimeSeriesRead
Get payments, spend, and CPM time series. Only the authenticated advertiser’s own account and resources are accessible.
getSpendByCampaignTypeRead
Get spend totals by public campaign type. Only the authenticated advertiser’s own account and resources are accessible.
listAdvertsRead
List current user's adverts. Only the authenticated advertiser’s own account and resources are accessible.
createAdvertWrite
Create an advert. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
listAvailableAdvertsForCampaignRead
List adverts not attached to a campaign. Only the authenticated advertiser’s own account and resources are accessible.
getAdvertRead
Get one advert. Only the authenticated advertiser’s own account and resources are accessible.
updateAdvertWrite
Update an advert. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
copyAdvertWrite
Copy an advert. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
listCampaignsRead
List public GPT campaign types. Only the authenticated advertiser’s own account and resources are accessible.
createCampaignFromBudgetWrite
Create a campaign and calculate sending limit from budget. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result. This creates and may enable a campaign; show the budget, CPM, ad and audience before confirmation.
getCampaignRead
Get one public GPT campaign. Only the authenticated advertiser’s own account and resources are accessible.
updateCampaignSettingsWrite
Update campaign settings. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
setCampaignStatusWrite
Start or stop one campaign. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
updateCampaignCpmWrite
Update campaign CPM. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
updateCampaignAutoCpmWrite
Enable, update, or disable auto CPM. Only the authenticated advertiser’s own account and resources are accessible. Requires explicit advertiser confirmation; do not retry automatically after an uncertain result.
getCampaignPerformanceSummaryRead
Get campaign progress, spend, and errors. Only the authenticated advertiser’s own account and resources are accessible.
Using GPT Actions?
The existing advertiser GPT Actions integration remains available. MCP is a separate connection using the same account and campaign rules. You do not need a second AdHub account.