# Agentic Ads [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/nicofains1/agentic-ads  
**GitHub Stars:** 3  
**npm Downloads (last month):** 287  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agentic-ads

## Description
Ad network for AI agents — monetize MCP servers with contextual ads. 70% revenue share.

## Tools
Capabilities this server exposes over MCP:

- **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 Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What Agentic Ads MCP server does

Agentic Ads provides an MCP interface for contextual advertising in AI agent workflows. An MCP application can search for relevant ads, decide whether an ad belongs in a response, and report impressions, clicks, or conversions. The service describes its matching approach as contextual keyword matching rather than user tracking, profiling, cookies, or browser fingerprinting.

The Agentic Ads MCP server supports two sides of the advertising workflow. Developers integrating ads use public ad search and guideline tools plus an authenticated event-reporting tool. Advertisers use authenticated tools to create campaigns and ads, inspect performance, change campaign settings, and list campaigns.

The service documents a 70% developer revenue share. Its examples include CPC, CPM, and CPA pricing models, with campaign budgets and daily caps that can pause campaigns when funds are exhausted.

## How it works

A typical integration starts when an agent receives a product or service query. The host application sends relevant keywords or a query to `search_ads`, receives ranked results with relevance information, and chooses whether to present one. The application then calls `report_event` for an impression and can report a click or conversion when that event occurs.

Ad results are described as being ranked using bid and relevance. The integration guide recommends showing an ad only when it adds value and presenting it as sponsored content. The full user context can remain in the local application; the documented request uses contextual query information for matching.

Advertisers can create a campaign with a budget, objective, pricing model, and bid. They can then create ads with creative text, a destination URL, keywords, and a category. Analytics expose impressions, clicks, conversions, spend, and ROI.

## Setup and configuration

Register through the hosted web form or send `POST https://agentic-ads-production.up.railway.app/api/register` with a name, email, and project description. Registration returns an API key and the hosted MCP URL.

Add the endpoint to an MCP client using HTTP transport:

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

Authentication is required for `report_event` and advertiser tools; public access is listed for ad search and ad guidelines.

## Tools and capabilities

The eight documented tools are:

- `search_ads`: Find ads by query, keywords, category, or geographic criteria.
- `report_event`: Submit impression, click, or conversion events using a developer key.
- `get_ad_guidelines`: Retrieve presentation guidance.
- `create_campaign`: Create a campaign with budget and pricing settings.
- `create_ad`: Add creative content, keywords, targeting, and a link to a campaign.
- `get_campaign_analytics`: Review campaign performance and financial metrics.
- `update_campaign`: Pause, resume, or modify campaign settings.
- `list_campaigns`: List campaigns, optionally filtered by status.

The Agentic Ads MCP server is therefore relevant both to MCP developers seeking contextual monetization and to advertisers managing campaigns through agent tools.

## Limitations and notes

It does not specify client-specific setup beyond the generic HTTP MCP configuration, payout procedures, geographic availability, moderation rules, or the implementation details of event validation. Developers should also decide locally whether an ad is appropriate to show and should follow the documented guidance for identifying sponsored content.

_Full upstream README: https://allmcps.com/mcp/agentic-ads/readme_