Realize MCP

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). The instructions in this article use Claude; for other clients, follow the equivalent steps in your client's connector directory or MCP setup.

3 ways to connect

There are 3 ways to connect:

Add from Claude's connector directory. One click, no setup. Available in Claude and other MCP clients that offer a connector directory.
Realize plugin. Runs in Claude Code only.
Connect directly. Works with any MCP client; more technical setup.

Method I: Add from Claude's connector directory

📘
Guidelines

Quickest to set up, with no configuration.

Available in Claude (web, desktop, and Claude Code) and in other MCP clients that offer a connector directory, such as Codex, Cursor, ChatGPT, and Google Antigravity.

Realize MCP is listed in Claude's connector directory, published by Taboola. Add it once and it is ready to use in your chats.

Prerequisites:

A Claude account, or an account with another supported MCP client.
A Taboola Realize account. You authenticate through Taboola SSO on first use.

To add the connector in Claude:

Open your connector settings: in the Claude web app, go to Customize > Connectors; in the desktop app, go to Settings > Connectors.
Select the Discover tab and search for Realize.
Add the Realize MCP connector (by Taboola), then complete the Taboola SSO sign-in when prompted.

In other MCP clients, add Realize MCP from the client's own connector directory and complete the Taboola SSO sign-in.

Once connected, the Realize tools are available in your chats with no further setup.

🚧
If you connect through an MCP gateway (for example, RunLayer), contact Taboola to have the connector enabled for your gateway.

Method II: Realize plugin

📘
Guidelines

Quick to set up; the MCP connection is pre-configured.

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 III: Connect directly

📘
Guidelines

Requires slightly more configuration.

Works with any MCP client. The examples below use Claude Code and Claude Desktop. 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 realize-mcp https://mcp.realize.com/mcp

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

Claude Desktop example

For one-click setup, add the Realize MCP connector from the directory (Method I). To add the server manually instead:

Go to Settings > Connectors > Add custom connector.
Enter the name Realize MCP and the URL https://mcp.realize.com/mcp.
Select Connect and complete the Taboola SSO sign-in.

Learn more

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