If your client supports sign-in, it opens a browser window for you to sign in with your Surreal ID. For unattended or headless setups, create a personal access token in the account portal and pass it as an Authorization header.

SurrealDB MCP Server

Q: What is the Model Context Protocol?

MCP is an open standard for connecting AI assistants to outside tools and data. The SurrealDB MCP Server connects your assistant to SurrealDB Cloud so it can deploy instances, query data, manage teams, and work with Agent Memory.

Q: Which AI tools support MCP?

Any MCP-compatible client can connect, including Cursor, VS Code, Claude Desktop, Claude Code, and Windsurf. Most clients need only the URL https://mcp.surrealdb.com.

Q: Can I use MCP with a self-hosted database?

Yes. SurrealDB 3.1 and later includes Embedded MCP for databases you run yourself. The hosted server at mcp.surrealdb.com is for SurrealDB Cloud management and querying cloud instances.

Q: Why can't my assistant query my instance?

The instance may be paused or still starting - wait until it reports as ready, or ask your assistant to resume it. Data tools also require SurrealDB 3.1 or later; ask your assistant to upgrade older instances.

Connect Claude, Cursor, and other AI tools to your SurrealDB Cloud account with a single URL. Deploy instances, query data, investigate problems, and manage costs - all from your assistant.

Read the docs Start free with SurrealDB

WHAT IS MCP?

Connect AI assistants to your data

Model Context Protocol is an open standard for connecting AI assistants to outside tools and data. Instead of copying a connection string into a chat window and pasting query results back out, your assistant works with SurrealDB directly.

https://mcp.surrealdb.com

The server is hosted for you - nothing to install and nothing to keep running. It acts as you: it sees only the organisations you belong to, respects the role you hold in each one, and asks you to confirm anything that cannot be undone.

CAPABILITIES

What you can do

One connection gives your assistant access to SurrealDB Cloud, your instance data, and Agent Memory (early access).

Deploy and manage instances

Create an instance, pause one you are not using, resize it as traffic grows, or upgrade it to a newer version of SurrealDB.

Work with your data

Ask a question in plain language and let the assistant write and run the SurrealQL, or have it create tables and seed records while you build.

Look into problems

Pull up instance status, metrics, and logs next to the query you were just writing.

Manage your team

Invite people to an organisation, change what they can do, and withdraw invitations.

Keep an eye on cost

Check usage and invoices, and estimate what an instance will cost before you create it.

Give agents long-term memory

Create and manage Agent Memory contexts, then store and recall memories from them.

CONNECT

Connect your AI tool

Most clients need nothing but the URL. Add the server to your MCP client, sign in with your Surreal ID, and ask your assistant to list your organisations to confirm the connection.

Add to VS Code Add to Cursor

Default configuration

Add https://mcp.surrealdb.com as a remote MCP server. Sign in with your Surreal ID when prompted.

1{
2  "mcpServers": {
3    "surrealdb": {
4      "url": "https://mcp.surrealdb.com"
5    }
6  }
7}

Personal access token

Use a token when your client cannot open a browser, or when something runs unattended. Create one in the account portal.

1{
2  "mcpServers": {
3    "surrealdb": {
4      "url": "https://mcp.surrealdb.com",
5      "headers": {
6        "Authorization": "Bearer <your-token>"
7      }
8    }
9  }
10}

WORKING WITH DATA

Query from the same connection

The same connection that manages an instance can also query it. Your assistant chooses the namespace and database, writes the SurrealQL, and shows you what came back. Instances must be running and on SurrealDB 3.1 or later.

1-- Ask your assistant to run queries like this
2USE NS demo DB app;
3
4SELECT
5    ->purchased->product AS purchase_history,
6    ->reviewed->product AS reviewed_products
7FROM ONLY user:jaime;

SELF-HOSTED

Embedded MCP for databases you run yourself

The hosted server covers SurrealDB Cloud. To give an assistant tools against a database you run yourself, see Embedded MCP in the docs. The same tool surface - query, select, create, list, info, and more - is built into SurrealDB 3.1 and later.