• DATA
  • WRITE
  • SCHEMA
  • HUMAN

How to run FQL queries with your AI client

Connect Fauna to your AI client once. From then on, you can use natural language to trigger database operations through your existing development tools.

Ask AI about this page

Short answer

How can I use my AI to run Fauna queries?

Your AI uses the execute_fql tool to send raw FQL commands to your database. This lets you query data, update records, or manage collections using plain English. You get immediate database feedback right in your chat interface.

Where every action lands.

Database outcomes

The AI translates your intent into specific database changes or data retrievals.

DATA

Instant query results

The AI runs FQL to pull specific documents or collections. You get the raw data or a summary back in your chat window.

WRITE

Direct record updates

Your AI sends commands to create or modify documents. This changes your live database state based on your instructions.

SCHEMA

Collection management

You can instruct the AI to set up new collections or adjust existing structures. It handles the FQL syntax for you.

HUMAN

Manual verification

The AI provides the FQL it intends to run. You review the command before confirming sensitive write operations.

The workflow

What your AI does when you ask for a query.

The AI acts as a bridge between your natural language and the Fauna engine.

  1. Translate intent

    The AI interprets your request, like asking for a specific user profile, and maps it to the necessary FQL logic.

    execute_fql

  2. Construct FQL

    It builds the exact FQL string required to interact with your specific database schema and collections.

    execute_fql

  3. Execute command

    The agent sends the command to Fauna to perform the read or write operation.

    execute_fql

  4. Report results

    The AI parses the database response and presents the data or error messages in a readable format.

    execute_fql

Try it

Copy these to start.

Use these prompts to begin interacting with your database.

Starting points

Swap out the collection names and field keys to match your specific database schema.

Fauna Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_hEG5bwdrY3FdPx62RCPAMcIqUBDzab1jcyYhjY8I/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Fauna capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "fauna-serverless-db-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_hEG5bwdrY3FdPx62RCPAMcIqUBDzab1jcyYhjY8I/mcp"
    }
  }
}
Copy into chat04

  • Find the last five entries in my 'logs' collection.

  • Update the 'status' field to 'active' for the user with ID 'user_123'.

  • Show me all documents in the 'orders' collection where the total is greater than 50.

  • Create a new document in the 'users' collection with the name 'Alex' and email 'alex@example.com'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Fauna once, then ask.

Just link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start querying from your preferred AI client.

Connect Fauna to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete my entire database?

    No. The AI only executes the specific FQL commands you request. It does not have autonomous permission to wipe your database unless you explicitly tell it to run a command that does that.

  • 02

    Does the AI see my database credentials?

    No. Your credentials are encrypted and managed by Vinkius. The AI only interacts with the database through the provided tool.

  • 03

    Can I use this with Cursor or VS Code?

    Yes. Any MCP-compatible client like Cursor, VS Code, or Windsurf can use this connector once it is connected.

  • 04

    Will the AI automatically change my schema?

    No. The AI only performs schema changes if you specifically ask it to run an FQL command that modifies your collections.

  • 05

    Can the AI run complex joins?

    Yes, as long as you describe the relationship in your prompt, the AI can write the FQL required to perform those lookups.

  • More questions about Fauna? See everything the Fauna Connector can do

Connect Fauna to Claude, Cursor, ChatGPT & more