NewsBreak 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

Tool	Description
newsbreak_get_ad_accounts	Get all ad accounts for specified organizations

Campaign Tools

Tool	Description
newsbreak_create_campaign	Create a new campaign
newsbreak_get_campaigns	List campaigns with optional filters
newsbreak_update_campaign	Update campaign name
newsbreak_update_campaign_status	Enable/disable a campaign

Ad Set Tools

Tool	Description
newsbreak_create_ad_set	Create a new ad set with targeting and budget
newsbreak_get_ad_sets	List ad sets with optional filters
newsbreak_update_ad_set	Update ad set configuration
newsbreak_update_ad_set_status	Enable/disable an ad set

Ad Tools

Tool	Description
newsbreak_create_ad	Create a new ad with creative content
newsbreak_get_ads	List ads with optional filters
newsbreak_update_ad	Update ad content and tracking
newsbreak_update_ad_status	Enable/disable an ad

Asset Tools

Tool	Description
newsbreak_upload_asset	Upload image/video/GIF to NewsBreak CDN

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:

Dimension	Description	Example Values
location	Geographic targeting	"all", state/city codes
gender	Gender targeting	"male", "female", "all"
ageGroup	Age group targeting	"18-24", "25-30", "31-44", "45-54", "55+"
language	Language targeting	"en_us", "es", etc.
interest	Interest targeting	Category IDs or "all"
os	Operating system	"android@5", "ios@14"
manufacturer	Device manufacturer	"apple", "samsung", "all"
carrier	Mobile carrier	Carrier codes or "all"
network	Network type	"wifi", "5g", "4g"

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

Bid Types

Bid Type	Description	Required Fields
CPM	Cost per 1000 impressions	bidRate
CPC	Cost per click	bidRate
TARGET_CPA	Target cost per acquisition	bidRate, trackingId
TARGET_ROAS	Target return on ad spend	roas, trackingId
MAX_CONVERSION	Maximize conversions	trackingId
MAX_CONVERSION_VALUE	Maximize conversion value	trackingId

API Reference

This MCP server wraps the NewsBreak Advertising API.

License

MIT