# Agentic Ads

Agentic Ads is an MCP server for Claude Code that serves contextual ads. Developers earn a 70% revenue share from every ad click.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: nicofains1
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nicofains1/agentic-ads
- Updated: 2026-04-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/agentic-ads

## What it does

The service adds a monetization layer to the MCP ecosystem by inserting ads based on user context. It avoids tracking or cookies, relying solely on keyword matching to present relevant offers.

To integrate, register at `https://agentic-ads-production.up.railway.app/dev/register` to receive an API key. Add the server URL `https://agentic-ads-production.up.railway.app/mcp` to your client configuration or use `npx agentic-ads` to get started.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://agentic-ads-production.up.railway.app/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http agentic-ads https://agentic-ads-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
claude mcp add agentic-ads -- npx -y agentic-ads
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add agentic-ads --url https://agentic-ads-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
codex mcp add agentic-ads -- npx -y agentic-ads
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentic-ads": {
            "url": "https://agentic-ads-production.up.railway.app/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentic-ads": {
            "command": "npx",
            "args": [
                "-y",
                "agentic-ads"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentic-ads": {
            "type": "http",
            "url": "https://agentic-ads-production.up.railway.app/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentic-ads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agentic-ads"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http agentic-ads https://agentic-ads-production.up.railway.app/mcp
```

2. **Platform CLI**
```bash
gemini mcp add agentic-ads npx -y agentic-ads
```

## When to use it
- monetize functional MCP servers
- display relevant ads in agent responses
- track ad-driven revenue in real time

## Example prompts
- Call `search_ads` with a query like 'running shoes' to fetch relevant sponsored links.
- Invoke `report_event` with type 'click' when a user selects an ad link.

## Similar
- [ads-budget](https://affpapa.org/en/nevibecode/skills/ads-budget.md) — skill · 4400 installs
- [ads-math](https://affpapa.org/en/nevibecode/skills/ads-math.md) — skill · 4100 installs
- [thought-leadership-ads](https://affpapa.org/en/nevibecode/skills/thought-leadership-ads.md) — skill · 25800 installs
- [ads](https://affpapa.org/en/nevibecode/skills/revnu-ads.md) — skill · 3400 installs
- [tiktok-ads](https://affpapa.org/en/nevibecode/skills/tiktok-ads.md) — skill · 1400 installs
- [reddit-ads](https://affpapa.org/en/nevibecode/skills/reddit-ads.md) — skill · 1200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
