---
title: "surrealdb"
description: "Write SurrealQL, design schemas and indexes, run and operate SurrealDB from the CLI, manage migrations with SurrealKit, build vector search, and query instances over MCP."
canonical: https://agentpluginsdirectory.com/plugins/surrealdb
last-updated: 2026-09-13
---

# surrealdb
Write SurrealQL, design schemas and indexes, run and operate SurrealDB from the CLI, manage migrations with SurrealKit, build vector search, and query instances over MCP.
- Slug: surrealdb
- Publisher: SurrealDB
- Repository: https://github.com/surrealdb/kiro-power
- Manifest: plugins/surrealdb/plugin.json
- Version: 1.0.0
- License: Apache-2.0
- Category (editorial): other
- Skills: 11 (getting-started, surrealdb-cli, surrealdb-connection, surrealdb-js, surrealdb-mcp, surrealdb-python, surrealdb-vector, surrealkit, surrealql-functions, surrealql-performance, surrealql)
- MCP servers: 2 (surrealdb, surrealdb-local)
- Stars: 0
- Repository created: 2026-05-08
- Repository last pushed: 2026-09-10
- Publisher type: Organization
- Listing: https://agentpluginsdirectory.com/plugins/surrealdb
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## Skills

- getting-started: Set up the SurrealDB power after installation, check that the `surreal` CLI is installed, start or reach an instance, sign in to the bundled MCP servers, and optionally add a health-check hook. Use for first-run onboarding, when `surreal` is not found, when the power's MCP tools are unavailable or…
- surrealdb-cli: Use the `surreal` command-line binary to run a SurrealDB server (in-memory, RocksDB, SurrealKV, or TiKV), open an interactive or piped SQL REPL, import and export databases, check server readiness, upgrade the binary, repair storage, and manage SurrealML models. Use this skill whenever users run, c…
- surrealdb-connection: Connect to a SurrealDB instance, self-hosted (local or your own server) or managed SurrealDB Cloud, covering endpoint formats, the connect/USE/sign-in sequence, `SURREAL_*` environment variables, the WebSocket `/rpc` protocol, the stateless HTTP REST API, and root, record access, and JWT authentica…
- surrealdb-js: Using SurrealDB from JavaScript and TypeScript with the official surrealdb SDK, covering connecting (WebSocket/HTTP and embedded engines), authentication, CRUD, parameterized queries, and live queries. Use when connecting to SurrealDB from Node, Deno, Bun, or the browser, using the surrealdb npm pa…
- surrealdb-mcp: Inspect, query, administer, and troubleshoot SurrealDB through MCP tools, the managed endpoint at mcp.surrealdb.com, an instance's own `/mcp` HTTP route (SurrealDB 3.1+), or `surreal mcp` over stdio. Use when MCP tools should be preferred over guessing at table and field names, when a SurrealDB MCP…
- surrealdb-python: Using SurrealDB with the Python SDK, covering both client/server mode (WebSocket) and embedded mode (in-memory or file-based). Use when connecting to SurrealDB from Python, using the surrealdb Python package, running SurrealDB embedded without a server, or performing CRUD operations from Python cod…
- surrealdb-vector: Vector search with SurrealDB using HNSW indexes, KNN queries, and similarity scoring. Use when creating vector indexes, querying vectors with KNN distance operators, building semantic search or RAG pipelines, tuning HNSW parameters (EFC, M, M0, distance function, type), or implementing recommendati…
- surrealkit: Use SurrealKit, SurrealDB's schema-management and migration CLI, to scaffold projects from templates, sync schema in development, plan and execute production rollouts (with rollback), generate JSON/TypeScript types from a live database, and write declarative TOML test suites for schemas, permission…
- surrealql-functions: Discover and use SurrealDB's built-in SurrealQL functions with accurate, version-current signatures by running the SurrealQL language server (LSP) and tree-sitter grammar, with a namespace catalog linking every function group to its docs. Use when looking up which built-in function to use, its exac…
- surrealql-performance: Optimize SurrealDB performance through record ID and key design, indexing strategy, and computed/derived fields. Use when queries are slow, when designing record IDs for locality and range scans, choosing between standard/unique/full-text/vector indexes, verifying index usage with EXPLAIN, or decid…
- surrealql: Generate and modify SurrealQL queries to interact with SurrealDB databases. This includes creating and retrieving records, designing and managing schemas, establishing and querying graph relationships, performing live (real-time) queries, and leveraging all unique SurrealQL features for advanced da…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- surrealdb: transport: streamable-http; url: https://mcp.surrealdb.com
- surrealdb-local: transport: streamable-http; url: http://127.0.0.1:8000/mcp

Read from the plugin's own mcp.json. Environment variable names only, never values.