# Agentic Ads

Manage advertising campaigns by creating ad units, setting budgets, and tracking real-time performance metrics. Search for relevant sponsored content to present to users based on their specific inten…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nicofains1/agentic-ads

# Browse available tools
npx -y @smithery/cli@latest tool list nicofains1/agentic-ads

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nicofains1/agentic-ads get_ad_guidelines

# Call a tool
npx -y @smithery/cli@latest tool call nicofains1/agentic-ads get_ad_guidelines '{}'
```

## Direct MCP Connection

Endpoint: `https://agentic-ads--nicofains1.run.tools`

## Tools (8)

- `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). Call this after showing a sponsored ad to the user.
- `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

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nicofains1/agentic-ads <tool-name>
```