Connect Codex

Add the Voxmin MCP server to the Codex CLI in config.toml, so Codex can make pictures, songs and karaoke with your Voxmin credits.

Codex

The Codex CLI (and the Codex IDE extension, which shares its config) connects to Voxmin's MCP server directly over HTTP, and signs in with your Voxmin account.

Before you start

A Voxmin account with some credits.
A recent Codex CLI.

codex mcp add voxmin --url https://api.voxmin.com/auth/mcp
codex mcp login voxmin

The first command adds Voxmin to ~/.codex/config.toml. The second opens your browser: log in to Voxmin if you are asked, check that the page names Codex, and choose Approve. Then start a new Codex session.

Voxmin lists Codex under AI Integrations → Connected apps. Sign out there stops it at once.

With a personal token instead

For a machine with no browser, Codex can read a personal token from an environment variable, so it never sits in the config file. Make one on AI Integrations; it starts with vxm_ and is shown only once.

Add the server to config.toml

Open ~/.codex/config.toml (create it if it does not exist) and add:

~/.codex/config.toml

[mcp_servers.voxmin]
url = "https://api.voxmin.com/auth/mcp"
bearer_token_env_var = "VOXMIN_TOKEN"

bearer_token_env_var names the environment variable Codex reads the token from; Codex sends it as Authorization: Bearer ….

Set your token

In the shell you start Codex from — or in your shell profile, so it is always set:

export VOXMIN_TOKEN="<your token>"

Start Codex

Start a new Codex session. MCP servers are connected when a session starts.

A project can carry its own .codex/config.toml, which Codex reads only for projects you trust. The same [mcp_servers.voxmin] table works there — and because the token stays in VOXMIN_TOKEN, the file is safe to commit.

Codex releases from before HTTP servers were fully supported only connected to local servers. If Voxmin never connects, update Codex. Very old releases needed experimental_use_rmcp_client = true at the top of config.toml to reach HTTP servers at all.

Check it works

Run codex mcp list. voxmin should be listed with its URL.
Inside Codex, /mcp shows the connected servers and their tools.
Ask: "What's my Voxmin balance?" Codex calls get_account and answers with your credits.

Troubleshooting

What you see	Why	What to do
Voxmin is listed but has no tools	`VOXMIN_TOKEN` is not set in the shell Codex started from	`test -n "$VOXMIN_TOKEN" && echo set` should print `set`; set it and start a new session
`401 Unauthorized`	The token is wrong, revoked or expired, or the account is suspended or deleted	Make a new token on AI Integrations and update `VOXMIN_TOKEN`
"Daily credit cap reached"	Today's spend through this token would pass the cap you set on it	Wait until midnight UTC, or make a token with a higher cap
"Not enough credits"	Your balance is lower than the tool's price	Top up on the Pricing page
`429 Too Many Requests`	More than 60 requests in a minute through this token	Wait a minute and try again
The request is refused	It did not pass Voxmin's content checks	Change the request. A refused picture is not charged

See the overview for every tool, its price and how billing works.

Lo que dicen los desarrolladores

De desarrolladores que integran la API de Voxmin en sus aplicaciones.

“Usamos los estados de trabajo para mostrar un progreso claro sin bloquear nuestra aplicación.”

Sofía R.

Desarrolladora full-stack, Buenos Aires

“La API asíncrona encaja bien con nuestra cola de trabajos y mantiene la integración sencilla.”

Irene V.

Desarrolladora backend, Madrid

“La documentación nos ayudó a validar los payloads antes de conectar nuestro procesador por lotes.”

Mateo C.

Ingeniero de plataforma, Bogotá

“Centralizar el procesamiento de audio redujo la lógica especial que manteníamos en cada cliente.”

Álvaro P.

Líder técnico, Valencia