Skip to main content

Documentation Index

Fetch the complete documentation index at: https://synthbrew.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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"