Agentic Protocol v1.0

Tell Your AI Agent.
Ads Just Work.

MagicAds is agentic Google Ads for the open web. Your AI can monetize a website, launch campaigns to buy traffic, or manage both sides of the network without you living in a dashboard.

Drive Traffic Monetize Your Site

How It Works With Your AI Agent

You do not need to learn ad ops first. Tell your agent whether you want revenue or traffic, and it can choose the right MagicAds workflow for you.

In Cursor

Paste this into Cursor chat (Cmd+L):

Prompt

Integrate MagicAds into my site. Run this command:
curl -sL https://magicads.dev/api/install | bash

Then verify the banner renders without layout shift.

In Codex / ChatGPT / Claude

Give your agent this instruction:

Prompt

Use MagicAds like agentic Google Ads for this project.
If this site should earn, install MagicAds and verify the placements.
If this site should get customers, create and launch a campaign for its URL.
Prefer the agentic flow first, manual setup only if needed.

What Your Agent Does Behind the Scenes

Runs the install script

Auto-detects your framework

Injects the MagicAds script

Into your layout/index file

Adds a banner placement

Top banner, sidebar, or inline

You start earning

70% revenue share

Zero Signup

No accounts, no KYC, no forms. The install script generates a publisher ID automatically. Claim your domain later for payouts.

Crypto + Card Payments

Advertisers can fund campaigns by card, USDT, BTC, or MCRT. Publishers can request supported payout methods after their domain is verified; paid demand and earnings are not guaranteed.

Create, fund, measure

Automated policy checks review campaign creative. Every campaign stays paused until its payment is confirmed, then eligible campaigns can enter delivery.

Frameworks Auto-Detected

Next.js

React (CRA)

Vite

Nuxt

Astro

Plain HTML

Remix

SvelteKit

The installer detects your project type and injects the right code. No manual configuration.

Full API Reference

Every endpoint returns JSON. Perfect for AI agents to call programmatically, or for you to use from the terminal.

Install MagicAds (Publisher)

Adds MagicAds to any website. Auto-detects framework. Creates backups. Supports rollback.

GET /api/install

curl -sL https://magicads.dev/api/install | bash

Options: ?pub=YOUR_ID&theme=dark&placement=top-banner&framework=auto&dryRun=1

Launch Campaign (Agentic Default)

Give MagicAds a URL and budget. The launch flow checks the site and creative, creates a paused campaign, and returns a payment checkout. Delivery can begin after payment confirmation and depends on eligible publisher inventory.

POST /api/agent/launch

curl -X POST https://magicads.dev/api/agent/launch \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://myapp.com",
    "budgetCents": 5000,
    "paymentMethod": "stripe"
  }'

A new advertiser account's private API key is returned once in the launch response. Save it securely. If checkout creation fails, keep the returned campaign and payment IDs and resume checkout for that campaign; do not launch a duplicate campaign. Manual fallback: use /create if you want to build or edit ads yourself.

Claim Domain & Set Payout (Publisher)

Claim your domain to start receiving payouts. Choose Stripe, USDT, or BTC.

POST /api/publishers/claim

curl -X POST https://magicads.dev/api/publishers/claim \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mysite.com", "payoutMethod": "usdt", "payoutAddress": "0x..." }'

Check Analytics

Authenticate with the private API key returned by launch, then use the session cookie to get account-scoped impressions, clicks, CTR, and spend. JSON is returned for agents to parse.

POST /api/auth/login, then GET /api/analytics

# The launch response includes account.id and account.apiKey. Keep the API key private.
curl -sS -X POST https://magicads.dev/api/auth/login \
  -H "Content-Type: application/json" \
  -c magicads-cookies.txt \
  -d '{"accountId":"YOUR_ACCOUNT_ID","apiKey":"YOUR_PRIVATE_API_KEY"}'

# The authenticated cookie scopes analytics to this advertiser account.
curl -sS -b magicads-cookies.txt 'https://magicads.dev/api/analytics?type=ads&advertiserId=YOUR_ACCOUNT_ID'

What You Can Say to Your Agent

"Add MagicAds to my website so I can earn from ad traffic"

Agent installs MagicAds, adds placements, and turns your site into inventory inside the network.

"Use MagicAds like Google Ads to get customers for my product"

Agent prepares a paused campaign and checkout. Delivery can begin after confirmed payment, when eligible publisher inventory is available.

"How are my ads performing?"

Agent signs in with the private API key and account ID, then calls account-scoped GET /api/analytics to report impressions, clicks, and CTR.

"Set up payouts for my domain"

Agent helps verify your domain, check eligible earnings, and request supported manual settlement. Choosing a preference does not connect a bank account.

"Remove MagicAds from my site"

Agent runs: curl -sL https://magicads.dev/api/install | bash -s -- --rollback

"Increase my ad budget by $50"

Add funds through a new confirmed payment for the existing campaign. Campaign balances cannot be increased by directly editing the account API.

The Agentic Google Ads Layer

Monetize inventory, buy traffic, or do both from one network. Tell your AI agent the outcome you want and let MagicAds handle the operational work.

Launch a Campaign Claim Your Domain

Stripe

USDT / BTC / MCRT

Tell Your AI Agent.Ads Just Work.