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

Related MCP server: Facebook/Meta Ads MCP Server

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