Agentic Ads

by nicofains1

429 downloads

Not rated

GitHub

Other
AI

About

Monetize your MCP server with contextual ads. 70% revenue share for developers. 8 tools: search_ads, report_event, create_campaign, create_ad, get_analytics, update_campaign, list_campaigns, get_ad_guidelines.

Details

Author: nicofains1
Downloads: 429
Categories: Other, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Agentic Ads

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

From the repository

Install as an MCP server via npx -y agentic-ads and add the configuration to your mcpServers object. Your agent calls search_ads with the user’s context to retrieve relevant ads, and you report impressions, clicks, or conversions using report_event.

`get_ad_guidelines`

Get formatting guidelines for how to present sponsored ads naturally in agent responses

`search_ads`

Search for relevant ads matching a user intent/context. Returns ranked sponsored suggestions.

`report_event`

Report an ad event (impression, click, or conversion). For on-chain verified campaigns, conversions require tx_hash and chain_id.

`create_campaign`

Create a new advertising campaign with budget, pricing model, and objective

`create_ad`

Create an ad unit within an existing campaign with creative text, link, and targeting

`get_campaign_analytics`

Get performance metrics for a campaign (impressions, clicks, conversions, spend)

`update_campaign`

Update an existing campaign: modify name, objective, budget, bid, or status (pause/resume)

`list_campaigns`

List all campaigns for the authenticated advertiser with summary stats

`get_developer_earnings`

Get earnings summary for the authenticated developer: total revenue, event counts, per-campaign breakdown, and period-based earnings (24h, 7d, 30d, all-time).

`register_wallet`

Register a wallet address for receiving on-chain conversion payouts. Optionally provide a signature to prove ownership (EIP-191).

`get_verification_status`

Check the verification status of a conversion event (verified, pending, or rejected).

`request_withdrawal`

Request a withdrawal of earned USDC.e to your registered Base wallet. Minimum $1.00, maximum $50.00 per request. Rate limited to 1 per hour.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "agentic ads": {
            "agentic-ads": {
                "command": "npx",
                "args": [
                    "-y",
                    "agentic-ads"
                ],
                "env": {
                    "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "agentic-ads": {
        "command": "npx",
        "args": [
            "-y",
            "agentic-ads"
        ],
        "env": {
            "AGENTIC_ADS_API_KEY": "<YOUR_API_KEY>"
        }
    }
}

Agentic Ads

Monetize your MCP server with contextual, relevant ads. The first ad network built specifically for AI agents.

How it works

1. Install: npx -y agentic-ads — works as an MCP server 2. Search ads: Your agent calls search_ads with the user's context 3. Show relevant ads: Only high-relevance ads are returned (min_relevance filtering) 4. Earn revenue: Report impressions/clicks/conversions with report_event

Revenue Share

- 70% to developers / 30% platform - Founding Publisher Program: 90/10 split for first 10 publishers (3 months)

Tools

| Tool | Description | |------|-------------| | search_ads | Find relevant ads for your user's context | | report_event | Report impressions, clicks, conversions | | create_campaign | Create advertising campaigns | | create_ad | Create ad creatives | | get_analytics | View campaign performance | | update_campaign | Modify campaigns | | list_campaigns | List all campaigns | | get_ad_guidelines | Get content guidelines |

Quick Start

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

Links

- GitHub - npm - Live API

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_ad_guidelines

search_ads

report_event

create_campaign

create_ad

get_campaign_analytics

update_campaign

list_campaigns

get_developer_earnings

register_wallet

get_verification_status

request_withdrawal

Claude Desktop / Cursor

McpServers

Agentic Ads

How it works

Revenue Share

Tools

Quick Start

Links

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`get_ad_guidelines`

`search_ads`

`report_event`

`create_campaign`

`create_ad`

`get_campaign_analytics`

`update_campaign`

`list_campaigns`

`get_developer_earnings`

`register_wallet`

`get_verification_status`

`request_withdrawal`