Claude Code is Anthropic's terminal coding agent. With the SurrealDB MCP server connected it can deploy and manage your Cloud instances and query the data inside them, and with the skills installed the SurrealQL it writes matches how the database actually behaves.
Add the MCP server
claude mcp add --transport http surrealdb https://mcp.surrealdb.comAdd --scope project to write the entry to .mcp.json in the repository instead of your global configuration. The file holds no credentials, so it is safe to commit; everyone who opens the project signs in as themselves.
Sign in
Run /mcp inside Claude Code, choose surrealdb, and approve the connection in the browser window that opens. Until you sign in, only the sign-in tool works.
If you are running somewhere without a browser, create a personal access token and pass it as a header instead:
claude mcp add --transport http surrealdb https://mcp.surrealdb.com \
--header "Authorization: Bearer <your-token>"Install the Agent Skills
Run this in your project root:
npx skills add surrealdb/agent-skillsClaude Code reads the installed skills automatically and picks one up when a task calls for it.
Check it worked
claude mcp listsurrealdb should be listed as connected.
Try it
Show me the SurrealDB instances in my organisation, and tell me which of them are paused.
Claude lists your organisations, picks the one you meant, and reports each instance with its state.
Remove it
claude mcp remove surrealdbNext steps
MCP in Claude — Claude Desktop and the Claude app, and troubleshooting
Example usages — more prompts to try