server

Starts the HTTP API server. The server loads databases and methods on startup according to your config, then exposes the HTTP API and MCP endpoint.

Usage

volca --config volca.toml server [OPTIONS]

Command reference

{serverHelp}

Examples

# Start on the default port (from config)
volca --config volca.toml server

# Override port
volca --config volca.toml server --port 9000

# Load specific databases only
volca --config volca.toml server --load ecoinvent,agribalyse

# Desktop mode (minimal logging, prints port for desktop integration)
volca --config volca.toml server --desktop

# Auto-stop after 30 minutes of inactivity
volca --config volca.toml server --idle-timeout 30

Notes

• The server loads all databases with load = true in the config. This may take 30s–2min for large databases.
• To stop a running server: volca --config volca.toml stop or POST /api/v1/auth + DELETE /api/v1/session.
• The HTTP API is at /api/v1/. The OpenAPI spec is at /api/v1/openapi.json and the Swagger UI at /api/v1/docs.
• The MCP endpoint is at POST /mcp.