OpenX MCP Server recipes

This page answers which tools to call, in which order, for the most common tasks.

Answer a question from a saved query

1. get_workspace with kinds: ["WarmQueries"] to find the query that answers it.
2. call_api with route "" to find that query's route.
3. call_api on the route, such as "GET /warm-queries/signups-per-hour".

Check how a part is doing

1. get_workspace to find the part's kind and lookup.
2. get_stats with that kind and lookup, and metrics: true for numbers over time.
3. retrieve_inventory for the same lookup when the question is where it runs or whether it drifted.

Check how a workspace's licences are selling

1. get_stats for the Licenses line: each licence's Stripe health Status and problem codes.
2. call_api on "GET /licenses/health" when a status is not Healthy, for the checks behind it, and on "GET /licenses/events" to see which Stripe events arrived and how many were refused.
3. call_api on "GET /licenses/stats" for the figures and on "GET /licenses/subscribers" for who holds which plan. Each needs its own right (Licenses.Stats.Read, Licenses.Manage); a refusal names the right in MissingRights. A licence that could not be read says Known: false: report "could not be read", never zero.

Propose a new data connection

1. get_workspace with kinds: ["DataConnections"] and includeGuides: true for the guide, schema and examples.
2. manage_proposals with checkOnly: true and the proposal. Fix each refusal by its remedy.
3. manage_proposals without checkOnly to propose it. A person accepts it in the portal.

Try a draft warm query

1. call_api on "POST /warm-queries" with the draft and CheckOnly: true to check it.
2. call_api on "POST /warm-queries" with the draft to run it once without saving.
3. manage_proposals to propose saving it.

Find something in the docs

1. browse_docs with paths: ["./"] to see the top level.
2. browse_docs with a listed path and a query to search inside it.
3. browse_docs with a hit's path to read the page.