Can I use Fauna as a CLI?

Yes. KosmoKrator exposes a Fauna CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Fauna through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Fauna tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Fauna credentials stored?

Fauna credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Fauna MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Fauna CLI for Headless Automation

Use the Fauna CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 5 read 1 write API token auth

Submit Fauna feedback View package source

Fauna CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Fauna CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Fauna CLI for Headless Automation
kosmokrator integrations:configure fauna --set bearer_token="$FAUNA_BEARER_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call fauna.fauna_list_databases '{}' --json

Discovery Before Execution

Agents and scripts can inspect Fauna docs and schemas before choosing a function.

kosmo integrations:docs fauna --json
kosmo integrations:docs fauna.fauna_list_databases --json
kosmo integrations:schema fauna.fauna_list_databases --json
kosmo integrations:search "Fauna" --json
kosmo integrations:list --json

Useful Fauna CLI Functions

Function	Type	Parameters	Description
`fauna.fauna_list_databases`	Read	none	List all databases in the current Fauna context. Returns database names and their metadata including creation time and references.
`fauna.fauna_get_database`	Read	name	Get details of a specific Fauna database by name. Returns database metadata including name, reference, creation time, and configured options.
`fauna.fauna_create_database`	Write	name, data_col, typecheck	Create a new Fauna database. Provide a database name and optional configuration. Requires a server or admin key. Returns the created database metadata.
`fauna.fauna_query_fql`	action	query	Execute a Fauna Query Language (FQL) expression. Provide the query as a JSON-encoded FQL expression. Supports all FQL operations including document reads, writes, indexes, and complex queries.
`fauna.fauna_list_collections`	Read	none	List all collections in the current Fauna database. Returns collection names and their metadata including references and creation time.
`fauna.fauna_get_collection`	Read	name	Get details of a specific Fauna collection by name. Returns collection metadata including name, reference, creation time, and configured options.
`fauna.fauna_get_current_user`	Read	none	Get the current authenticated Fauna key identity. Verifies the configured bearer token and returns the associated key identity information.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Fauna CLI Pages

CI Fauna CLI for CI. Cron Jobs Fauna CLI for cron jobs. Shell Scripts Fauna CLI for shell scripts. Coding Agents Fauna CLI for coding agents.