Back to Guides
MCP setup guide

How to Create Your Waitlist with Codex

Configure the UseWait MCP server in OpenAI Codex CLI via config.toml and let the agent create a production waitlist: page, slug, emails, assets, and domain guidance.

OpenAI's Codex CLI can drive external services through MCP, and UseWait ships a server built exactly for that. Once registered in config.toml, Codex can stand up a complete waitlist from a single instruction: it names it, claims a slug, writes the page code, and can attach a confirmation email. This guide covers how to create your waitlist with Codex step by step.

Set up your waitlist with Codex

1

Create your API key

Sign up at usewait.com (free) and create a key under Dashboard, Settings, API Keys. Keys look like uw_live_... and are shown a single time, so store it somewhere safe.

2

Register the server in config.toml

Codex launches MCP servers as local processes, so the config uses the mcp-remote bridge to reach UseWait's hosted HTTP endpoint with your key in the Authorization header. Add the block below to ~/.codex/config.toml and start a new Codex session.

~/.codex/config.toml
[mcp_servers.usewait]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://usewait.com/api/mcp/mcp",
  "--header",
  "Authorization: Bearer uw_live_YOUR_KEY",
]
3

Give Codex the brief

Prompt something like: "Use the usewait tools to create a waitlist for my newsletter about embedded systems. Short slug, minimal dark page, confirmation email included." Codex pulls get_started for the flow and get_page_format for the page contract, then executes. The URL it returns is live immediately.

4

Extend it

From the same session Codex can upload a logo to the CDN and set it as the Open Graph image, tune referral boosts, or run custom-domain setup, which hands you the A record to configure and finishes once DNS resolves.

What Codex handles for you

Picks and claims a unique slug
Writes page code matched to your brand
Creates the confirmation email template
Uploads logos and images to the CDN
Walks you through custom domain DNS
Reads signups and referral stats on demand

Frequently asked questions

Is MCP access included in the free plan?

Yes. All plans have full API and MCP access; only specific capabilities like custom domains or external databases depend on the plan.

Why mcp-remote instead of a plain URL?

Codex CLI configures MCP servers as commands it spawns. mcp-remote is a small bridge that connects that local process to UseWait's remote streamable-HTTP endpoint and forwards the auth header.

What is in the toolset?

25 tools: waitlist create/update/delete, list entries, page-code and email-template contracts, CDN asset uploads, custom domains, Turnstile keys, and bring-your-own-database management.

Can I mix Codex with plain HTTP calls?

Sure. The same uw_live_ key authenticates the REST API at usewait.com/api/v1, so scripts and the agent can share one credential.

Get your API key and let Codex launch it

Free plan includes full API and MCP access. Your agent does the rest.

Create your free API key

Full reference at docs.usewait.com and a quick overview on the developers page.