Skip to main content
Glama
NewsBreak MCP Server

NewsBreak MCP Server

by geopopos

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

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

Available Tools

14 tools
newsbreak_create_adCreate AdA

Create a new ad within an ad set.

Args:

  • adSetId (string, required): ID of the parent ad set

  • name (string, required): Ad name

  • creative (object, required): Creative content with:

    • type: IMAGE, VIDEO, or GIF

    • headline: Ad title

    • assetUrl: URL of asset (must be uploaded to NewsBreak CDN first)

    • description: Ad description

    • callToAction: CTA button text

    • brandName: Brand name

    • coverUrl (optional): Video cover image

    • logoUrl (optional): Logo URL

    • clickThroughUrl (optional): Landing page URL

  • clickTrackingUrl (string[], optional): Click tracking URLs

  • impressionTrackingUrl (string[], optional): Impression tracking URLs

  • status (string, optional): ON or OFF. Default: ON

Returns: Created ad details including audit status

Inputs: name (required), adSetId (required), creative (required), status, +2 more.

newsbreak_create_ad_setCreate Ad SetA

Create a new ad set within a campaign.

Args:

  • campaignId (string, required): ID of the parent campaign

  • name (string, required): Ad set name

  • budgetType (string, required): DAILY or TOTAL

  • budget (number, required): Budget in cents

  • startTime (number, required): Start timestamp (Unix epoch seconds)

  • endTime (number, required): End timestamp (Unix epoch seconds)

  • bidType (string, required): CPM, CPC, TARGET_CPA, TARGET_ROAS, MAX_CONVERSION, etc.

  • bidRate (number, optional): Bid rate in cents (required for CPM, CPC, TARGET_CPA)

  • roas (number, optional): ROAS value (required for TARGET_ROAS types)

  • deliveryRate (string, optional): EVENLY or ASAP

  • trackingId (string, optional): Event tracking ID (required for conversion bid types)

  • targeting (object, optional): Audience targeting with dimensions like location, gender, ageGroup, etc.

  • schedule (object, optional): Day/hour schedule map

  • frequencyCaps (array, optional): Frequency cap settings

  • status (string, optional): ON or OFF. Default: ON

Returns: Created ad set details

Inputs: name (required), budget (required), bidType (required), endTime (required), +13 more.

newsbreak_create_campaignCreate CampaignA

Create a new advertising campaign.

Args:

  • adAccountId (string, required): ID of the ad account

  • name (string, required): Campaign name

  • objective (string, required): Campaign objective - WEB_CONVERSION, APP_CONVERSION, REACH, WEB_TRAFFIC, APP_TRAFFIC

  • status (string, optional): ON or OFF. Default: ON

Returns: Created campaign details including ID, name, objective, and status

Inputs: name (required), objective (required), adAccountId (required), status.

newsbreak_get_ad_accountsGet Ad AccountsA
Read-onlyIdempotent

Get all ad accounts for specified organizations.

Returns ad accounts grouped by organization, including account IDs, names, and creation times.

Args:

  • orgIds (string[], required): Array of organization IDs

Returns: List of organizations with their ad accounts

Inputs: orgIds (required).

newsbreak_get_adsGet AdsA
Read-onlyIdempotent

Get all ads for an ad account with optional filters.

Args:

  • adAccountId (string, required): ID of the ad account

  • search (string, optional): Search query

  • onlineStatus (string[], optional): Filter by status

  • campaignIds (string[], optional): Filter by campaign IDs

  • adSetIds (string[], optional): Filter by ad set IDs

  • pageNo (number, optional): Page number. Default: 1

  • pageSize (number, optional): Results per page. Default: 20

Returns: Paginated list of ads with creative details and status

Inputs: adAccountId (required), pageNo, search, adSetIds, +3 more.

newsbreak_get_ad_setsGet Ad SetsA
Read-onlyIdempotent

Get all ad sets for an ad account with optional filters.

Args:

  • adAccountId (string, required): ID of the ad account

  • search (string, optional): Search query

  • onlineStatus (string[], optional): Filter by status

  • campaignIds (string[], optional): Filter by campaign IDs

  • pageNo (number, optional): Page number. Default: 1

  • pageSize (number, optional): Results per page. Default: 20

Returns: Paginated list of ad sets with full details including targeting and schedule

Inputs: adAccountId (required), pageNo, search, pageSize, +2 more.

newsbreak_get_campaignsGet CampaignsA
Read-onlyIdempotent

Get all campaigns for an ad account with optional filters.

Args:

  • adAccountId (string, required): ID of the ad account

  • search (string, optional): Search query

  • onlineStatus (string[], optional): Filter by status - WARNING, INACTIVE, ACTIVE, DELETED

  • pageNo (number, optional): Page number. Default: 1

  • pageSize (number, optional): Results per page - 5, 10, 20, 50, 100, 200, 500. Default: 20

