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 MCP, CLI, and Lua Integration for AI Agents

Fauna integration docs for AI agents: MCP gateway setup, Fauna CLI commands, Lua API reference, credentials, and function schemas.

7 functions 5 read 1 write API token auth

Submit Fauna feedback View package source

Fauna for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: fauna
route_slug: fauna
package: fauna
auth_strategy: api_token API token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Fauna CLIHeadless setup and direct function calls. Fauna MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Fauna MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Fauna.

Claude Code Fauna MCP setup for Claude Code. Cursor Fauna MCP setup for Cursor. Codex Fauna MCP setup for Codex. OpenAI Agents Fauna MCP setup for OpenAI Agents SDK. Claude Agent SDK Fauna MCP setup for Claude Agent SDK. Vercel AI SDK Fauna MCP setup for Vercel AI SDK. LangChain Fauna MCP setup for LangChain. LangGraph Fauna MCP setup for LangGraph. CrewAI Fauna MCP setup for CrewAI. MCP clients Fauna MCP setup for Generic MCP Clients.

Fauna CLI Matrix

Use these pages for direct Fauna CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

Function	Type	Parameters	Description
`fauna.fauna_list_databases`	Read `read`	0	List all databases in the current Fauna context. Returns database names and their metadata including creation time and references.
`fauna.fauna_get_database`	Read `read`	1	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 `write`	3	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 `action`	1	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 `read`	0	List all collections in the current Fauna database. Returns collection names and their metadata including references and creation time.
`fauna.fauna_get_collection`	Read `read`	1	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 `read`	0	Get the current authenticated Fauna key identity. Verifies the configured bearer token and returns the associated key identity information.