Skip to content

Agent setup

Visual Studio Code

Visual Studio Code has a native MCP client, so any chat extension that uses it can reach your SurrealDB Cloud account.

VS Code uses a servers object with an explicit transport type. Put it in .vscode/mcp.json for the workspace, or in the user-level mcp.json to have it everywhere.

{
  "servers": {
    "surrealdb": {
      "type": "http",
      "url": "https://mcp.surrealdb.com"
    }
  }
}
ScopePath
Workspace.vscode/mcp.json
Global (macOS)~/Library/Application Support/Code/User/mcp.json
Global (Windows)%APPDATA%\Code\User\mcp.json
Global (Linux)~/.config/Code/User/mcp.json

Reload the window, start the server from the MCP view, and approve the connection in the browser window that opens.

npx skills add surrealdb/agent-skills

Ask chat which SurrealDB tools it has available. If nothing appears, reload the window - VS Code reads mcp.json at startup.

Was this page helpful?