search_accountsLABSCO SUMMARY
Campaign management and reporting from Taboola itself, with the reporting caveats written into the tools.
The reports are the part that repays reading carefully: each has a fixed row grain, the rate metrics are computed server-side and must not be re-averaged across rows, and the summary Total is authoritative rather than the sum of pages. Reach estimation before launch is the other standout — it forecasts from targeting rather than from a campaign's history.
What it is
Taboola's MCP server for the Realize advertising API. It runs as a hosted Streamable HTTP server with OAuth 2.1, so there is nothing to install: an assistant can find an account, read or edit its campaigns and items, estimate reach before launch, and pull performance reports as CSV.
What you get
- search_accounts — the starting point for everything else; returns account_id along with currency, country and time zone so budgets and schedules are set in the right terms
- list_campaigns and get_campaign — campaigns for an account, one page per call, and one campaign's detail
- create_campaign and update_campaign — the same scalars and targeting blocks on both; scalars partial-merge, targeting blocks replace within the block, and a new campaign ships paused unless is_active is set
- get_campaign_reach_estimate — forecast impressions or monthly unique users for a hypothetical configuration, narrowing as bid and budget are added
- list_items, get_item, create_native_item and update_native_item — native creatives with headline, body, thumbnail and CTA; editability depends on state, and rejected items must be recreated
- create_display_item and update_display_item — display creatives from either a third-party ad tag with dimensions or a Realize-hosted asset URL
- search_geos, search_techno, search_publishers, search_audiences, search_lookalike_audiences, search_contextual_segments and search_conversion_rules — the valid codes for every targeting block
- list_time_zones and list_cta_types — the values activity_schedule and a native item's CTA will accept
- get_campaign_breakdown_report, get_campaign_site_day_breakdown_report, get_top_campaign_content_report and get_campaign_history_report — CSV performance by campaign, by site and day, top content, and a change log of who altered what
Requirements
A Taboola Realize account. Connect to https://mcp.realize.com/mcp as a custom connector and sign in through Taboola SSO — the OAuth 2.1 flow issues the bearer token the tools use, and the server is multi-user and stateless. Clients without native remote support can bridge with npx -y mcp-remote, which needs Node.js 18 or newer.
Setup effort
One command — claude mcp add --transport http --callback-port 3000 realize-mcp https://mcp.realize.com/mcp
USE CASES
Seeing how an advertiser is performing
Find the account, then pull the campaign breakdown for the period as CSV.
Sizing an audience before spending
Estimate impressions and monthly unique users for the targeting you are considering.
Changing a budget without touching anything else
Locate the campaign, then update only the field you mean to change.
Adding a creative to a live campaign
Confirm the valid CTA values, then create the native item with its headline, body and thumbnail.
Finding out what changed and who changed it
Read the campaign history log, which records change type, old and new value, and the performer.
25 tools
Listed in project docs. Your client may show a different list.
list_campaignsget_campaignget_campaign_reach_estimatecreate_campaignupdate_campaignlist_itemsget_itemcreate_native_itemupdate_native_itemcreate_display_itemupdate_display_itemsearch_geossearch_technosearch_audiencessearch_lookalike_audiencessearch_contextual_segmentssearch_publisherssearch_conversion_ruleslist_time_zoneslist_cta_typesget_top_campaign_content_reportget_campaign_breakdown_reportget_campaign_history_reportget_campaign_site_day_breakdown_reportBEFORE YOU INSTALL
What to know first
Tools you get
25 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
INSTALLATION
Connect your client
Server setup
claude mcp add
Claude Code
claude mcp add --transport http --callback-port 3000 realize-mcp https://mcp.realize.com/mcpHosted endpoint
https://mcp.realize.com/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Desktop — OAuth
Settings → Connectors → Add Custom Connector — URL https://mcp.realize.com/mcp, then Connect to start the OAuth 2.1 flow
Claude Desktop — npx
{
"mcpServers": {
"realize-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.realize.com/mcp",
"3000"
]
}
}
}