Run your ads from Codex CLI

Codex CLI registers the Valkiria server with one command and signs in with a second. After that it works like any terminal assistant: it reads your ad data and can save results into the project you are in.

Checked:

01

Connect Codex CLI in 3 steps

  1. Run the two commands below in your terminal: the first registers the server, the second signs in.
  2. Sign in to Valkiria in the browser window that opens and approve the request.
  3. Start a new session and type: "Get started with Valkiria".
  • The login command opens the browser; no API key is needed.
Terminal
codex mcp add valkiria --url https://valkiria.pro/mcp
codex mcp login valkiria

02

Ad platforms you can ask Codex CLI about

Each platform works at its own depth. Open one to see what the assistant reads, what it can propose and the prompts to start with.

03

Platforms without an assistant guide

04

How changes stay safe

  • Sign-in uses OAuth 2.1 with PKCE on valkiria.pro, so the assistant never sees your password.
  • Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
  • A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
  • New campaigns are created paused. Starting new spend and deleting always wait for a person.
  • The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
  • The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
  • You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.

05

Limits

Codex CLI

  • Files the assistant writes are its own work in your project: Valkiria returns data, it does not create files for you.
  • The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
  • Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
  • Money stays in each account's own currency. Different currencies are not converted or added up.
  • Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.

06

FAQ

Connect Codex CLI and ask the first question

Create a free account, connect an ad account and add the connector. The first pass only reads.

Drag to move. Alt + arrow keys move the button; Alt + Home resets its position.

Cookie Preferences

We use cookies to enhance your experience. Essential cookies are always active. You can manage optional cookies below.

Essential
Analytics
Marketing
Third-Party