Skip to content
Vinkius

SurrealDB Connector for AI agents.

16 live capabilities

Perform multi-model database queries and record management via natural language.

Live agent request SurrealDB / Connector

Waiting for input…

AI Agent

Why people use SurrealDB

SurrealDB Multi-Model Database Querying

With this SurrealDB MCP, that process disappears. You can stay in your primary workspace and just tell your agent to find all users who joined last week or update the status of these records. It handles the SurrealQL execution and returns the data to you immediately, keeping you in your flow.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get a direct line to your SurrealDB instance from your AI chat.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Verifying published content

    A developer needs to see all published posts.

  2. Real-world use case 02

    Clearing test data

    A data engineer needs to clear a test table.

  3. Real-world use case 03

    Quick business metric checks

    A product manager wants to see user counts.

Complete set · 16capabilities

The complete SurrealDB capability set.

These are the exact actions your AI can choose when you ask it to work with SurrealDB.

Capability set01 / 04

01—04

4 capabilities in this set.

Part of 16 available through SurrealDB.

  1. 01 Capability

    Delete all

    Remove every record from a target table. Use this for clearing out test data or resetting a specific category.

  2. 02 Capability

    Import sql

    Bring in SurrealQL queries from external files. This makes it easy to run pre-written scripts against your live data.

  3. 03 Capability

    Update all

    Update all records in a table. This allows for broad changes to your data across an entire table.

  4. 04 Capability

    Get version

    Check the current version of your SurrealDB instance. This helps you keep track of your database software updates.

Capability set02 / 04

05—08

4 capabilities in this set.

Part of 16 available through SurrealDB.

  1. 05 Capability

    Create specific record

    Create a new record with a specific ID. This helps when you need to insert precise data into your tables.

  2. 06 Capability

    Delete record

    Remove a single specific record from your database. This is the standard way to clean up individual entries.

  3. 07 Capability

    Export data

    Move your data out of the database into a portable format. It is useful for backups or sharing datasets with other teams.

  4. 08 Capability

    Get health

    Check the current health of your SurrealDB instance. Use this to ensure your database is online and responding correctly.

Capability set03 / 04

09—12

4 capabilities in this set.

Part of 16 available through SurrealDB.

  1. 09 Capability

    Modify all

    Update every record in a table using a merge operation. This is great for applying bulk changes across a whole dataset.

  2. 10 Capability

    Modify record

    Update a specific record using a merge operation. It is the go-to way to change individual entries without overwriting the whole thing.

  3. 11 Capability

    Select all

    Grab every record from a specific table. Use this when you need to see the full scope of a dataset at once.

  4. 12 Capability

    Create record

    Add a new record to a table with a random ID. This is perfect for quick data entry where the specific ID does not matter.

Capability set04 / 04

13—16

4 capabilities in this set.

Part of 16 available through SurrealDB.

  1. 13 Capability

    Execute sql

    Run any raw SurrealQL statement with optional variables. This gives your agent full power to perform complex queries and logic.

  2. 14 Capability

    Get status

    Check the status of the SurrealDB web server. Use this to verify that your instance is reachable and running.

  3. 15 Capability

    Select record

    Retrieve a specific record from your database. Use this when you need to pull details for one particular entry.

  4. 16 Capability

    Update record

    Update a specific record in your database. This is the standard way to modify individual data points.

Set up in minutes

One URL. Then ask SurrealDB to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use SurrealDB from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_z8y2X9S7Lg9neGU4YlezuYLhsuJbWmTxMe30Ga4Q/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it SurrealDB, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable SurrealDB for the conversation.

Where the request belongs

Work SurrealDB can move forward.

Built around the request

This is for the engineers and data folks who spend half their day digging through database logs or testing queries. It is for anyone who wants to interact with their data layer without the friction of manual SQL entry.

01

Backend Developer

Testing queries and inspecting database states during active development without leaving the IDE.

02

Data Engineer

Performing quick schema inspections or data migrations using natural language commands.

03

Product Manager

Querying business metrics and user stats directly from the database to get real-time answers.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
Feishu Bitable logo
01 10 capabilities

Feishu Bitable

Collaborative multi-dimensional table platform by Lark. manage bases, tables, and records via AI.

View Connector
Fauna (Serverless DB) logo
02 1 capability

Fauna (Serverless DB)

Execute FQL queries directly against your Fauna serverless database from any AI agent to manage collections, documents, and indexes.

View Connector
Supabase logo
03 13 capabilities

Supabase

Connect your AI to Supabase. Execute database queries, manage users, and trigger PostgreSQL functions directly from your terminal.

View Connector
OceanBase logo
04 10 capabilities

OceanBase

Enterprise distributed relational database. manage clusters, tenants, and databases via AI.

View Connector
Turso logo
05 10 capabilities

Turso

Automate distributed database workflows via Turso. manage edge locations, organizations, and libSQL databases directly from any AI agent.

View Connector
ElectricSQL (Sync Engine) logo
06 2 capabilities

ElectricSQL (Sync Engine)

Sync Postgres data to your AI agent in real-time using ElectricSQL's HTTP Sync API. fetch shapes, stream updates, and query subsets.

View Connector

Bring your own AI

Change the model, client or framework. Keep SurrealDB connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about SurrealDB.

The practical details behind the request, access and result.

Can I use the SurrealDB MCP to run custom SurrealQL queries?

Yes, you can. Your agent can execute raw SurrealQL statements directly, allowing you to perform complex queries and logic using natural language.

How does the SurrealDB MCP help with data migrations?

It makes moving data much easier. You can use the import and export capabilities to move information in and out of your instance without manual script handling.

Can I use SurrealDB MCP to check if my database is online?

Yes, you can. The Connector includes capabilities to check the web server status and overall health metrics so you can verify your instance is up and running.

Is the SurrealDB MCP good for managing large amounts of data?

It is great for bulk actions. You can use specific capabilities to update or delete all records in a table at once, making it efficient for large-scale management.

What kind of databases does the SurrealDB MCP work with?

It is designed specifically for SurrealDB, which is a multi-model database supporting graph, relational, and document data types.

Can I use the SurrealDB MCP to update specific records?

Yes, you can. You can ask your agent to modify a single record or update a whole table using merge operations, all through your chat interface.

Can I run custom SurrealQL queries with variables?

Yes! Use the execute_sql capability. You can provide the raw SQL string and an optional JSON object of variables to be used in the query.

How do I check if my SurrealDB instance is online and healthy?

You can use the get_status capability to check the web server status or get_health to verify that both the server and the storage engine are functioning correctly.

Is it possible to delete all records from a specific table at once?

Yes, the delete_all capability allows you to remove all records from a specified table in a single operation.

One connection away

Give your agent a direct line to SurrealDB.

Connect SurrealDB once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available