Set up Sonar in Codex

A TOML block in ~/.codex/config.toml, then sign in — no API key. Once connected, Codex can look up apps, research keywords, audit ASO, mine reviews, and estimate revenue — live from the App Store and Google Play.

Add Sonar and sign in — no API key

Codex connects to the hosted Sonar server. The first time a tool needs your account, your browser asks you to sign in to Sonar — nothing to install, no key to copy. No account yet? Start a free trial. Add the hosted server to ~/.codex/config.toml, then sign in from your shell:

Hosted — sign in, no API key: ~/.codex/config.toml

Older Codex versions also need experimental_use_rmcp_client = true at the top of config.toml.

[mcp_servers.sonar]
url = "https://trysonar.app/mcp"

Then sign in

Your browser asks you to sign in to Sonar.

codex mcp login sonar

Verify it works

Start a new Codex session — the 63 sonar_* tools are listed under the sonar MCP server. Ask “What Sonar tools do you have?” to confirm.

Try this first prompt

Use Sonar to run an ASO audit on Duolingo on iOS in the US store. Summarize the score and the top 3 fixes you'd make first.

What you get back: a 0–100 ASO score with itemized checks, turned into a prioritized fix list by your AI.

Prefer an API key?

For scripts, CI, the sonar CLI or the local @sonarapp/mcp server (runs via npx, no global install). Create a key in Settings → Developers — keys start with aso_, and new accounts get 50 free credits on signup. Then replace aso_your_key_here below.

With an API key (scripts, CI, local): shell

codex mcp add sonar --env SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp

With an API key (scripts, CI, local): ~/.codex/config.toml

Older Codex versions without `codex mcp add` — add this block by hand

[mcp_servers.sonar]
command = "npx"
args = ["-y", "@sonarapp/mcp"]
env = { "SONAR_API_KEY" = "aso_your_key_here" }

Connected? Raid the prompt library.

Copy-paste prompts for keyword gaps, review mining, ASO audits, localization, and launch tracking — they work as-is in Codex. On the Indie plan, AI can even set up your workspace — add your app, link competitors, track keywords.

Open the prompt library Full MCP reference