Skip to main content
Use the Synthbrew MCP server in Codex to validate schemas, create projects, generate sources, and fetch runtime API details from chat.

​
Prerequisites

  • Codex installed
  • A Synthbrew public API key

​
Configure Codex

Add Synthbrew to ~/.codex/config.toml: 
[mcp_servers.synthbrew]
command = "npx"
args = ["-y", "@synthbrew/agent"]

[mcp_servers.synthbrew.env]
SYNTHBREW_API_KEY = "sb_api_..."
SYNTHBREW_API_URL = "https://api.synthbrew.com/api"
Restart Codex after changing the configuration.

​
Try a product prompt

Start a new chat and ask: 
Use Synthbrew to generate a schema for a SaaS analytics app with accounts, users, subscriptions, invoices, and product events. Validate it first, then create a source with 100,000 rows and give me the connection details.
Codex should validate the schema before creating resources.

​
Local package testing

Before publishing, point Codex at a local build instead of npx: 
[mcp_servers.synthbrew]
command = "node"
args = [
  "/path/to/synthbrew/packages/agent/dist/index.js"
]

[mcp_servers.synthbrew.env]
SYNTHBREW_API_KEY = "sb_api_..."
SYNTHBREW_API_URL = "http://localhost:3355/api"