Agentic Ads

Agentic Ads

Google AdSense for AI agents. Add 3 lines of code to your MCP server. Earn 70% of every ad click.

[Live Demo](https://agentic-ads-production.up.railway.app/health) · [Quick Start](#quick-start) · [MCP Tools](#mcp-tools-8-total) · [Self-Host](#option-3-self-host-production)

---

Quick Start

Step 1 — Register and get your API key (30 seconds):

Visit the web form: [https://agentic-ads-production.up.railway.app/dev/register](https://agentic-ads-production.up.railway.app/dev/register)

Or use the API directly:

curl -X POST https://agentic-ads-production.up.railway.app/api/register \

-H "Content-Type: application/json" \ -d '{"name": "My MCP Bot", "email": "me@example.com", "project_description": "A coding assistant that recommends dev tools"}'

Returns: { "api_key": "aa_dev_...", "mcp_url": "https://agentic-ads-production.up.railway.app/mcp" }

Step 2 — Add to your MCP client config:

{

"mcpServers": { "agentic-ads": { "url": "https://agentic-ads-production.up.railway.app/mcp", "transport": "http" } } }

Step 3 — Call `search_ads` in your agent and earn on every click:

// In your agent logic — when context is relevant

const ads = await mcp.callTool({ name: 'search_ads', arguments: { query: 'best running shoes for marathon', max_results: 1 } });

// Report events to get paid await mcp.callTool({ name: 'report_event', arguments: { ad_id: ads[0].ad_id, event_type: 'impression' } }); // User clicks → report 'click' → you earn $0.35 on a $0.50 CPC ad

That's it. You're monetizing.

---

Why This Exists

You built an amazing MCP server. Users love it. But you're not making money.

agentic-ads is the missing monetization layer for the MCP ecosystem. It's like Google AdSense, but for AI agents instead of websites.

The Problem

• 16,000+ MCP servers exist. Almost none monetize.
• Developers spend weeks building useful tools, earn $0.
• Users ask agents for product recommendations → agents scrape the web → brands can't reach them.

The Solution

Privacy-respecting contextual ads served through MCP tools. Developers earn 70% revenue share (industry-leading). Advertisers reach AI agent users. Everyone wins.

---

Revenue Calculator

Example: Your MCP server gets 10,000 queries/month where ads make sense.

At 100k queries/month with 5% CTR: $1,750/month passive income.

That's $21,000/year for adding 3 lines of code to your MCP server.

---

Detailed Integration Guide

For MCP Developers (Earn Money)

Connect the live server and start calling tools — no approval process, no minimums.

// 1. When user asks about products/services

const ads = await mcp.callTool({ name: 'search_ads', arguments: { query: 'best running shoes for marathon', max_results: 2 } });

// 2. Show relevant ad in your response (if it adds value) // 3. Report impression await mcp.callTool({ name: 'report_event', arguments: { ad_id: 'ad_xyz', event_type: 'impression' } });

// 4. If user clicks → report 'click' event // You earn $0.35 on a $0.50 CPC click (70% revenue share)

For Advertisers (Reach AI Users)

# Create campaign + ad via MCP tools

mcp.callTool({ name: 'create_campaign', arguments: { name: 'Q1 Running Shoes', total_budget: 500, pricing_model: 'cpc', bid_amount: 0.50 } });

mcp.callTool({ name: 'create_ad', arguments: { campaign_id: 1, creative_text: 'Ultraboost 24 — 30% off! Free shipping.', link_url: 'https://adidas.com/ultraboost', keywords: ['running shoes', 'sneakers', 'marathon'], category: 'footwear' } });

Monitor analytics

mcp.callTool({ name: 'get_campaign_analytics', arguments: { campaign_id: 1 } });

---

How It Works

┌─────────────┐                    ┌──────────────────┐                    ┌──────────────┐

│ Advertiser │────────────────────│ Agentic Ads MCP │────────────────────│ Your MCP │ │ (Brand/API) │ create_campaign │ Server │ search_ads │ Server │ │ │ create_ad │ │ report_event │ │ │ │ get_analytics │ - Matching │ get_guidelines │ Shows ads │ └─────────────┘ │ - Billing │ │ to users │ │ - Auth & Rate │ └──────────────┘ │ - Analytics │ └──────────────────┘

Example flow:

1. User asks your agent: "best running shoes for marathon"
2. Your agent calls search_ads → gets relevant ads ranked by bid × relevance
3. Agent shows ad naturally: "Ultraboost 24 — $126 (30% off) at Adidas.com (Sponsored)"
4. User clicks → you report click event → you earn $0.35 (70% of $0.50 CPC)

Privacy: No user tracking, no profiling, no cookies. Only contextual keyword matching.

---

Why MCP Developers Love This

1. Industry-Leading Revenue Share

70% to you, 30% to platform. Compare:

2. Zero Setup Friction

• No contracts, no minimums, no approval delays
• Register in seconds via POST /api/register → get your API key
• Add 1 MCP server to your config → start earning in 5 minutes

3. Privacy-Respecting

• No user tracking or profiling
• No cookies, no browser fingerprinting
• Only contextual keyword matching (like early Google AdWords)
• Your users' privacy stays intact

4. You Control What Ads Show

• Agent decides which ads (if any) to show
• Full user context stays local (never sent to ad server)
• Relevance threshold in your hands
• Users can opt out ("no ads please")

5. Transparent Analytics

• Real-time revenue tracking
• See exactly what you earned, when, and why
• No black-box algorithms or hidden fees

---

MCP Tools (8 Total)

For Developers (Consumer Side) — 3 Tools

For Advertisers (Publisher Side) — 5 Tools

---

Pricing Models

Choose how you want to pay (advertisers) or earn (developers):

Budget controls: Set total budget + daily caps. Auto-pause when budget exhausted.

---

Getting Your API Key

To call report_event or advertiser tools, you need an API key.

Option A — Web form (easiest):

Visit [https://agentic-ads-production.up.railway.app/dev/register](https://agentic-ads-production.up.railway.app/dev/register) and fill in your details. Your API key is displayed immediately.

Option B — API:

curl -X POST https://agentic-ads-production.up.railway.app/api/register \

-H "Content-Type: application/json" \ -d '{"name": "My MCP Bot", "email": "me@example.com", "project_description": "A coding assistant"}'

Response:

{

"developer_id": "...", "api_key": "aa_dev_...", "mcp_url": "https://agentic-ads-production.up.railway.app/mcp" }

Use the api_key in the Authorization header: Authorization: Bearer aa_dev_...

Deployed on Railway with persistent storage: The live server at agentic-ads-production.up.railway.app runs on Railway with a persistent volume — data is preserved across deploys and restarts. To self-host, use DATABASE_PATH=/data/ads.db pointing to a mounted volume.

---

Installation

Option 1: Connect to Live Server (Easiest)

Add to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):

{

"mcpServers": { "agentic-ads": { "url": "https://agentic-ads-production.up.railway.app/mcp", "transport": "http" } } }

Health check: https://agentic-ads-production.up.railway.app/health

Option 2: Local stdio (Development)

npm install -g agentic-ads

Add to MCP config

{ "mcpServers": { "agentic-ads": { "command": "npx", "args": ["agentic-ads", "--stdio"] } } }

Option 3: Self-Host (Production)

git clone https://github.com/nicofains1/agentic-ads.git

cd agentic-ads npm install && npm run build

Start HTTP server

PORT=19877 npm run start:http

Or stdio

npm run start:stdio

Flags:

node dist/server.js --http --port 19877 --db ./ads.db

Environment Variables:

PORT=19877                     # HTTP server port (alternative to --port)

DATABASE_PATH=/data/ads.db # SQLite database path (default: agentic-ads.db) AGENTIC_ADS_API_KEY=aa_dev_... # Developer API key for stdio mode

DB Persistence: Set DATABASE_PATH to a path on a persistent volume. On first run with an empty DB, demo campaigns are auto-seeded. See DEPLOY.md for full deployment guide (Railway recommended for free persistent storage).

---

Integration Examples

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "agentic-ads": { "command": "npx", "args": ["agentic-ads", "--stdio"] } } }

Cursor / Windsurf

{

"mcpServers": { "agentic-ads": { "url": "https://agentic-ads-production.up.railway.app/mcp", "transport": "http"