MCP server for Taboola's Realize API - campaign analysis and reporting
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"realize-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Realize MCP Server A Model Context Protocol (MCP) server that provides read-only access to Taboola's Realize API, enabling AI assistants to analyze campaigns, retrieve performance data, and generate reports through natural language. [](https://opensource.org/licenses/Apache-2.0) [](https://python.org) [](https://modelcontextprotocol.io/) [![Latest Version][mdversion-button]][md-pypi] [mdversion-button]: https://img.shields.io/pypi/v/realize-mcp.svg [md-pypi]: https://pypi.org/project/realize-mcp/ ## Quick Start ### Cursor IDE Setup Add to Cursor Settings → Features → Model Context Protocol: ```json { "mcpServers": { "realize-mcp": { "command": "realize-mcp-server", "env": { "REALIZE_CLIENT_ID": "your_client_id", "REALIZE_CLIENT_SECRET": "your_client_secret" } } } } ``` ### Claude Desktop Setup Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "realize-mcp": { "command": "realize-mcp-server", "env": { "REALIZE_CLIENT_ID": "your_client_id", "REALIZE_CLIENT_SECRET": "your_client_secret" } } } } ``` ### Installation ```bash pip install realize-mcp ``` ### Setup ```bash # Set credentials export REALIZE_CLIENT_ID="your_client_id" export REALIZE_CLIENT_SECRET="your_client_secret" ``` ## Basic Usage ``` User: "Show me campaigns for Marketing Corp" AI: 1. Searches accounts for "Marketing Corp" 2. Retrieves campaigns using the found account_id 3. Returns campaign list with performance metrics ``` **Important**: All operations require getting `account_id` values from `search_accounts` first - never use numeric IDs directly. ## Available Tools ### 🔍 Account Management - `search_accounts` - **[REQUIRED FIRST]** Find accounts and get account_id values…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.