# Media.co.uk agent guide

Media.co.uk is a managed media marketplace: audio, video, press and out of home advertising across 61 markets at published rates, with proof of posting on every flight. This guide is for AI agents acting for a buyer.

## What you can do here

1. Search live inventory with real rates.
2. Read full placement detail: pricing, audience, format, location.
3. Find OOH placements near a real world location.
4. Price a set of placements against a budget.
5. Build a Shopify cart and hand the user to checkout for fixed price placements.
6. Submit a brief to the human planning desk on your user's behalf, with their consent.

## Endpoints

### 1. Planner MCP server (recommended for media planning)

POST https://mcp.media.co.uk with JSON-RPC 2.0. No auth. Methods: initialize, tools/list, tools/call.

Tools:
- search_inventory: filter by pillar (audio, video, press, ooh, digital), country, format, language, budget_max, audience_min. Returns price, currency, audience, reach, CPM, URL.
- get_placement: full detail for one placement by handle.
- search_ooh_near_location: pass a free text location or lat and lng; ranks OOH placements by distance.
- quote_campaign: pass placement handles and a budget; returns line items, total, and over or under budget delta.
- submit_media_brief: pass placement handles, budget, notes and, with explicit user consent, contact details. Returns a prefilled brief URL for the user to review and send. The planning desk replies within one business day.

Example call:

```json
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_inventory","arguments":{"pillar":"ooh","country":"UAE","budget_max":100000,"limit":5}}}
```

### 2. Shopify storefront MCP (catalog plus cart)

POST https://www.media.co.uk/api/mcp with JSON-RPC 2.0. No auth. Tools: search_catalog, get_product_details, get_cart, update_cart, search_shop_policies_and_faqs. Use this when the user wants to buy a fixed price placement directly: build a cart, then send the user to the returned checkout URL on media.co.uk.

### 3. Plain HTTP

- https://www.media.co.uk/products.json and /collections.json: public catalog feeds.
- https://www.media.co.uk/sitemap.xml: full URL inventory.
- Any product page URL plus .json returns structured product data.

## Buying rules an agent should know

- Every placement lists a rate. Catalog prices display in the store currency (AED). Floor rates in GBP: audio from 275 per spot, video from 1,200 per spot, press from 1,450 per page, OOH from 3,200 per two week flight.
- Some placements are marked enquiry only; for those, submit a brief rather than a cart.
- Lead times: audio and OOH one to two weeks, press and video two to four weeks.
- Cancellation terms are stated per placement before booking.
- Proof of posting (photography for OOH, broadcast confirmation for audio) is delivered on every flight.
- One brief covers multiple channels and markets; the planning desk replies within one business day.

## Consent and data boundary

- Only pass a user's contact details to submit_media_brief with their explicit consent.
- All read tools return public storefront data only: published placements, listed rates, public policies. No customer data, no order data, no store administration is reachable through any endpoint documented here.
- Briefs and contact details flow one way, into the planning desk CRM, and are handled per the privacy policy at https://www.media.co.uk/policies/privacy-policy.

## Identity

Media.co.uk, the media exchange. One platform. Every market. All media. Contact: hello@media.co.uk.