Seamless integration for AI
Seamless AI tool connections
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 authorised 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, analyse 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 tokens. Custom audience configuration and JWKS token validation for enterprise deployments.
surrealmcp start --auth-server https://auth.surrealdb.com
Rate limiting & production controls
Configurable request rate limiting with RPS and burst controls. Endpoint lockdown capabilities to restrict connections to specific SurrealDB instances.
surrealmcp start --rate-limit-rps 100 --rate-limit-burst 200
Environment variable configuration
Isolate tenants by namespace or database to prevent data leakage and ensure compliance with GDPR, HIPAA, and other regulations.
Audience validation
Custom audience configuration for enterprise deployments. Restrict tokens to specific applications and ensure secure access patterns.
Developer-friendly integrations
Secure connections across stdio, HTTP, and Unix socket transports. Consistent security policies regardless of deployment mode.
Deploy in any environment
Run SurrealMCP from in-memory, embedded, or edge devices to self-hosted or highly scalable in cloud.
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 behaviour 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 containerised 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.
1{
2 "mcpServers": {
3 "SurrealDB": {
4 "command": "docker",
5 "args": [
6 "run",
7 "--rm",
8 "-i",
9 "--pull",
10 "always",
11 "surrealdb/surrealmcp:latest",
12 "start"
13 ]
14 }
15 }
16}
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.
1{
2 "mcpServers": {
3 "SurrealDB": {
4 "command": "docker",
5 "args": [
6 "run",
7 "--rm",
8 "-p",
9 "8080:8080",
10 "--pull",
11 "always",
12 "surrealdb/surrealmcp:latest",
13 "start",
14 "--auth-disabled",
15 "--bind-address",
16 "127.0.0.1:8080",
17 "--server-url",
18 "http://localhost:8080"
19 ]
20 }
21 }
22}
