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.