Agentic Protocol v1.0

Tell Your AI Agent.
Ads Just Work.

MagicAds is the first ad network built for AI agents. Whether you use Cursor, Codex, Replit Agent, Claude, ChatGPT, or any coding assistant — just tell it to add MagicAds. One sentence. Done.

How It Works With Your AI Agent

You don't need to read docs, sign up, or configure anything. Just describe what you want in plain English to your AI coding assistant.

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
Add MagicAds monetization to this project. 
Install: curl -sL https://magicads.dev/api/install | bash
The script auto-detects Next.js, Vite, Nuxt, or plain HTML.

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

Create Ad Campaign (Advertiser)

Launch a campaign across the MagicAds network. Your ad appears on all publisher sites immediately.

POST /api/ads
curl -X POST https://magicads.dev/api/ads \
  -H "Content-Type: application/json" \
  -d '{
    "creative": {
      "brandName": "My App",
      "headline": "Ship faster with AI",
      "cta": "Try Free",
      "colors": { "primary": "#6366f1" }
    },
    "budget": { "totalCents": 5000 },
    "destinationUrl": "https://myapp.com"
  }'

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 ads to my website to make money"

Agent runs the install script, injects MagicAds, you earn 70% of ad revenue.

"Create an ad campaign for my product"

Agent calls POST /api/agent/launch with your URL, campaign goes live instantly.

"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 calls POST /api/publishers/claim with your wallet address. Payouts start flowing.

"Remove MagicAds from my site"

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

"Increase my ad budget by $50"

Agent calls the ads API to top up your campaign. No dashboard needed.

The Ad Network That Speaks API

No dashboards. No account managers. No waiting for approval. Tell your AI agent what you want, and MagicAds handles the rest.

Stripe
USDT / BTC / ETH