Overview
AdBid MCP gives an AI client structured tools instead of browser automation. The server authenticates an AdBid owner, uses the owner's existing Meta and Google Ads connections, validates every operation, and returns structured results the client can explain or render.
Your advertising tokens stay in AdBid
Connect a client
- 1. Connect an ad platform. Sign in to AdBid and connect Meta and/or the Google Ads account that owns the required customers.
- 2. Create a key. Open Settings → MCP API Keys and choose read-only or read-and-write access.
- 3. Add the server. Use the hosted URL and the one-time key in your MCP client.
- 4. Reload the client. Existing sessions may not discover a newly added MCP server until they are restarted.
Generic MCP client configuration
The exact settings filename depends on the host. Use the configuration shape supported by your client.
{
"mcpServers": {
"adbid-ads": {
"url": "https://adbid.me/api/mcp",
"headers": {
"Authorization": "Bearer adbid_mcp_YOUR_KEY"
}
}
}
}Treat the key like a password
What the server can do
Tools are grouped by operator job. Your key scope and connected accounts determine which results and actions are available.
Launch an AI Campaign
For Meta ask: “AdBid MCP — open the Meta AI Campaign launch form.” For Google ask: “AdBid MCP — open the Google AI Campaign launch form.”The host can render the MCP App, while the same workflow remains available as structured tool calls when a host has no App UI.
Choose a project
The form loads the projects available to the authenticated AdBid owner.
Choose an ad account
Only accounts available through the selected project and Meta connection are shown.
Configure the launch
Select Page, Pixel, one or more GEOs, devices and operating systems, strategy, budgets, and creative mode.
Preview
AdBid validates access, structure, budget limits, GEO allocation, and returns a preview hash.
Approve and launch
The client sends the preview hash, a unique idempotency key, and confirm=true.
Monitor
Read the launch group status or cancel the group while cancellation is still available.
Multiple GEOs
GEO is a list, so one launch group can include several countries. The daily cap applies to the entire group; the preview rejects a cap that cannot fund at least one campaign slot per GEO.
{
"project_ref": "app:13",
"ad_account_id": "26746757628306575",
"geos": ["US", "DE", "PL"],
"strategy_id": "1-1-N",
"campaign_start_budget_minor_units": 5000,
"launch_group_daily_cap_minor_units": 15000
}AdBid selects the Project Pixel automatically and falls back to the Pixel saved in Strategies settings. Manual selection appears only when the configured Pixel is missing or unavailable to the selected ad account.
Google Ads launch
Google uses a separate MCP App because its campaign structure and required assets differ from Meta. It follows the fast Google AI Launch flow: per-GEO CPA, Campaign → Ad group → Ad structure, generated formats or existing Media collections, and live pipeline progress. The same preview hash, idempotency key, owner access, and explicit confirmation safeguards apply.
Choose a project and account
The form lists the owner’s AdBid projects and connected Google Ads customers.
Choose a campaign type
Create an App/UAC campaign or a Search campaign.
Configure budget and GEO
Set the campaign budget, default Target CPA, multiple GEOs, and an optional CPA override for each country.
Choose structure and creatives
Set campaigns per GEO, ad groups per campaign, and ads per group. Generate Google formats or reuse existing AdBid Media collections with images and videos.
Add ads and targeting
App text is optional; Search requires a final URL, keywords, at least three headlines, and two descriptions.
Preview and approve
AdBid validates campaign totals, creative source, account access, and the exact launch plan before confirmation.
Monitor
The form automatically reads live pipeline progress and per-campaign results using the returned run ID.
Write safety
Where the interactive form appears
The form is an MCP App resource returned by the AdBid server. It appears inside a host that supports MCP Apps and allows the server's UI resource. Hosts without MCP App rendering still receive the same fields as structured data, so the assistant can ask for Project, Ad account, GEOs, and budgets step by step.
If you see text but no form
Troubleshooting
401 or authentication failed
Create a new active key, replace the placeholder, and ensure the Authorization header starts with Bearer.
The server or tools are missing
Restart the MCP client or open a new session after adding the server configuration.
The form is not visible
The active host may not support MCP Apps. Use the structured fallback or a compatible host.
No Projects, Pages, Pixels, or Google customers
Check the AdBid owner, project membership, connected advertising account, and asset permissions.
Launch preview rejects the budget
Increase the group daily cap or reduce the number of GEOs and campaign slots.