SurrealDB Cloud Dedicated is now available
Sign up for early access
Landing backgroundLanding background

SurrealMCP

Connect your AI tools directly to SurrealDB with the Model Context Protocol. Enable seamless data access, and intelligent interactions between AI models and SurrealDB.

Seamless integration for AI

Add to VSCode
Add to Cursor

Seamless AI tool connection

Connect your AI models and tools directly to SurrealDB through the Model Context Protocol. No complex APIs or custom integrations required.

Access all your data models

Query documents, graphs, vectors, and relational data through a unified interface. Your AI can access any data type with a single query language.

Real-time AI interactions

Enable your AI models to query live data, perform complex graph traversals, and access vector embeddings for context-aware responses.

Secure AI Data Access

Built-in authentication and permissions ensure your AI tools only access the data they're authorized to see, with granular control.

Developer-friendly integrations

Easy setup with VSCode and Cursor extensions. Connect your AI development environment to SurrealDB with just a few clicks.

Native vector search

Your AI tools can perform semantic search, similarity matching, and RAG operations directly within SurrealDB's native vector capabilities.

Graph-powered AI

Leverage SurrealDB's graph capabilities for AI. Traverse relationships, analyze connections, and understand complex data structures.

One query language for AI

SurrealQL provides a single, powerful interface for all your AI data needs. No need to connect and manage separate data stores.

Enterprise-grade security

Built for production environments with robust security and flexible authentication requirements.

Bearer token authentication

Secure integration with SurrealDB Cloud using JWT and JWE tokens. Robust token validation with JWKS support and custom audience configuration for enterprise deployments.

Rate limiting & production controls

Configurable request rate limiting with RPS and burst controls. Endpoint lockdown capabilities to restrict connections to specific SurrealDB instances.

Environment variable configuration

Flexible configuration management through environment variables. Easy deployment across different environments without code changes.

Audience validation

Custom audience configuration for enterprise deployments. Restrict tokens to specific applications and ensure secure access patterns.

Multi-transport security

Secure connections across stdio, HTTP, and Unix socket transports. Consistent security policies regardless of deployment mode.

Cloud-native operations

Complete SurrealDB Cloud management directly from your AI tools and dev environment.

Cloud instance management

Create, pause, resume, and monitor SurrealDB Cloud instances directly from your AI tools. Full lifecycle management without leaving your IDE.

Organization & instance discovery

List and manage multiple cloud organizations. Discover available instances and their current status with built-in health monitoring.

Health monitoring

Built-in health checks and status monitoring for cloud instances. Real-time visibility into instance performance and availability.

Automated token management

Automatic SurrealDB Cloud authentication token management. Seamless authentication without manual token management.

Cloud-native deployment

No need to manage your own SurrealDB instances. Connect to managed SurrealDB Cloud instances using the cloud:instance_id format.

Observability, logging & OpenTelemetry

Comprehensive monitoring and observability for production deployments.

Structured logging

Comprehensive logging and metrics for debugging and monitoring. Detailed request and response logging with configurable log levels.

OpenTelemetry integration

Native OpenTelemetry support for distributed tracing. Integrate with your existing observability stack and monitoring platforms.

Health check endpoints

Built-in health checking endpoints for monitoring and load balancer integration. Easy integration with Kubernetes and cloud platforms.

Performance metrics

Detailed performance metrics and request timing. Monitor query performance and identify optimization opportunities.

Error tracking

Graceful error handling with detailed feedback and error categorization. Comprehensive error tracking for debugging and alerting.

Embedded databases within AI tools

Run SurrealDB embedded within your AI tools - from in-memory to persisted production data.

Instant in-memory databases

Start ephemeral in-memory databases directly from your AI tools. Perfect for prototyping, testing, and development scenarios with zero setup.

Persisted local storage

Switch to persisted local storage when you need data durability. Seamlessly transition from development to production with the same interface.

Edge deployment ready

Deploy embedded databases on edge devices, laptops, and constrained environments. Lightweight footprint with full SurrealDB capabilities.

Multi-model embedded

Full multi-model support in embedded mode - documents, graphs, vectors, and relational data all available in a single embedded instance.

AI-native embedded

Optimized for AI workflows with native vector search, graph traversal, and real-time capabilities directly within your AI tools.

Integration ecosystem

Seamless integration with popular AI development tools, IDEs, and platforms.

IDE integration

Native support for VSCode, Cursor, and other popular IDEs. One-click installation and configuration for immediate database access.

AI platform compatibility

Works seamlessly with Claude Desktop, GitHub Copilot, and other AI assistants. Standard MCP protocol ensures broad compatibility.

Workflow automation

Integration with n8n and other automation platforms. Connect SurrealDB to your existing workflow and automation tools.

Standard protocol

Built on the Model Context Protocol standard. Future-proof integration that works with any MCP-compatible client or tool.

Developer experience

Optimized developer experience with instant setup, comprehensive documentation, and community support.

Comprehensive database operations

Full CRUD operations, advanced querying, and relationship management.

Full CRUD operations

Complete Create, Read, Update, and Delete operations. Insert, select, update, and delete records with powerful filtering and conditions.

Advanced querying

Complex filtering, sorting, pagination, and grouping. Parameterized queries with secure parameter binding for production use.

Relationship management

Create and traverse graph relationships between records. Build complex data models with inter-document links and graph queries.

Upsert operations

Smart upsert operations that create or update records based on conditions. Merge data efficiently with flexible merge strategies.

Connection management

Dynamic connection management with namespace and database switching. Connect to multiple endpoints and switch between them seamlessly.

Deploy in any environment

Flexible deployment options with multiple transport protocols and connection methods.

View the docs
Start your project

Local by default

Default stdio transport for local development and IDE integration. Simple, efficient communication with no network overhead.

Environment adaptability

Choose the right transport for your deployment environment. Seamless switching between transport modes based on requirements.

Cross-platform compatibility

Works across Windows, macOS, and Linux. Consistent behavior and capabilities regardless of the underlying platform.

HTTP server mode

Run as an HTTP server for environments where stdio is not available. RESTful API endpoints with JSON request/response format.

surrealmcp start --bind-address 127.0.0.1:8000

Unix socket support

Unix socket transport for secure local communication. Ideal for containerized environments and secure local deployments.

surrealmcp start --socket-path /tmp/surrealmcp.sock

Run locally, and connect directly from your IDE

SurrealMCP runs locally via stdio. Connect to SurrealDB instances from any IDE, framework, or AI tool. Instantly start an in-memory or local database at the edge directly from your AI tool, with ephemeral or persisted data.

{ "mcpServers": { "SurrealDB": { "command": "docker", "args": [ "run", "--rm", "-i", "surrealdb/surrealmcp:latest", "start" ] } } }

Run as an HTTP server, for local deployments

SurrealMCP can alternatively be run as an HTTP server, for environments where stdio is not available. With SurrealDB embedded within SurrealMCP, you can run SurrealDB instances locally, and connect to them directly from your IDE.

{ "mcpServers": { "SurrealDB": { "command": "docker", "args": [ "run", "--rm", "-p", "8080:8080", "surrealdb/surrealmcp:latest", "start", "--bind-address", "127.0.0.1:8080", "--server-url", "http://localhost:8080" ] } } }

Start building
with SurrealDB

Enterprise-grade agentic memory, secured at the core. Deploy AI agents in days, not quarters.

Start for free
Learn more
Trusted & Certified for Enterprise Security Learn more
SOC 2 Type 2
GDPR
Cyber Essentials Plus
ISO 27001