Question 1

How do I add Neobrutalism MCP to OpenAI Codex?

Accepted Answer

Open or create ~/.codex/config.toml and add an [mcp_servers.neobrutalism] table with url set to your registry endpoint including the token (same URL as on your dashboard MCP tab). Save, then start a new Codex session (CLI or IDE). Run `codex mcp list` and confirm `neobrutalism` is connected.

Question 2

Does one Codex config cover both the CLI and the IDE extension?

Accepted Answer

Yes. Codex CLI and IDE surfaces read the same ~/.codex/config.toml, so one `[mcp_servers.neobrutalism]` entry applies everywhere you run Codex.

Question 3

How do I verify Neobrutalism MCP from Codex?

Accepted Answer

Run `codex mcp list` for connection status, then ask: “search the neobrutalism registry for testimonial blocks.” Codex should call search_items and return real slugs.

Question 4

Codex can’t connect or times out on Neobrutalism MCP — what now?

Accepted Answer

401: token wrong — re-copy from Dashboard → Account. 403: not Pro yet. Timeouts on slow networks: add `startup_timeout_ms = 40_000` (or higher) to the `[mcp_servers.neobrutalism]` table, then retry. Confirm the URL uses https and includes `?token=`.

Question 5

Where should I put secrets for Codex MCP?

Accepted Answer

The registry token goes in the URL (or an env expansion if your Codex version supports it). Keep config.toml out of shared repos when it contains a real token; prefer a user-level file in your home directory.

Question 6

Do I need Pro for Neobrutalism MCP in OpenAI Codex?

Accepted Answer

Yes — Codex only unlocks Pro block tools when the Neobrutalism account is Pro. No token → 401; token without Pro → 403. Upgrade, keep the same url in config.toml, start a new session (or `codex mcp list`).

Question 7

Where do I get the token for Codex’s mcp_servers URL?

Accepted Answer

Dashboard → Account — same personal registry token as Pro shadcn CLI installs.

Question 8

Is it safe to store the token in ~/.codex/config.toml?

Accepted Answer

It’s a personal, revocable, read-scoped secret in your user config (not the project tree). Rotate it from the dashboard if it leaks; don’t paste it into a team-shared config.toml.

Question 9

Can my team each use Neobrutalism MCP with Codex?

Accepted Answer

Team/Org Pro seats each get their own token. Every developer adds their own `[mcp_servers.neobrutalism]` entry — one secret per person.

Question 10

What can OpenAI Codex do with Neobrutalism MCP?

Accepted Answer

Search the catalog, inspect real component and Pro block source, open previews, and produce token-ready install commands from the CLI or IDE — same registry as this site.

Question 11

How is this different from free shadcn MCP or Codex without MCP?

Accepted Answer

Without MCP, Codex only has your repo and built-in tools. Free shadcn MCP is local and free-components-only. Neobrutalism MCP is hosted Pro access to blocks, source, previews, and install URLs.

Question 12

Can Codex install a Pro block into my project?

Accepted Answer

Yes. Ask for a block; Codex calls get_install_command and returns a `shadcn add` line with your token embedded. Run it in the project to install for your backend.

Question 13

CLI vs IDE — does Neobrutalism MCP behave the same?

Accepted Answer

Same server and tools. Both surfaces read ~/.codex/config.toml, so discovery and install-command flows match; only the chat UI differs.

Question 14

Which backend does Codex receive — Base UI, Radix, or React Aria?

Accepted Answer

Ask for the backend you use (default Base UI). Source is flattened before return to match a normal shadcn install.

The Neobrutalism MCP serverin OpenAI Codex

One command
to connect

Works with Your Favorite
AI Agent

OpenAI Codex setup
FAQ