Skip to content

Codex

Add the server to ~/.codex/config.toml:

[mcp_servers.vaif-studio]
command = "npx"
args = ["-y", "@vaifstudio/mcp"]
env = { VAIF_PROJECT_ID = "your-project-id", VAIF_API_KEY = "your-api-key" }

Or from a terminal:

Terminal window
codex mcp add vaif-studio --env VAIF_PROJECT_ID=your-project-id --env VAIF_API_KEY=your-api-key -- npx -y @vaifstudio/mcp

Run /mcp in Codex to see the server and its tools.

Variable Needed for Where it comes from
VAIF_PROJECT_ID Everything Your project ID, from the console or vaif.config.json
VAIF_API_KEY The row tools (query_rows, insert_row and the rest) and signed file links A project API key, from the project’s Overview or Project settings > API keys. get_signed_url needs a key with the storage scope
VAIF_AUTH_TOKEN Schema, SQL, storage, functions and key tools Optional. Without it, the server uses the sign-in that vaif login saved in ~/.vaif/auth.json, read again on every call
VAIF_API_URL A local or self-hosted API only Defaults to https://api.vaif.studio

Keep API keys out of files you commit.

See MCP server for the tools and what each one can change.