Overview

The Maestro Model Context Protocol (MCP) Server connects AI assistants like Claude or Gemini to the Equativ Maestro platform. It enables AI tools to retrieve real-time data and perform actions within Maestro accounts, transforming assistants from text generators into specialized media assistants.

Capabilities

The server supports:

• Deal management: search, create, update, troubleshoot, and manage budgets for deals.
• Campaign and line item management: create and manage campaigns, line items, budgets, and creatives.
• Advertiser management: create and list advertisers.
• Targeting: apply geographic, audience, semantic, content metadata, domain or app category, video, supply-path optimization (SPO), and platform targeting.
• Reporting and delivery: monitor real-time metrics, track delivery, analyze pacing, and generate custom reports with period-over-period comparisons.
• Troubleshooting: diagnose delivery issues using bid funnel analysis and estimate available open-auction inventory.

Prerequisites

• Active Maestro account
• Compatible AI clients: Claude Desktop (Pro/Team/Enterprise), Claude Code, or Gemini CLI

Authentication

OAuth (Recommended)

Automatic handling when the AI client supports OAuth for MCP.

Bearer Token

1. Request an access token from Auth0.
2. Add it to the client configuration as a header: Authorization: Bearer <your-token>.

Server URL

Transport type: HTTP

Setup

Claude Desktop

1. Go to Settings > Connectors.
2. Add a custom connector.
3. Enter the server URL: https://maestro.mcp.eqtv.io.
4. Configure authentication in the Advanced settings for bearer token.

Claude Code

claude mcp add maestro --transport http https://maestro.mcp.eqtv.io

Gemini CLI

Update ~/.gemini/settings.json as follows:

{
  "mcpServers": {
    "maestro": {
      "httpUrl": "https://maestro.mcp.eqtv.io",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Available tools

Media planning

Targeting: geographic

Targeting: audience and segments

Targeting: reference data

Targeting: video

Deal management

Activation (campaign management)

Advertiser management

Campaign management

Line item management

Creative management

Reporting and delivery

Troubleshooting

Example prompts

Media planning and targeting

• "Find audience segments for luxury car buyers."
• "What banner sizes are available?"
• "Search for publishers matching "Le Monde"."
• "Find SPO targeting options."
• "Convert a segment price from USD to EUR."

Deals

• "Show me deal 1234567."
• "Find deals for buyer Acme Corp."
• "Create a fixed-price deal at $8 CPM for buyer 12345 targeting France."
• "Pause deal 1234567."
• "Set a daily cap of 100,000 impressions on deal 1234567."

Campaigns and line items

• "Create a campaign for advertiser 100 with a $10,000 budget running in April."
• "List all active campaigns."
• "Add a line item targeting France and Germany under campaign 5678."
• "Update the daily budget on campaign 1234 to $500."

Reporting

• "How is deal 1234567 delivering this week?"
• "Show me the pacing of campaign 5678 against its targets."
• "Run a report of impressions and spend by deal for the last 7 days."
• "Compare this week's performance versus last week's for deal 1234567."

Troubleshooting

• "Why isn't deal ABC123DEF456 delivering?"
• "Check available inventory for deal 1234567."
• "Estimate open-auction inventory for US mobile CTV with sports content."

Troubleshooting