SurrealDB MCP for AI agents: built-in server (SurrealDB 3.1+ `surreal mcp`) and standalone surrealmcp (surrealdb/surrealmcp v0.4.0). Part of the surreal-skills collection.
Installs into .claude/skills of the current project.
Are you the author of Surrealmcp?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/24601-surrealmcp)
---
name: surrealmcp
description: "SurrealDB MCP for AI agents: built-in server (SurrealDB 3.1+ `surreal mcp`) and standalone surrealmcp (surrealdb/surrealmcp v0.4.0). Part of the surreal-skills collection."
license: MIT
metadata:
version: "1.7.1"
author: "24601"
parent_skill: "surrealdb"
snapshot_date: "2026-06-17"
upstream:
repo: "surrealdb/surrealmcp"
release: "v0.4.0"
builtin_since: "surrealdb v3.1.0"
---
# SurrealDB MCP for AI Agents
Two MCP surfaces exist as of SurrealDB 3.1:
| Surface | When to use |
|---|---|
| **Built-in** (`surreal mcp`, HTTP `/mcp`) | Local IDE hosts; simplest setup with the main `surreal` binary |
| **Standalone** (`surrealmcp start`) | Extended tool catalog, cloud helpers, multi-endpoint switching |
## Built-in MCP (SurrealDB 3.1+)
```bash
# stdio — typical MCP host config
surreal mcp --endpoint ws://127.0.0.1:8000/rpc --ns test --db test \
--user root --pass root
```
**Security:** stdio MCP grants owner-level tool access with no login step. Do not
expose to untrusted hosts. HTTP `/mcp` requires normal SurrealDB authentication.
See [rules/surrealmcp.md](../../rules/surrealmcp.md) for env vars and tool hints.
## Standalone surrealmcp (v0.4.0)
Not published to crates.io or npm. Install from source or Docker:
```bash
git clone https://github.com/surrealdb/surrealmcp
cd surrealmcp && cargo install --path .
# Or Docker
docker run --rm -i --pull always surrealdb/surrealmcp:latest start \
--endpoint ws://localhost:8000/rpc --ns test --db test
```
The `start` subcommand is mandatory. Full tool catalog and host wiring:
[rules/surrealmcp.md](../../rules/surrealmcp.md).
