Skip to content
MCP Server Directory logo
developer-tools

Realize Mcp

Reviewed overview

MCP サーバー概要

What is the project about? Realize MCP Server is an MCP-compatible Streamable HTTP server that provides read/write access to Taboola’s Realize API. It lets AI assistants and MCP clients analyze advertising accounts, retrieve performance data, generate reports, and manage campaigns and creatives via natural language. The server is hosted, multi-user, stateless, and uses OAuth 2.1 for authentication.

How to use the project?

  • Connect an MCP client using the Streamable HTTP transport to the server URL (for example https://mcp.realize.com/mcp) and complete the OAuth 2.1 flow via Taboola SSO.
  • Examples: add as a custom connector in Claude Desktop (UI or config file) or use Claude Code/CLI with the provided ‘claude mcp add’ command. No local install required; a config option uses npx to run an MCP remote helper.
  • Workflow: always call search_accounts first to obtain account_id, then call campaign/item/report endpoints with that account_id.

Key features

  • MCP-compatible Streamable HTTP server with OAuth 2.1 authentication
  • Account discovery and management (search_accounts)
  • Full campaign lifecycle: list, get, create, update, reach estimates
  • Item (creative) management: create/update native and display items with validation and edit rules
  • Discovery endpoints to populate targeting (geos, OS/browser, audiences, publishers, lookalikes, contextual segments)
  • Reporting endpoints that return CSV with headers, pagination, sorting, server-side precomputed metrics, and authoritative totals
  • Tools designed for safe AI-driven workflows (stateless, multi-user)
  • Licensed under Apache 2.0; source and issues on GitHub

Use cases

  1. Let an LLM analyze account performance and return CSV or human-readable summaries.
  2. Generate scheduled or ad-hoc campaign performance reports (CSV) for finance/analytics teams.
  3. Update campaign budgets, bidding, and scheduling via natural-language agents.
  4. Create or update creatives (native/display) programmatically from an AI assistant.
  5. Estimate reach for hypothetical campaigns before launch.
  6. Populate targeting options by querying discovery endpoints for valid codes and audiences.

FAQ

  • How do I connect my client? Use Streamable HTTP to the MCP server URL and complete the OAuth 2.1 flow (Taboola SSO). Examples provided for Claude Desktop (UI or config) and Claude Code (CLI).

  • Do I need to install anything locally? No. The hosted Realize MCP server supports multi-user access without local installation. Some client-side helpers (npx) are optional for config-as-code setups.

  • What authentication is required? OAuth 2.1 via Taboola SSO; the client obtains a bearer token used by Realize tools.

  • What format do reports use? CSV with a summary header. Each report documents its row grain; totals in the summary line are authoritative.

  • Are metrics precomputed or should I recompute rates? Metrics like ctr, cpc, cpm, cpa, cvr, roas are computed server-side and should be read as-is. Sum only raw counters (clicks, impressions, spent) when aggregating.

  • How do I find an account to operate on? Always call search_accounts with a numeric ID or text query to obtain account_id values; do not use numeric IDs directly.

  • Can AI agents modify campaigns and creatives? Yes. The server exposes create/update endpoints for campaigns and items; editability rules apply depending on item/campaign state.

  • Where can I get support or report bugs? Open an issue at github.com/taboola/realize-mcp/issues.

  • What is the license and data handling policy? Apache License 2.0. Data access respects Taboola’s privacy policy and only returns data to the connected MCP client.