{
  "schema_version": "1.0",
  "agent_id": "medal-sales-agent",
  "name": "Medal.tv Sales Agent",
  "description": "PMP deal booking for Medal.tv gaming inventory. Supports Preferred Deal (PD) and Private Auction (PA) across display and outstream (OLV) channels.",
  "protocol": {
    "name": "iab-tech-lab-seller-agent",
    "specification_url": "https://github.com/IABTechLab/seller-agent",
    "based_on": [
      "OpenDirect 2.1",
      "OpenRTB 2.6"
    ],
    "transport": "https-rest-json"
  },
  "publisher": {
    "domain": "medal.tv",
    "name": "Medal.tv",
    "contact_email": "adops@medal.tv"
  },
  "capabilities": {
    "deal_types": [
      "PD",
      "PA"
    ],
    "channels": [
      "display",
      "olv"
    ],
    "pricing_models": [
      "CPM"
    ],
    "inventory_types": [
      "non_guaranteed"
    ],
    "currencies": [
      "USD"
    ],
    "ssps": [
      "index",
      "pubmatic",
      "magnite"
    ],
    "formats": {
      "display": [
        "300x250",
        "336x280",
        "728x90",
        "970x250",
        "400x300",
        "970x90"
      ],
      "outstream": [
        "outstream_video"
      ]
    }
  },
  "inventory": {
    "source": "https://medal.tv/.well-known/adagents.json",
    "last_updated": "2026-10-02T00:00:00.000Z",
    "properties": [
      {
        "property_id": "medal_desktop",
        "property_type": "desktop_app",
        "name": "Medal.tv Desktop App (Electron)",
        "channels": [
          "display",
          "olv"
        ]
      },
      {
        "property_id": "medal_web",
        "property_type": "website",
        "name": "Medal.tv Website",
        "channels": [
          "display",
          "olv"
        ]
      }
    ],
    "formats": [
      {
        "format_id": "display_300x250",
        "name": "Medium Rectangle 300x250",
        "kind": "image",
        "params": {
          "width": 300,
          "height": 250
        }
      },
      {
        "format_id": "display_336x280",
        "name": "Large Rectangle 336x280",
        "kind": "image",
        "params": {
          "width": 336,
          "height": 280
        }
      },
      {
        "format_id": "display_728x90",
        "name": "Leaderboard 728x90",
        "kind": "image",
        "params": {
          "width": 728,
          "height": 90
        }
      },
      {
        "format_id": "display_970x250",
        "name": "Billboard 970x250",
        "kind": "image",
        "params": {
          "width": 970,
          "height": 250
        }
      },
      {
        "format_id": "display_400x300",
        "name": "Video Rectangle 400x300",
        "kind": "image",
        "params": {
          "width": 400,
          "height": 300
        }
      },
      {
        "format_id": "display_970x90",
        "name": "Super Leaderboard 970x90",
        "kind": "image",
        "params": {
          "width": 970,
          "height": 90
        }
      },
      {
        "format_id": "outstream_video",
        "name": "Outstream Video 640x480",
        "kind": "video_hosted",
        "params": {
          "orientation": "horizontal",
          "aspect_ratio": "4:3",
          "min_width": 640,
          "min_height": 480,
          "duration_ms_range": [
            null,
            30000
          ],
          "containers": [
            "mp4",
            "webm"
          ],
          "min_bitrate_kbps": 1500
        }
      }
    ],
    "placements": [
      {
        "placement_id": "/22887417833/medaltv_desktop_970x250_3",
        "name": "Homepage Billboard",
        "description": "Top of homepage, first placement seen on app open. Multi-format: serves largest size that fits.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_970x250",
          "display_300x250",
          "display_336x280",
          "outstream_video"
        ],
        "tags": [
          "homepage",
          "high_impact",
          "billboard",
          "iab"
        ]
      },
      {
        "placement_id": "/22887417833/billboard-multisize",
        "name": "Leaderboard",
        "description": "Leaderboard in the desktop app. Serves 728x90 or 970x90, whichever fits.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_728x90",
          "display_970x90"
        ],
        "tags": [
          "in_product",
          "iab"
        ]
      },
      {
        "placement_id": "/22887417833/medaltv_desktop_336x280_1",
        "name": "Homepage Sidebar",
        "description": "Sidebar on the app homepage.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_300x250",
          "display_336x280",
          "outstream_video"
        ],
        "tags": [
          "homepage",
          "iab"
        ]
      },
      {
        "placement_id": "tudeserve:/22887417833/medaltv_desktop_336x280_1",
        "name": "Clip Library",
        "description": "In the user's clip library, alongside their own clips.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_300x250",
          "display_336x280",
          "outstream_video"
        ],
        "tags": [
          "library",
          "in_product",
          "iab"
        ]
      },
      {
        "placement_id": "/22887417833/medaltv_desktop_400x300_1",
        "name": "Preview Modal",
        "description": "In the clip preview window, opened from the library.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_300x250",
          "display_336x280",
          "display_400x300",
          "outstream_video"
        ],
        "tags": [
          "library",
          "in_product"
        ]
      },
      {
        "placement_id": "/22887417833/medaltv_desktop_400x300_nohouse",
        "name": "FSR Editor Right Bar",
        "description": "Right sidebar in the clip editor. User is actively engaged creating content.",
        "property_ids": [
          "medal_desktop"
        ],
        "format_ids": [
          "display_300x250",
          "display_336x280",
          "display_400x300",
          "outstream_video"
        ],
        "tags": [
          "in_product",
          "editor",
          "high_attention"
        ]
      }
    ]
  },
  "targeting": {
    "geo": {
      "field": "targeting.geo.countries",
      "description": "ISO 3166-1 country codes, upper case (e.g. [\"US\", \"GB\"])."
    },
    "signals": {
      "field": "targeting.signals",
      "description": "Medal first-party key-values. Each key is the Google Ad Manager key sent on every ad request. Categorical keys take a string or an array of allowed values. Values outside allowed_values are rejected. Users under 18 are never targetable. Same shape as AdCP package targeting.signals.",
      "keys": [
        {
          "key": "genre_interests",
          "name": "Game Genre",
          "value_type": "categorical",
          "description": "Genres of the games a user has viewed, played or clipped on Medal. First-party, from the desktop client. A user carries several genres at once. Sent on every ad request as the GAM key genre_interests. Never targetable for users under 18.",
          "allowed_values": [
            "adventure",
            "open world",
            "action",
            "shooter",
            "sandbox",
            "indie",
            "strategy",
            "competitive",
            "platformer",
            "tactical",
            "zombie",
            "fps",
            "arcade",
            "survival",
            "horror",
            "battle royale",
            "racing",
            "stealth",
            "mmo",
            "puzzle",
            "fighting",
            "rhythm",
            "moba",
            "tower defense",
            "automation",
            "metroidvania",
            "city builder"
          ]
        },
        {
          "key": "game_interests",
          "name": "Game Title",
          "value_type": "categorical",
          "description": "Game titles a user has viewed, played or clipped on Medal. First-party, from the desktop client. Over 5,700 titles; the 100 with the widest reach are listed here and the full list is available on request. Sent on every ad request as the GAM key game_interests. Never targetable for users under 18.",
          "allowed_values": [
            "roblox",
            "minecraft",
            "fortnite",
            "valorant",
            "gta-v",
            "counter-strike-2",
            "r6-siege",
            "rocket-league",
            "overwatch",
            "league-of-legends",
            "roblox-studio",
            "apex-legends",
            "peak",
            "among-us",
            "marvel-rivals",
            "geometry-dash",
            "dead-by-daylight",
            "repo",
            "phasmophobia",
            "terraria",
            "rust",
            "garrys-mod",
            "palworld",
            "call-of-duty-black-ops-7",
            "ea-sports-fc-26",
            "red-dead-2",
            "csgo",
            "vrchat",
            "osu",
            "backrooms",
            "schedule-i-free-sample",
            "ready-or-not",
            "lethal-company",
            "aim-lab",
            "war-thunder",
            "helldivers-2",
            "bloons-td-6",
            "elden-ring",
            "brawlhalla",
            "beamng",
            "deadlock",
            "fall-guys",
            "genshin-impact",
            "binding-of-isaac",
            "project-zomboid",
            "cyberpunk-2077",
            "sea-of-thieves",
            "fl-studio",
            "sons-of-the-forest",
            "arc-raiders",
            "pubg",
            "left-4-dead-2",
            "euro-truck-sim-2",
            "cod-modern-warfare-i-i",
            "geoguessr",
            "google-play-games",
            "escape-from-tarkov",
            "dayz",
            "battlefield-6",
            "tf2",
            "stardew-valley",
            "deltarune",
            "assetto-corsa",
            "raft",
            "sims-4",
            "warframe",
            "bodycam",
            "supermarket-together",
            "destiny-2",
            "ark",
            "ror-2",
            "the-finals",
            "shift-at-midnight",
            "ultrakill",
            "people-playground",
            "forza-horizon-5",
            "subnautica",
            "the-forest",
            "gang-beasts",
            "the-outlast-trials",
            "half-sword",
            "valheim",
            "content-warning",
            "baldurs-gate-3",
            "wuthering-waves",
            "honkai-star-rail",
            "teamfight-tactics",
            "backrooms-escape-together",
            "zenless-zone-zero",
            "skate",
            "arena-breakout-infinite",
            "golf-with-friends",
            "arma-reforger",
            "undertale",
            "Rematch",
            "spider-man-remastered",
            "scp-secret-laboratory",
            "marvels-spider-man-2",
            "one-armed-robber",
            "the-isle"
          ]
        },
        {
          "key": "age_range",
          "name": "Age Band",
          "value_type": "categorical",
          "description": "Age band from the birth year on the user's Medal account. Users under 18 are never targetable, and no band below 18 is offered. Sent on every ad request as the GAM key age_range.",
          "allowed_values": [
            "18-20",
            "21-24",
            "25-29",
            "30-34",
            "35-39",
            "40-44",
            "45-49",
            "50-54",
            "55-59",
            "60-64",
            "65-69",
            "70-75",
            "Over 75"
          ]
        }
      ]
    },
    "deprecated_fields": {
      "targeting.game_titles": "Use targeting.signals.game_interests. Still accepted and merged into it."
    }
  },
  "deal_types": [
    {
      "code": "PD",
      "name": "Preferred Deal",
      "pricing": "fixed_cpm",
      "guaranteed": false,
      "description": "Fixed-CPM, non-guaranteed, buyer-priority access at the product's rate-card CPM."
    },
    {
      "code": "PA",
      "name": "Private Auction",
      "pricing": "floor_cpm",
      "guaranteed": false,
      "description": "Competitive auction with the rate-card CPM as the floor price."
    }
  ],
  "auth": {
    "methods": [
      "api_key",
      "bearer"
    ],
    "key_header": "X-Api-Key",
    "bearer_header": "Authorization",
    "registration_url": "mailto:adops@medal.tv"
  },
  "endpoints": {
    "catalog": "https://medal-mcp.teemo-ltd.co.uk/api/v1/products",
    "quotes": "https://medal-mcp.teemo-ltd.co.uk/api/v1/quotes",
    "quote_by_id": "https://medal-mcp.teemo-ltd.co.uk/api/v1/quotes/{quote_id}",
    "deals": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals",
    "deal_by_id": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals/{deal_id}",
    "deal_activate": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals/{deal_id}/activate",
    "deal_pause": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals/{deal_id}/pause",
    "deal_resume": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals/{deal_id}/resume",
    "deal_cancel": "https://medal-mcp.teemo-ltd.co.uk/api/v1/deals/{deal_id}/cancel"
  },
  "deal_id_format": "medal-{pd|pa}-{YYYYMMDD}-{8chars}",
  "ssp_deal_id_prefixes": {
    "index": "IX-",
    "pubmatic": "PUBM-",
    "magnite": "MGNI-"
  }
}