NewsBreak MCP Server

NewsBreak MCP Server

An MCP (Model Context Protocol) server that wraps the NewsBreak Advertising API, allowing you to manage advertising campaigns, ad sets, and ads programmatically.

Features

Campaign Management

• Create Campaign - Create new advertising campaigns with objectives like WEB_CONVERSION, APP_CONVERSION, REACH, WEB_TRAFFIC, APP_TRAFFIC
• Get Campaigns - List and search campaigns with filters
• Update Campaign - Modify campaign names
• Update Campaign Status - Enable/disable campaigns (ON/OFF)

Ad Set Management

• Create Ad Set - Create ad sets with targeting, budgets, schedules, and bid strategies
• Get Ad Sets - List and filter ad sets by campaign, status, etc.
• Update Ad Set - Modify ad set configuration including targeting, budget, and schedule
• Update Ad Set Status - Enable/disable ad sets

Ad Management

• Create Ad - Create ads with creative content (images, videos, GIFs)
• Get Ads - List and filter ads by campaign, ad set, or status
• Update Ad - Modify ad content and tracking URLs
• Update Ad Status - Enable/disable ads

Asset Management

• Upload Asset - Upload images, videos, or GIFs to NewsBreak CDN for use in ads

Installation

cd newsbreak-mcp-server
npm install
npm run build

Configuration

Set the following environment variable:

export NEWSBREAK_ACCESS_TOKEN="your-access-token-here"

To get an access token, follow the NewsBreak API authentication process in the NewsBreak Ad Manager.

Usage

As a stdio MCP Server (default)

npm start
# or
node dist/index.js

As an HTTP MCP Server

TRANSPORT=http PORT=3000 npm start

Claude Desktop Configuration

Add to your Claude Desktop configuration file (~/.config/claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "newsbreak": {
      "command": "node",
      "args": ["/path/to/newsbreak-mcp-server/dist/index.js"],
      "env": {
        "NEWSBREAK_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Available Tools

Account Tools

Campaign Tools

Ad Set Tools

Ad Tools

Asset Tools

Example Usage

Create a Campaign

{
  "tool": "newsbreak_create_campaign",
  "arguments": {
    "adAccountId": "123456789",
    "name": "Summer Sale Campaign",
    "objective": "WEB_CONVERSION"
  }
}

Create an Ad Set with Targeting

{
  "tool": "newsbreak_create_ad_set",
  "arguments": {
    "campaignId": "987654321",
    "name": "Women 25-44 Ad Set",
    "budgetType": "DAILY",
    "budget": 5000,
    "startTime": 1700000000,
    "endTime": 1735793459,
    "bidType": "TARGET_CPA",
    "bidRate": 1000,
    "trackingId": "event123",
    "targeting": {
      "gender": { "positive": ["female"] },
      "ageGroup": { "positive": ["25-30", "31-44"] },
      "location": { "positive": ["all"] }
    }
  }
}

Create an Ad

{
  "tool": "newsbreak_create_ad",
  "arguments": {
    "adSetId": "111222333",
    "name": "Summer Sale Banner",
    "creative": {
      "type": "IMAGE",
      "headline": "Summer Sale - 50% Off!",
      "assetUrl": "https://static.particlenews.com/nova/assets/123/image.jpg",
      "description": "Shop our biggest sale of the year",
      "callToAction": "Shop Now",
      "brandName": "MyBrand",
      "clickThroughUrl": "https://example.com/summer-sale"
    }
  }
}

Targeting Options

The ad set targeting supports the following dimensions:

Each dimension can have positive (include) and negative (exclude) arrays.

Bid Types

API Reference

This MCP server wraps the NewsBreak Advertising API.

License

MIT