buzzer-ads-mcp

Monetize AI agent responses with contextual ads. Earn USDC instantly.

An MCP (Model Context Protocol) server that enables AI agents to earn revenue by showing contextual advertisements. Built for the Buzzer Network - the first ad network designed for AI agents.

Features

• Contextual Ad Matching: Get relevant ads based on conversation topic
• Instant USDC Payouts: 85% revenue share, paid to your wallet
• Multiple Ad Formats: Text, native markdown, or boxed image format
• Real-time Earnings: Track impressions, clicks, and revenue live
• Demo Mode: Works out-of-box without API keys for testing

Quick Start

Install

npm install -g buzzer-ads-mcp

Configure with Claude Code

Add to your ~/.claude/config.json:

{
  "mcpServers": {
    "buzzer-ads": {
      "command": "buzzer-ads-mcp",
      "env": {
        "BUZZER_PUBLISHER_ID": "your_publisher_id",
        "BUZZER_API_KEY": "your_api_key"
      }
    }
  }
}

Note: Environment variables are optional. Without them, the server runs in demo mode with sample ads.

Use in Conversations

Once configured, Claude can:

1. Get relevant ads based on conversation context
2. Track impressions when ads are shown
3. Track clicks when users engage
4. Check earnings at any time

Tools

get_contextual_ad

Get an ad relevant to the current conversation.

Parameters:

• context (required): Topic or context to match ads against
• format (optional): text, native, or image (default: native)

Example:

Context: "I'm learning about blockchain development"
→ Returns: Web3 development course ad

track_impression

Record that an ad was displayed.

Parameters:

• ad_id (required): ID from get_contextual_ad response
• impression_id (required): Impression ID from get_contextual_ad
• session_id (optional): Session identifier

track_click

Record when a user wants to visit an ad's URL.

Parameters:

• ad_id (required): Clicked ad's ID
• impression_id (required): Original impression ID
• session_id (optional): Session identifier

get_earnings

Check your current earnings.

Parameters:

• publisher_id (optional): Defaults to configured publisher

Returns:

╔══════════════════════════════════════╗
║     BUZZER NETWORK EARNINGS          ║
╠══════════════════════════════════════╣
║ Pending USDC:   $          0.005425 ║
║ Lifetime USDC:  $          0.005425 ║
╠══════════════════════════════════════╣
║ Impressions:                    12 ║
║ Clicks:                          2 ║
╚══════════════════════════════════════╝

Revenue Model

| Metric | Publisher Share | Typical Rate | |--------|----------------|--------------| | CPM (per 1000 impressions) | 85% | $5-8 | | CPC (per click) | 85% | $0.25-0.50 |

Example:

• 1000 impressions at $6 CPM = $5.10 earned
• 20 clicks at $0.35 CPC = $5.95 earned

Demo Mode

Without API credentials, the server runs in demo mode:

• Uses sample ads (Web3 course, crypto wallet, AI tools)
• Tracks impressions/clicks in-memory (session only)
• Shows realistic revenue calculations
• Perfect for testing integrations

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | BUZZER_API_URL | API endpoint | No (defaults to production) | | BUZZER_PUBLISHER_ID | Your publisher ID | No (demo mode) | | BUZZER_API_KEY | Your API key | No (demo mode) |

Getting Publisher Credentials

1. Sign up at buzzernetwork.com/publishers
2. Connect your wallet (for USDC payouts)
3. Get your Publisher ID and API Key from dashboard
4. Add to your MCP configuration

Use Cases

AI Chatbot Monetization

User: "What's the best hardware wallet?"

Agent: [Gets contextual ad for crypto security products]
       "Hardware wallets are great for security..."

       ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
       📢 Secure Your Crypto
       Hardware wallets starting at $59
       🔗 securewal.let/shop
       ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

       [Tracks impression → earns $0.0068]

Automated Content Generation

AI agents generating blog posts, newsletters, or documentation can include relevant sponsored content and earn passive revenue.

Developer Tools

AI coding assistants can suggest relevant tools, courses, or services through contextual ads.

Development

# Clone and install
git clone https://github.com/buzzer-network/buzzer-ads-mcp
cd buzzer-ads-mcp
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT - see LICENSE

Links

• Buzzer Network
• Publisher Dashboard
• Documentation
• Discord