Skip to content
cccskills
FreePublished on GitHub

surrealmcp

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.

The English summary is being prepared. Showing the original description.

Works withDocker
See how to install

Files included (1)

  • SKILL.md1.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

SurrealDB MCP for AI Agents

Two MCP surfaces exist as of SurrealDB 3.1:

SurfaceWhen 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Data migration and synchronization to SurrealDB from MongoDB, PostgreSQL, MySQL, Neo4j, Kafka, and JSONL. Full and incremental CDC sync. Part of the surreal-skills collection.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

Expert SurrealDB 3 architect and developer skill (tracks v3.1.4+). SurrealQL mastery, multi-model data modeling (document, graph, vector, time-series, geospatial), schema design, security, deployment, performance tuning, SDK integration (JS, Python, Go, Rust, Java, .NET, C, PHP, Swift, Kotlin, Ruby), Surrealism WASM extensions, SurrealML scope coverage (preview), built-in MCP (v3.1+) and standalone SurrealMCP, LangChain Python integration, editor tooling (LSP v0.1.6, tree-sitter, CodeMirror v1.0.6, VS Code/JetBrains/Neovim/Zed), and ecosystem integrations (Surrealist v3.9, Surreal-Sync, SurrealFS, SurrealKit v0.7, n8n, Agent Skills, setup-surreal). Universal skill for 30+ AI agents.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

Expert SurrealDB 3 skill. Use when working with SurrealDB, SurrealQL queries, multi-model data modeling (document, graph, vector, time-series, geospatial), schema design, graph traversal, vector search, security and permissions, deployment and operations, performance tuning, SDK integration, Surrealism WASM extensions, SurrealMCP, Surrealist IDE, Surreal-Sync migrations, SurrealFS, SurrealKit, or ecosystem integrations such as n8n and CodeMirror.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

SurrealFS virtual filesystem for AI agents. Rust core + Python agent (Pydantic AI). Persistent file operations backed by SurrealDB. Part of the surreal-skills collection.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

SurrealDB Surrealism WASM extension development. Write Rust functions, compile to WASM, deploy as database modules. Part of the surreal-skills collection.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

SurrealKit schema sync, rollout migrations, seeding, and declarative testing for SurrealDB apps. Part of the surreal-skills collection.

The English summary is being prepared. Showing the original description.

24601/surreal-skills35Updated Jun 18, 2026

See all skills by 24601

Report a problem with this skill