Returns: Paginated list of campaigns with details

Inputs: adAccountId (required), pageNo, search, pageSize, +1 more.

newsbreak_update_adUpdate AdB
Idempotent

Update an existing ad's content and settings.

Args:

  • adId (string, required): ID of the ad to update

  • name (string, required): New ad name

  • creative (object, optional): Updated creative content

  • clickTrackingUrl (string[], optional): Click tracking URLs

  • impressionTrackingUrl (string[], optional): Impression tracking URLs

  • status (string, optional): ON or OFF

Returns: Updated ad details

Inputs: adId (required), name (required), status, creative, +2 more.

newsbreak_update_ad_setUpdate Ad SetB
Idempotent

Update an existing ad set's configuration.

Args:

  • adSetId (string, required): ID of the ad set to update

  • name (string, optional): New ad set name

  • budgetType (string, optional): DAILY or TOTAL

  • budget (number, optional): Budget in cents

  • startTime (number, optional): Start timestamp

  • endTime (number, optional): End timestamp

  • bidType (string, optional): Bid type

  • bidRate (number, optional): Bid rate in cents

  • roas (number, optional): ROAS value

  • deliveryRate (string, optional): EVENLY or ASAP

  • targeting (object, optional): Audience targeting criteria

  • schedule (object, optional): Day/hour schedule

  • frequencyCaps (array, optional): Frequency caps

Returns: Updated ad set details

Inputs: adSetId (required), name, roas, budget, +11 more.

newsbreak_update_ad_set_statusUpdate Ad Set StatusA
Idempotent

Enable or disable an ad set.

Args:

  • adSetId (string, required): ID of the ad set

  • status (string, required): ON or OFF

Returns: Updated ad set details

Inputs: status (required), adSetId (required).

newsbreak_update_ad_statusUpdate Ad StatusB
Idempotent

Enable or disable an ad.

Args:

  • adId (string, required): ID of the ad

  • status (string, required): ON or OFF

Returns: Updated ad details

Inputs: adId (required), status (required).

newsbreak_update_campaignUpdate CampaignA
Idempotent

Update an existing campaign's name.

Args:

  • campaignId (string, required): ID of the campaign to update

  • name (string, required): New campaign name

Returns: Updated campaign details

Inputs: name (required), campaignId (required).

newsbreak_update_campaign_statusUpdate Campaign StatusA
Idempotent

Enable or disable a campaign.

Args:

  • campaignId (string, required): ID of the campaign

  • status (string, required): ON or OFF

Returns: Updated campaign details

Inputs: status (required), campaignId (required).

newsbreak_upload_assetUpload Ad AssetA

Upload an image, video, or GIF asset to NewsBreak CDN.

The returned assetUrl can then be used when creating ads.

Args:

  • assetPath (string, required): Local file path of the asset

  • adAccountId (string, required): ID of the ad account

  • saveToMediaLibrary (boolean, optional): Save to Media Library for reuse

  • mediaName (string, optional): Name for the media (required if saveToMediaLibrary=true)

Returns:

  • assetUrl: CDN URL to use in ads

  • mediaId: Media library ID (if saved)

Inputs: assetPath (required), adAccountId (required), mediaName, saveToMediaLibrary.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 14 tools

    Disambiguation4/5

    The tool hierarchy is clear—accounts, campaigns, ad sets, ads, and assets—and most tools have a distinct resource-action pairing. However, newsbreak_update_ad accepts an optional status field while newsbreak_update_ad_status exists specifically for status, creating one overlapping boundary.

    Naming Consistency5/5

    All tools follow the uniform newsbreak_<verb>_<noun> snake_case pattern, with get/create/update/update_<resource>_status used consistently across campaigns, ad sets, and ads. The naming makes the toolset predictable and easy to navigate.

    Tool Count5/5

    14 tools is well-scoped for a complete account-to-ad workflow plus asset upload, giving each entity creation, retrieval, update, and status-control coverage. There is no padding or obvious redundancy in count.

    Completeness4/5

    The core lifecycle is covered end-to-end: accounts can be listed, campaigns/ad sets/ads can be created, read, updated, and enabled/disabled, and assets can be uploaded for reuse in creative. Missing delete/archive and reporting/analytics capabilities are notable but not blocking for core campaign management.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables users to manage Uber advertising campaigns through natural language by providing access to Uber's External Ads API. Supports campaign creation, retrieval, updating, and deletion with comprehensive filtering and configuration options.
      5
      -
    • F
      license
      C
      quality
      D
      maintenance
      Enables managing Facebook ads campaigns, ad sets, ads, creatives, insights, and audience targeting via Meta's Marketing API.
      39
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables reading and writing Reddit Ads campaigns, ad groups, ads, and performance reports with tiered safety controls, using the Reddit Ads API v3.
      30
      114 npm
      1
      MIT