Optmyzr provides a Model Context Protocol (MCP) endpoint that allows AI assistants to securely interact with your Optmyzr account through Sidekick.

With MCP, you can connect AI clients such as Claude to Optmyzr and perform the same analysis, reporting, and workflow creation that you would normally do in the Optmyzr UI.

This article explains what MCP is, how it works with Sidekick, and how to configure the Optmyzr MCP endpoint.

What is MCP?

Model Context Protocol (MCP) is a standard that allows AI assistants to connect to external tools and data sources.

Using MCP, an AI client can:

Query structured data from external systems
Execute workflows and tools
Retrieve documentation and contextual information

In the case of Optmyzr, MCP allows supported AI assistants to access Sidekick capabilities.

When Should You Use the Optmyzr MCP?

The Optmyzr MCP is useful when you want to interact with Optmyzr from an external AI assistant instead of working directly inside the Optmyzr interface.

You may find MCP helpful if you want to:

Work from your AI workspace. If you use Claude as your primary AI assistant, MCP allows you to analyze performance, generate strategies, and retrieve Optmyzr data without opening the Optmyzr platform.
Combine Optmyzr with other tools. AI assistants can combine Optmyzr data with information from other sources, such as documents, spreadsheets, or analytics platforms, to produce broader analyses.
Build AI-driven workflows. MCP enables AI assistants to chain multiple actions together, such as analyzing performance, generating a Rule Engine strategy, and creating alerts in a single interaction.
Run advanced analysis across accounts. AI assistants can retrieve data from multiple accounts and summarize trends or opportunities across your portfolio.

For many day-to-day optimization tasks, using Sidekick directly inside Optmyzr will still be the simplest option. MCP simply provides another way to access Sidekick capabilities from external AI environments.

Sidekick and MCP

Optmyzr Sidekick is Optmyzr’s AI assistant designed to help advertisers analyze performance, discover insights, and build optimization workflows.

Through MCP, the same capabilities available in the Sidekick interface inside Optmyzr can also be accessed through compatible AI clients. This means you can:

Run PPC analysis on connected ad accounts
Generate Rule Engine strategies
Retrieve performance reports
Create and review alerts
Discover relevant Optmyzr tools
Build custom AI workflows that combine multiple tasks

All actions executed through MCP interact with your Optmyzr account in the same way as using Sidekick in the UI.

You can get a full overview of Sidekick features here.

Configure the Optmyzr MCP

Before you configure the Optmyzr MCP, you'll need to generate the MCP API Key from the MCP Integration section of the Settings page in Optmyzr.

Please note that you will have to store the API key securely. It will not be shown once you leave the page. Once generated, you will be able to see when it was created and when it was last used.

You can revoke the API Key, but this will lead any connected MCP clients to lose access.

Claude Desktop

There are two configuration methods depending on your Claude plan.

Method 1: Using Connectors (Claude subscription required)

If you have a Claude subscription, you can configure MCP using Connectors.

Steps:

Open Claude Desktop
Go to Settings
Navigate to Connectors
Click Add Custom Connector*
Enter the following URL: https://tools.optmyzr.com/OptmyzrMcp
Save the connector
Restart Claude

After restarting, Claude will be able to access Optmyzr MCP functions.

*While anyone can build and host custom connectors using remote MCP, only admins or Owners in Claude can add them to Team and Enterprise plans. Once a connector has been added to a Team or Enterprise organization, users individually connect to and enable that connector.

You can read more about how to add a custom connector to your organization here.

Method 2: Manual Configuration (Free plan)

Prerequisite: Install Node.js

Before using the MCP, you may need to install Node.js on your system.

You can download Node.js directly from the official website: https://nodejs.org/en/download

We recommend using the prebuilt Node.js installer, as it is the fastest and simplest option. You’ll only need to select your operating system (Windows, macOS, or Linux), and follow the installation instructions provided.

Once installed, you’ll be ready to proceed with MCP setup.

If you are using the free version of Claude, you can configure MCP manually.

Steps:

Open Claude Desktop
Go to Settings
Navigate to Developer
Click Edit Config
Open the file: claude_desktop_config.json

Add the following configuration:

{

  "mcpServers": {

    "optmyzrMCPServer": {

      "command": "npx",

      "args": [

        "mcp-remote",

        "https://tools.optmyzr.com/OptmyzrMcp"

      ]

    }

  }

}

Save the file
Restart Claude Desktop

Claude will now be able to access Optmyzr through MCP.

