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+)

# 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 for env vars and tool hints.

Standalone surrealmcp (v0.4.0)

Not published to crates.io or npm. Install from source or Docker:

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.