4,000+ servers built on vurb.ts
Vinkius
Unlock for AI Agents
Mastra AISDK
Mastra AI
SurrealDB MCP Server

Bring Multi Model
to Mastra AI

Learn how to connect SurrealDB to Mastra AI and start using 16 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.

MCP Inspector GDPR Free for Subscribers
Create RecordCreate Specific RecordDelete AllDelete RecordExecute SqlExport DataGet HealthGet StatusGet VersionImport SqlModify AllModify RecordSelect AllSelect RecordUpdate AllUpdate Record
Unlock for AI Agents
ChatGPT Claude Perplexity

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
SurrealDB

What is the SurrealDB MCP Server?

Connect your SurrealDB database to any AI agent and take full control of your data layer through natural conversation.

What you can do

  • SurrealQL Execution — Run raw SurrealQL statements using the execute_sql tool for complex queries and logic.
  • Record Management — Create, update, and modify records in specific tables with tools like create_record, update_record, or modify_record.
  • Table Operations — Quickly select_all or delete_all records from a target table to manage your data at scale.
  • Health Monitoring — Check server status and health metrics using get_status and get_health to ensure uptime.
  • Data Portability — Use import_sql and export_data to move information in and out of your instance seamlessly.

How it works

  1. Subscribe to this server
  2. Enter your SurrealDB URL and credentials (NS, DB, and Auth)
  3. Start managing your multi-model database from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Backend Developers — test queries and inspect database state without switching windows.
  • Data Engineers — perform quick data migrations or schema inspections via natural language.
  • Product Managers — query business metrics directly from the database using SurrealQL.

Built-in capabilities (16)

create_record

Create a record with a random ID

create_specific_record

Create a specific record

delete_all

Delete all records in a table

delete_record

Delete a specific record

execute_sql

Can pass variables via URL query parameters. Execute SurrealQL statements

export_data

Export data

get_health

Check SurrealDB health

get_status

Check SurrealDB web server status

get_version

Get SurrealDB version

import_sql

Import SurrealQL queries

modify_all

Modify all records in a table (Merge)

modify_record

Modify a specific record (Merge)

select_all

Select all records in a table

select_record

Select a specific record

update_all

Update all records in a table

update_record

Update a specific record

Why Mastra AI?

Mastra's agent abstraction provides a clean separation between LLM logic and SurrealDB tool infrastructure. Connect 16 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

  • —

    Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add SurrealDB without touching business code

  • —

    Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

  • —

    TypeScript-native: full type inference for every SurrealDB tool response with IDE autocomplete and compile-time checks

  • —

    One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

M
See it in action

SurrealDB in Mastra AI

AI Agent→Vinkius
High Security·Kill Switch·Plug and Play
Why Vinkius

SurrealDB and 4,000+ other MCP servers. One platform. One governance layer.

Teams that connect SurrealDB to Mastra AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.

4,000+MCP Servers ready
<40msCold start
60%Token savings
Raw MCP
Vinkius
Server catalogFind and host yourself4,000+ managed
InfrastructureSelf-hostedSandboxed V8 isolates
Credential handlingPlaintext in configVault + runtime injection
Data loss preventionNoneConfigurable DLP policies
Kill switchNoneGlobal instant shutdown
Financial circuit breakersNonePer-server limits + alerts
Audit trailNoneEd25519 signed logs
SIEM log streamingNoneSplunk, Datadog, Webhook
HoneytokensNoneCanary alerts on leak
Custom domainsNot applicableDNS challenge verified
GDPR complianceManual effortAutomated purge + export
Unlock for AI Agents View step-by-step setup guide for Mastra AI →
Enterprise Security

Why teams choose Vinkius for SurrealDB in Mastra AI

The SurrealDB MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 16 tools execute in hardened sandboxes optimized for native MCP execution.

Your AI agents in Mastra AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

Unlock for AI Agents View full SurrealDB details →
SurrealDB
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

The Vinkius Advantage

How Vinkius secures SurrealDB for Mastra AI

Every tool call from Mastra AI to the SurrealDB MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

01

Can I run custom SurrealQL queries with variables?

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

02

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

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

03

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

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

04

How does Mastra AI connect to MCP servers?

Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.

05

Can Mastra agents use tools from multiple servers?

Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.

06

Does Mastra support workflow orchestration?

Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.

07

createMCPClient not exported

Install: npm install @mastra/mcp

Explore More MCP Servers

View all →
RandomUser API

RandomUser API

4 tools

Generate random user data — audit personas and locations via AI.

Vapi

Vapi

10 tools

Command Voice AI assistants directly from your chat. Make outbound phone calls, update personas, and retrieve full transcripts via Vapi.

Unkey API Management

Unkey API Management

8 tools

Manage and verify your user API keys via Unkey — create, revoke, and track usage directly from any AI agent.

TrueFoundry

TrueFoundry

8 tools

Universal LLM Gateway & ML deployment hub: invoke 1000+ proxy models and manage MCP service instances natively.