GitHub Copilot

GitHub Copilot reaches MCP servers through agent mode in VS Code. Once connected, Copilot Chat can query your SurrealDB Cloud instances and manage them alongside the code it is writing.

Prerequisites

• •

  VS Code 1.99 or later

• •

  The GitHub Copilot extension with agent mode enabled

To enable agent mode, open VS Code settings, search for github.copilot.chat.agent.enabled, and set it to true.

Add the MCP server

Copilot reads the same file VS Code does: .vscode/mcp.json for the workspace, or the user-level mcp.json for every project.

{
  "servers": {
    "surrealdb": {
      "type": "http",
      "url": "https://mcp.surrealdb.com"
    }
  }
}

A workspace file makes the server available to everyone who opens the project. It holds no credentials, so it is safe to commit.

Sign in

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

Install the Agent Skills

npx skills add surrealdb/agent-skills

Check it worked

Open Copilot Chat in agent mode and ask which SurrealDB tools it can use. The tools picker in the chat input lists them once the server is running.

Try it

List my SurrealDB Cloud instances and tell me which region each one is in.

Next steps

• •

  Visual Studio Code — the same file, without Copilot

• •

  SurrealDB MCP Server — every tool the server publishes