Try now →

Connect Wonda to Codex

Add Wonda to OpenAI Codex as an MCP server so it can act through your social personas.

You may not need this

Codex is the one assistant with a second way in: it runs in a terminal, so it can drive Wonda by shelling out to the wonda binary directly, the way Claude Code does. Sign in once:

wonda auth login

After that Codex can use Wonda with no connector at all. Adding the MCP server below is still worth doing if you want Codex to drive Wonda on a different computer than the one you are working on.

Add the server

In Codex, open Plugins, then MCPs, and click + Add Server. Name it Wonda, set Type to Streamable HTTP, and paste this into URL, leaving every other field empty:

https://api.wondercat.ai/mcp

Save, then sign in to Wonda and approve access. Done once, works forever.

Prefer the terminal?

Add this to ~/.codex/config.toml:

[mcp_servers.wonda]
url = "https://api.wondercat.ai/mcp"
oauth_resource = "https://api.wondercat.ai/mcp"

Replace any existing [mcp_servers.wonda] block rather than pasting a second copy - Codex rejects the whole file if the key appears twice. Then grant Codex access to the server:

codex mcp login wonda

That is a different thing from wonda auth login above: wonda auth login authenticates the CLI, while codex mcp login completes the OAuth grant for the MCP server you just configured.

Verify

Ask Codex:

Use Wonda to tell me which personas I have.

If it lists your personas, the connection works. If it reports none, connect a persona first - see Personas and Sessions.

Approvals

Read tools are safe to allow broadly: they have zero write slots and only retrieve data. Write tools request server-side write slots and should stay ask-first unless you deliberately want a hands-off loop.

Codex's approval setting is a client-side prompt. Wonda still enforces the action gate, write-slot allowance, daily caps, cooldowns, account status, and safety checks server-side, so allowing a tool in Codex does not raise those limits.

Prefer plain HTTP?

Codex can also call the Wonda API directly with an API key, without MCP. The tools are a convenience wrapper over the same endpoints - see Running Platform Actions.

Related