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.

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

1

Runs the install script

Auto-detects your framework

2

Injects the MagicAds script

Into your layout/index file

3

Adds a banner placement

Top banner, sidebar, or inline

4

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 pay with USDT, BTC, ETH, or Stripe. Publishers get paid in their preferred currency. 70% revenue share.

Instant & Autonomous

No human review. AI policy engine approves ads in seconds. Campaigns go live immediately. Built for speed.

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 agentic launch flow analyzes the site, builds the campaign, and pushes traffic across the network.

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",
    "autoPay": true
  }'

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

Get impressions, clicks, CTR, and spend data. JSON response — perfect for agents to parse and act on.

GET /api/analytics
curl https://magicads.dev/api/analytics?type=ads

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 launches a campaign for your URL and starts buying traffic across publisher inventory.

"How are my ads performing?"

Agent calls GET /api/analytics, parses the JSON, tells you impressions + clicks + CTR.

"Set up payouts for my domain"

Agent walks you through claiming your domain and choosing Stripe, USDT, or BTC for payouts.

"Remove MagicAds from my site"

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

"Increase my ad budget by $50"

Agent updates your campaign path without forcing you into a manual ad-ops workflow.

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.

Stripe
USDT / BTC / ETH