NewsBreak MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NewsBreak MCP Server Create a campaign named Summer Sale"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfiguration
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.jsAs an HTTP MCP Server
TRANSPORT=http PORT=3000 npm startClaude 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 |
| Get all ad accounts for specified organizations |
Campaign Tools
Tool | Description |
| Create a new campaign |
| List campaigns with optional filters |
| Update campaign name |
| Enable/disable a campaign |
Ad Set Tools
Tool | Description |
| Create a new ad set with targeting and budget |
| List ad sets with optional filters |
| Update ad set configuration |
| Enable/disable an ad set |
Ad Tools
Tool | Description |
| Create a new ad with creative content |
| List ads with optional filters |
| Update ad content and tracking |
| Enable/disable an ad |
Asset Tools
Tool | Description |
| 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 |
| Geographic targeting |
|
| Gender targeting |
|
| Age group targeting |
|
| Language targeting |
|
| Interest targeting | Category IDs or |
| Operating system |
|
| Device manufacturer |
|
| Mobile carrier | Carrier codes or |
| Network type |
|
Each dimension can have positive (include) and negative (exclude) arrays.
Bid Types
Bid Type | Description | Required Fields |
| Cost per 1000 impressions |
|
| Cost per click |
|
| Target cost per acquisition |
|
| Target return on ad spend |
|
| Maximize conversions |
|
| Maximize conversion value |
|
API Reference
This MCP server wraps the NewsBreak Advertising API.
License
MIT
Available Tools
14 toolsnewsbreak_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 AccountsARead-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 AdsARead-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 SetsARead-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 CampaignsARead-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 AdBIdempotent
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 SetBIdempotent
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 StatusAIdempotent
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 StatusBIdempotent
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 CampaignAIdempotent
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 StatusAIdempotent
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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Manage Reddit advertising across accounts, campaigns, ad groups, posts, and ads. List accounts, fu…
Manage Unity Ads Acquire campaigns, budgets, bids, creatives and performance reports, etc.
Every public ad library in one API — 12 platforms, plus the ads that got removed.
Create AI images and videos, manage projects and credits, and use workspace campaign context.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables 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-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables programmatic access to Meta Ads data and management features, including campaign insights, ad account details, performance metrics, and change history through the Meta Ads API.-
- FlicenseCqualityDmaintenanceEnables managing Facebook ads campaigns, ad sets, ads, creatives, insights, and audience targeting via Meta's Marketing API.39-
- AlicenseAqualityCmaintenanceEnables reading and writing Reddit Ads campaigns, ad groups, ads, and performance reports with tiered safety controls, using the Reddit Ads API v3.30114 npm1MIT