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

SurrealDB MCP Server

Q: Which AI tools support MCP?

Any MCP-compatible client, including Cursor, VS Code, Claude Desktop, Claude Code and Windsurf. Most 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 manages and queries SurrealDB Cloud instances.

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

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

Connect Claude, Cursor and other AI tools to SurrealDB over an open standard. One hosted server that acts as you, respects your role and asks before anything that cannot be undone.

Read the docs Start free with SurrealDB

https://mcp.surrealdb.com

Connect. Claude, Cursor and other AI tools, with a single URL.

Operate. Deploy instances, query data and investigate problems.

Control. Manage costs and access from the same conversation.

01 |CAPABILITIES

What you can do. One connection reaches Cloud, your data and, for waitlist members, Agent Memory.

INSTANCES

Deploy and manage instances

Create, pause, resize or upgrade an instance.

Explore SurrealDB Cloud

DATA

Work with your data

Ask in plain language and let the assistant write and run the SurrealQL, or seed tables while you build.

Learn SurrealQL

OBSERVABILITY

Look into problems

Instance status, metrics and logs next to the query you were writing.

Read the MCP docs

TEAMS

Manage your team

Invite people to an organisation, change their roles, withdraw invitations.

Organisations in the docs

COST

Keep an eye on cost

Check usage and invoices, and estimate an instance's cost before creating it.

See pricing

MEMORY

Give agents long-term memory

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

Explore Agent Memory

02 |CONNECT

Connect your AI tool. One URL, then sign in with your Surreal ID.

Add to VS Code Add to Cursor

Default

Default configuration

Add https://mcp.surrealdb.com as a remote MCP server and sign in when prompted.

{
  "mcpServers": {
    "surrealdb": {
      "url": "https://mcp.surrealdb.com"
    }
  }
}

Token

Personal access token

For a client that cannot open a browser, or anything unattended. Create one in the account portal.

{
  "mcpServers": {
    "surrealdb": {
      "url": "https://mcp.surrealdb.com",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Query

Query from the same connection

Manage an instance, then ask it questions: the assistant turns them into SurrealQL over the connection it already holds.

-- Ask your assistant to run queries like this
USE NS demo DB app;

SELECT
    ->purchased->product AS purchase_history,
    ->reviewed->product AS reviewed_products
FROM ONLY user:jaime;

Embedded MCP for databases you run yourself

Your questions,answered

What is the Model Context Protocol?

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

Which AI tools support MCP?

How do I sign in?

Can I use MCP with a self-hosted database?

Why can't my assistant query my instance?

THE PLATFORM

Everything an application and its agents know. Five surfaces, one engine.

Database

Document, graph, vector, time-series and relational in one engine.

Five data models as dotted tiles: documents, graph, vector, time-series and relational

Agent Memory

What an agent learns, with its source and its time, in the same engine.

A timeline of remembered facts, each with its source

Cloud

Managed clusters in the regions you choose, scaled on demand.

Clusters in three regions on a world map, each running or scaling

Studio

Query, explore and design the schema from the browser.

MCP

Every model that speaks MCP reaches the database and the memory directly.

Three models connected through MCP to the database and Agent Memory

IN PRODUCTION

Trusted at scale. Samsung, Nvidia, Verizon, Tencent, and Walmart run on SurrealDB.

14,000+

Developers building on SurrealDB Cloud

4M+

Developers building on SurrealDB worldwide

FROM THE TEAMS

SurrealDB gives us a foundation where we can unify semantic search, knowledge graphs, and AI-driven decision making without stitching together multiple systems. Collapsing responsibility into SurrealDB has become our default engineering posture.

Justin Foley

VP of Engineering, Later

GET STARTED

Connect your AI tools to SurrealDB Cloud. One URL in your MCP client, then sign in with your Surreal ID.

Read the docs Start free with SurrealDB