Claude Code

Open your terminal

Run the following command in your terminal:

claude mcp add --transport http optmyzr https://tools.optmyzr.com/OptmyzrMcp --header "Authorization:YOUR_API_KEY"

Claude Code will now have access to Optmyzr MCP functions.

Chat GPT

Open ChatGPT
Go to Settings, then navigate to Apps, and ensure that Developer Mode is enabled.
Click on Create App.
Enter the app name as MCP and provide the following MCP server URL:
```
https://tools.optmyzr.com/OptmyzrMcp?api_key=YOUR_API_KEY
```
Set the authentication type to No Auth
Check the option I understand and want to connect
Click Create and start a new connection.

Other

MCP is an open protocol supported by many clients. Your specific client documentation can advise you on how to connect. Use the server URL https://tools.optmyzr.com/OptmyzrMcp and pass your API key in the Authorization header. For example, a client might accept the following configuration:

{   "optmyzr": {     "url": "https://tools.optmyzr.com/OptmyzrMcp",     "headers": {       "Authorization": "YOUR_API_KEY"     }   } }

Available MCP Functions

The Optmyzr MCP provides the following functions that AI clients can use to interact with your Optmyzr account.

Function	Description
get_active_accounts	Returns all active accounts connected to your Optmyzr profile.
get_ppc_report	Fetches ad account performance data based on user queries. Supports filtering, sorting, limits, and pagination for deeper analysis.
get_merchant_feed_details	Retrieves merchant feed details based on provided filter criteria.
get_configured_alerts	Fetches the latest configured alerts. Results can be filtered by account, metric, level, or alert type. Returns the latest 10 alerts by default.
get_triggered_alerts	Retrieves recently triggered alerts for the user. Can be filtered by level, entry type, and metric.
create_or_edit_alert	Creates a new alert or updates an existing alert using a valid schema payload. In edit mode, only specific fields can be modified.
re_generate_strategy_chain	Generates a complete Rule Engine strategy from a natural language description. The process creates the strategy, executes it, analyzes the results, and provides AI recommendations.
fetch_relevant_tools	Suggests relevant Optmyzr tools based on the user’s query and may also retrieve related help articles.
fetch_help_articles	Retrieves relevant Optmyzr help articles based on the user’s query.
update_language_preference	Updates the user’s language preference when they request a supported language.

Sidekick vs MCP

Both Sidekick and MCP bring AI into your Optmyzr workflow, but they’re designed for different kinds of tasks. Here’s how you can use each of them.

Use Sidekick when you want to work inside Optmyzr

Sidekick is built directly into the Optmyzr interface and understands exactly what you’re looking at. It’s your go-to when you want to analyze, learn, and take action within a tool.

Use Sidekick to:

Understand what you’re seeing on a specific page
Get tool-specific recommendations and walkthroughs
Apply changes directly (like optimizations, budgets, etc.)
Work with features tied closely to the UI (like Keyword Lasso or Rule Engine actions)
Continue conversations as you move across tools in your account

In short: Sidekick helps you do the work inside Optmyzr.

Use MCP when you want to work across tools, accounts, or platforms

MCP (Model Context Protocol) connects Optmyzr data to external AI environments (like Claude), letting you analyze and act on data more flexibly, even outside the Optmyzr UI.

Use MCP to:

Analyze and compare data across multiple accounts* at once
Work with alerts at scale (e.g., review, prioritize, or investigate patterns across accounts)
Generate reports or summaries using data pulled from multiple sources
Create workflows that go beyond Optmyzr (e.g., draft an email, share updates in Slack, or schedule follow-ups)
Combine Optmyzr data with other tools in a single workflow

*While Sidekick can help with alerts, summaries, and recommendations within a single account and tool, MCP extends this by letting you go broader and connect workflows across systems.

In short: MCP helps you think, analyze, and orchestrate workflows beyond Optmyzr.

Key Differences at a Glance

Capability	Sidekick	MCP
Works inside Optmyzr UI	✅ Yes	❌ No
Context-aware (based on current page)	✅ Yes	❌ No
Apply changes directly in tools	✅ Yes	⚠️ Not currently supported
Access UI-specific features (e.g., Keyword Lasso)	✅ Yes	❌ No
Cross-account analysis	⚠️ Limited	✅ Yes
Works with external tools (e.g., Gmail, Slack, etc.).	❌ No	✅ Yes
Automate workflows across platforms	❌ No	✅ Yes

Optmyzr Sidekick MCP - User Guide