SurrealDB publishes Agent Skills and MCP servers, so the agent you already code with can write correct SurrealQL, run it against your databases, and manage the instances they live on.
Copy the setup prompt and paste it into your agent, or pick your agent below and follow the steps by hand. For a deeper reference on every way SurrealDB fits into AI tooling, see AI agents.
Pick your agent
Select an agent for its setup steps. Every agent listed supports both Skills and MCP.
Anthropic
Claude Code
Terminal coding agent that reads your codebase, runs commands, edits files, and manages git.
'/%3e%3cpath%20d='M88.3665%2081.453H64.1816C61.7566%2081.453%2059.793%2079.4894%2059.793%2077.0644C59.793%2074.6394%2061.7566%2072.6758%2064.1816%2072.6758H88.3665C90.7915%2072.6758%2092.7551%2074.6394%2092.7551%2077.0644C92.7551%2079.4894%2090.7915%2081.453%2088.3665%2081.453Z'%20fill='white'/%3e%3cpath%20d='M32.9796%2081.5759C32.2373%2081.5759%2031.485%2081.3879%2030.7954%2080.9916C28.6939%2079.7829%2027.9716%2077.0996%2029.1804%2074.9981L37.5337%2060.4781L29.1804%2045.9581C27.9716%2043.8566%2028.6939%2041.1733%2030.7954%2039.9646C32.8969%2038.7558%2035.5802%2039.478%2036.7889%2041.5796L46.4012%2058.2863C47.1811%2059.6405%2047.1811%2061.3082%2046.4012%2062.6624L36.7889%2079.3691C35.9764%2080.781%2034.4993%2081.5709%2032.9796%2081.5709V81.5759Z'%20fill='white'/%3e%3cdefs%3e%3clinearGradient%20id='paint0_linear_28696_6702'%20x1='60.1496'%20y1='0'%20x2='60.1496'%20y2='120.245'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20stop-color='%23AEA7FF'/%3e%3cstop%20offset='1'%20stop-color='%233C45FF'/%3e%3c/linearGradient%3e%3c/defs%3e%3c/svg%3e)
OpenAI
Codex
OpenAI's coding agent, available as a terminal CLI and a desktop app, running commands in a sandbox.
Cursor
Cursor
AI-first editor built on VS Code, with multi-file edits and agents that run in the background.
GitHub
GitHub Copilot
Editor extension and CLI with agent mode, workspace context, and pull request integration.
Microsoft
Visual Studio Code
Free, open-source editor with a native MCP client and support for third-party AI extensions.
Cognition
Windsurf
Agentic IDE whose Cascade agent keeps context across multi-step tasks and long edits.
'%3e%3cpath%20d='M10.4062%206.9375C8.4905%206.9375%206.9375%208.4905%206.9375%2010.4062V86.7188H0V10.4062C0%204.65904%204.65904%200%2010.4062%200H103.344C107.98%200%20110.301%205.60452%20107.023%208.88231L49.7825%2066.123H65.9062V58.9687H72.8438V67.8574C72.8438%2070.731%2070.5142%2073.0605%2067.6406%2073.0605H42.845L30.9212%2084.9844H84.9844V41.625H91.9219V84.9844C91.9219%2088.8162%2088.8162%2091.9219%2084.9844%2091.9219H23.9837L11.8431%20104.062H100.594C102.509%20104.062%20104.062%20102.509%20104.062%20100.594V24.2812H111V100.594C111%20106.341%20106.341%20111%20100.594%20111H7.6559C3.02041%20111%200.698958%20105.395%203.97674%20102.118L61.0007%2045.0938H45.0938V52.0312H38.1562V43.3594C38.1562%2040.4858%2040.4858%2038.1562%2043.3594%2038.1562H67.9382L80.0788%2026.0156H26.0156V69.375H19.0781V26.0156C19.0781%2022.1841%2022.1841%2019.0781%2026.0156%2019.0781H87.0163L99.1569%206.9375H10.4062Z'%20fill='black'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_30529_1318'%3e%3crect%20width='111'%20height='111'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
'%3e%3cpath%20d='M10.4062%206.9375C8.4905%206.9375%206.9375%208.4905%206.9375%2010.4062V86.7188H0V10.4062C0%204.65904%204.65904%200%2010.4062%200H103.344C107.98%200%20110.301%205.60452%20107.023%208.88231L49.7825%2066.123H65.9062V58.9687H72.8438V67.8574C72.8438%2070.731%2070.5142%2073.0605%2067.6406%2073.0605H42.845L30.9212%2084.9844H84.9844V41.625H91.9219V84.9844C91.9219%2088.8162%2088.8162%2091.9219%2084.9844%2091.9219H23.9837L11.8431%20104.062H100.594C102.509%20104.062%20104.062%20102.509%20104.062%20100.594V24.2812H111V100.594C111%20106.341%20106.341%20111%20100.594%20111H7.6559C3.02041%20111%200.698958%20105.395%203.97674%20102.118L61.0007%2045.0938H45.0938V52.0312H38.1562V43.3594C38.1562%2040.4858%2040.4858%2038.1562%2043.3594%2038.1562H67.9382L80.0788%2026.0156H26.0156V69.375H19.0781V26.0156C19.0781%2022.1841%2022.1841%2019.0781%2026.0156%2019.0781H87.0163L99.1569%206.9375H10.4062Z'%20fill='%23FFFFFF'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_30529_1318'%3e%3crect%20width='111'%20height='111'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
Zed Industries
Zed
Fast, open-source editor whose assistant reaches MCP servers as what it calls context servers.
Using something else? Any MCP client can reach the hosted server. Add https://mcp.surrealdb.com as a remote server in whatever form the client accepts, then install the skills with npx skills add surrealdb/agent-skills.
What your agent gets
Setup connects two things: packaged knowledge of how SurrealDB behaves, and tools your agent can call against your databases.
Agent Skills
Three official skills covering SurrealQL, vector search, and the Python SDK, so generated queries match how SurrealDB actually behaves.
SurrealDB MCP Server
One hosted URL connects your agent to SurrealDB Cloud: deploy and resize instances, query them, read metrics and logs, and check what it all costs.
Next steps
SurrealDB MCP Server — the hosted server in full, including every tool it publishes
Embedded MCP — the MCP server inside SurrealDB, for databases you run yourself
Agent Skills — what each skill covers, and how to find community skills
Example usages — prompts that show what an assistant can do once it is set up