Cursor is an AI-first editor built on VS Code. With the SurrealDB MCP server connected, its agent can check what is deployed, query a database, and read logs without leaving the editor.
Add the MCP server
Cursor reads ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one. Add a surrealdb entry alongside any servers already listed:
{
"mcpServers": {
"surrealdb": {
"url": "https://mcp.surrealdb.com"
}
}
}Nothing about your account is stored in mcp.json, so a project-level file is safe to commit. Everyone who opens the project signs in as themselves.
Sign in
Open Settings → MCP, find surrealdb, and click Connect. Cursor opens a browser window where you sign in with your Surreal ID and approve the connection. The indicator beside the server turns green when it is ready.
If you use a personal access token instead, keep it in the global ~/.cursor/mcp.json. A token in a project-level file will be committed with the repository.
Install the Agent Skills
npx skills add surrealdb/agent-skillsCheck it worked
Ask the chat panel:
Which SurrealDB Cloud organisations can you see?
Cursor should answer with your organisations. Reload the window if the tools do not appear after editing mcp.json.
Remove it
Delete the surrealdb entry from mcp.json. Cursor stops offering the tools in new sessions.
Next steps
MCP in Cursor — the full guide, including troubleshooting
Example usages — more prompts to try