Overview

Realize MCP brings your Realize advertising data into AI tools through the Model Context Protocol (MCP). Analyze campaigns, pull performance reports, and work with the Realize API in natural language, without leaving the chat.

📘
Which AI client?
The Realize MCP server works with any MCP-compatible AI client (such as Claude, Cursor, Codex, or Gemini). Instructions are provided in this article for Claude Code.

2 ways to connect

There are 2 ways to connect:

Realize plugin. The simplest path. Runs in Claude Code only.
Connect directly. Works with any MCP client; more technical setup.

Method I: Realize plugin

📘
Guidelines

Quickest to set up.

The plugin runs in Claude Code only.

The plugin adds ready-made skills to Claude Code, with the Realize MCP connection pre-wired.

Prerequisites:

Claude Code installed.
A Taboola Realize account. You authenticate through Taboola SSO on first use.

To install, follow the steps in the plugin's README: https://github.com/taboola/realize-claude-plugin

Authentication is handled through Taboola SSO on the first tool call, with no separate MCP setup.

Method II: Connect directly

📘
Guidelines

Requires slightly more configuration.

Works with any MCP client. The examples below use Claude Code; for other clients, follow the same pattern using your client's own MCP setup documentation.

Connect an MCP client to the hosted server at https://mcp.realize.com/mcp (streamable HTTP, OAuth 2.1). There is no local install.

Prerequisites:

A Taboola Realize account. You authenticate through Taboola SSO on first use.
Network access to the endpoint.

Claude Code example

claude mcp add --transport http --callback-port 3000 realize-mcp https://mcp.realize.com/mcp

On the first tool call, a browser window opens for Taboola SSO.

Claude Desktop example

Claude Desktop works today with the manual configuration below. One-click support from Claude Desktop's connector settings is expected soon.

Add the server to your claude_desktop_config.json (requires Node.js 18 or later):

{
  "mcpServers": {
    "realize-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.realize.com/mcp", "3000"]
    }
  }
}

Learn more

Realize MCP server: https://github.com/taboola/realize-mcp
Realize Claude plugin: https://github.com/taboola/realize-claude-plugin