MCP setup

Connect ROASaurus to Codex

Add the server with codex mcp add and sign in with codex mcp login.

Set it up

  1. Run both commands below. The second opens the ROASaurus sign-in in your browser.
  2. Pick the store and allow the connection, then ask your question in Codex.
codex mcp add roasaurus --url https://app.roasaurus.com/mcp
codex mcp login roasaurus

With an API key instead

Create a named API key with the mcp scope under Store settings › API & data and send it as a bearer token. Keep it as safe as a password; revoke it there when you no longer use it.

export ROASAURUS_KEY=rsk_…
codex mcp add roasaurus --url https://app.roasaurus.com/mcp --bearer-token-env-var ROASAURUS_KEY

Then ask

  • Which campaigns made a profit last month after product costs and fees?
  • Compare Meta and Google Ads ROAS this week with last week and explain the difference.
  • Find ad sets that spend without sales and propose to pause them.

Changes are proposals in the Actions inbox unless you allowed actions:apply. Read more on the MCP server page.

Every sale, traced to the ad that earned it

Server-side tracking, profit and lifetime value in one app. 14-day free trial, no credit card.

Start your free trial →