nicofains1 avatar

Agentic Ads

nicofains1/agentic-ads

Drops contextual ads into MCP workflows with a 70% revenue share for server developers. Exposes search_ads to fetch keyword-matched advertisements, report_event to track impressions and clicks for billing, and create_campaign plus create_ad for advertisers managing their spend. The matching is privacy-respecting keyword-based, no user tracking or profiling. You'd reach for this if you're monetizing a popular MCP server that surfaces product recommendations or commercial queries. Registration takes 30 seconds via their API, returns an API key, and you're earning on the next click. Also includes get_campaign_analytics for performance data and get_ad_guidelines for presentation formatting. Runs on Railway with stdio and HTTP transports.

tools
8
transport
STDIO, HTTP
last updated
Mar 4, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

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

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

No parameter schema in public metadata yet.

search_adsSearch for relevant ads matching a user intent/context. Returns ranked sponsored suggestions.6 params

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

Parameters* required
categorystring
Product/service category
geostring
Country code (e.g. "US")
keywordsarray
Explicit keywords to match against
languagestring
Language codedefault: en
max_resultsnumber
Max ads to returndefault: 3
querystring
Natural language intent (e.g. "best running shoes")
report_eventReport an ad event (impression, click, or conversion). Call this after showing a sponsored ad to the user.4 params

Report an ad event (impression, click, or conversion). Call this after showing a sponsored ad to the user.

Parameters* required
ad_idstring
The ad_id from search_ads results
context_hashstring
Hash of the message containing the ad (for verification)
event_typestring
Type of eventone of impression · click · conversion
metadataobject
Additional event metadata
create_campaignCreate a new advertising campaign with budget, pricing model, and objective8 params

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

Parameters* required
bid_amountnumber
Bid amount per event (CPM: per 1000 impressions, CPC: per click, CPA: per conversion)
daily_budgetnumber
Daily budget cap in USD
end_datestring
Campaign end date (ISO format)
namestring
Campaign name
objectivestring
Campaign objectiveone of awareness · traffic · conversions
pricing_modelstring
Pricing modelone of cpm · cpc · cpa
start_datestring
Campaign start date (ISO format)
total_budgetnumber
Total budget in USD
create_adCreate an ad unit within an existing campaign with creative text, link, and targeting7 params

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

Parameters* required
campaign_idstring
Campaign ID to attach this ad to
categoriesarray
Product/service categories
creative_textstring
Ad creative text (max 500 chars)
geostring
Target country code or "ALL"default: ALL
keywordsarray
Keywords for matching (at least 1)
languagestring
Target language codedefault: en
link_urlstring
Destination URL when user clicks the ad
get_campaign_analyticsGet performance metrics for a campaign (impressions, clicks, conversions, spend)1 params

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

Parameters* required
campaign_idstring
Campaign ID to get analytics for
update_campaignUpdate an existing campaign: modify name, objective, budget, bid, or status (pause/resume)9 params

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

Parameters* required
bid_amountnumber
New bid amount
campaign_idstring
Campaign ID to update
daily_budgetnumber
New daily budget cap in USD
end_datestring
New end date (ISO format)
namestring
New campaign name
objectivestring
New objectiveone of awareness · traffic · conversions
start_datestring
New start date (ISO format)
statusstring
New status (active to pause, paused to resume)one of active · paused
total_budgetnumber
New total budget in USD
list_campaignsList all campaigns for the authenticated advertiser with summary stats1 params

List all campaigns for the authenticated advertiser with summary stats

Parameters* required
statusstring
Filter by campaign statusone of draft · active · paused · completed

Sponsors

Readme

Agentic Ads

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

npm version Tests License: MIT MCP Node

Live Demo · Quick Start · MCP Tools · Self-Host


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

Or use the API directly:


View the full README on GitHub

Details

Repository
github.com/nicofains1/agentic-ads
Categories
Sales & Marketing, AI & LLM Tools, Finance & Commerce
Package
agentic-ads
Transport
STDIO, HTTP
Registry
MCP registry, active

More from nicofains1

Related Sales & Marketing MCP servers

View all
1nooxus-ai avatarNooxus Mcpnooxus-ai/nooxus-mcpNooxus Edge Data MCP: Search AI-verified Chinese manufacturers, eliminate B2B hallucinations.0stars
2northrosetech avatarGhl Mcp Servernorthrosetech/ghl-mcp-serverGoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.0stars
3nousulabs-debug avatarPohjola Apinousulabs-debug/pohjola-apiAgent-native API for Finnish public company data via YTJ. Pay-per-call $0.01 USDC over x402.0stars
4peterjduffy avatarParsley - Buyer Intent Signalspeterjduffy/parsley-mcpQuery buyer intent signals, MEDDIC qualifications, and lead scores from Parsley.0stars
5potarix avatarPotarix Enricherpotarix/potarix-mcpFind company websites and verified business emails through the Potarix Enricher API.0stars
6purahmanian avatarJunglescout Mcppurahmanian/junglescout-mcpJungle Scout MCP server: keyword volumes, product database, sales estimates, share of voice0stars