Can an AI agent use SurrealDB?

SurrealDB is a database company with a hosted cloud and a memory service for AI agents.

surrealdb.comDatabases

Driven 13 Nov 2026

Evidence sha256 a5c0b277JSONMarkdownFeedCite

L3

Does the work

  1. L0
  2. L1
  3. L2
  4. L3
  5. L4
  6. L5

Rank among the 246 products we drove

Time to get in
#1
<1minutes
Getting in on its own
Core work done
tied #1
100%
10 of 10 core tasks
Steps on its own
tied #35
3/ 5
Find to Leave, no person
Holds up
tied #85
68/ 100
Reliability under errors

Yes. Our agent signed up for SurrealDB on its own in a browser through a device login and used its API, MCP server and CLI. It offers agents a way to pay: Payment tools on its MCP server.

The record

Level confirmed

Not yet

Level from one drive; a second must agree.

Got in by
MCP sign-inUnder a minute, in a browser
Got as far as
Use: all 10 core tasksA person has to buy

Connects by

MCP, API, CLI, SDK

Agent payments

Payment tools on its MCP server; our agent didn't try it

  1. Find

    On its own · 424 doc pages read

    Docs it can act on: llms.txt, an OpenAPI and an MCP server.

  2. Get in

    On its own · <1 minutes

    MCP sign-in, sign-up in a browser.

  3. Use

    On its own · 10 of 10 core tasks

    Did: create, rename, query and delete serverless databases and free dedicated instances; define tables, write records and run vector, full-text and graph searches.

  4. PayFirst stop

    Stopped · 1 way for agents to pay

    Needs a person to buy. The billing form requires a phone number before the card step.

  5. Leave

    Partly

    Nothing to cancel. It deletes its data, but the login stays.

  • On its own
  • Stopped
  • Partly

To reach L4: Delete its account, so its keys and login stop working.

Checked 17 Nov 2026: MCP server answers, 82 tools, sign-up page, llms.txt and OpenAPI unchanged since the check before.

Find

How an agent connects

MCP, API, OpenAPI, CLI, SDK, agent payments and llms.txt, all found.

  • MCP server

    72 of 81 tested

    Official server. Remote MCP server mcp.surrealdb.com, 82 tools, OAuth with DCR.

    mcp.surrealdb.com

    81 tools mapped in our drive

    82 tools listed without signing in

  • API

    156 of 250 tested

    Platform REST API, OpenAPI 3.0.0.

    250 operations mapped in our drive

  • OpenAPI

    Yes

    A machine-readable description of the API.

  • CLI

    74 of 81 tested

    surreal CLI v1.2.0 with cloud component 1.1.0: instance, memory, org, token and api commands.

    81 commands mapped in our drive

  • SDK

    Yes
  • llms.txt

    Yes
  • Agent payments

    Listed, not tested

    Payment tools on its MCP server.

    Chose a plan, but the checkout didn't open: Earth Pro, $15 a month. It checks out through Stripe Checkout. No CAPTCHA at checkout. It asks for a phone number.

  • Docs

    In part

    Covers getting started, auth, error codes and code examples.

    Describes each operation only in part: completeness 55 of 100.

    27 of 27 documented ways to do the core work worked.

    surrealdb.com/docs/agent-memory

    424 of 1,374 pages read

MCP tools

Read without signing in on 2 Nov 2026

  • mcp_auth
  • list_regions
  • list_instance_types
  • list_instance_versions
  • list_billing_countries
  • search_documentation
  • get_cloud_terms_and_conditions
  • get_cloud_terms_acceptance_status
  • accept_cloud_terms_and_conditions
  • get_cloud_profile
  • list_organizations
  • get_organization
  • create_organization
  • update_organization
  • list_products
  • deploy_cluster
  • get_cluster
  • update_cluster
  • delete_cluster
  • get_cluster_usage
  • estimate_cluster_cost
  • list_instances
  • pause_instance
  • resume_instance
58 more tools74 more toolsShow fewer
  • accept_cloud_terms_and_conditions
  • get_cloud_profile
  • list_organizations
  • get_organization
  • create_organization
  • update_organization
  • list_products
  • deploy_cluster
  • get_cluster
  • update_cluster
  • delete_cluster
  • get_cluster_usage
  • estimate_cluster_cost
  • list_instances
  • pause_instance
  • resume_instance
  • get_instance_database_token
  • get_instance_backup_policy
  • get_instance_status
  • get_instance_spend
  • call_instance_tool
  • list_instance_tools
  • get_instance_metrics
  • get_instance_logs
  • get_organization_deployment_readiness
  • get_organization_billing_requirements
  • get_organization_billing
  • update_organization_billing
  • copy_organization_billing_from
  • setup_organization_for_instances
  • list_invoices
  • list_billing_coupons
  • get_organization_payment
  • get_organization_payment_setup_url
  • get_organization_payment_portal_url
  • get_organization_usage
  • list_organization_members
  • list_organization_roles
  • update_organization_member_role
  • remove_organization_member
  • list_organization_invitations
  • invite_organization_member
  • revoke_organization_invitation
  • list_context_regions
  • list_agent_memory_context_packages
  • list_organization_agent_memory_context_packages
  • assign_organization_agent_memory_context_package
  • cancel_organization_agent_memory_context_package
  • list_agent_memory_contexts
  • list_agent_memory_context_api_keys
  • delete_agent_memory_context_api_key
  • rotate_agent_memory_context_api_key
  • mint_agent_memory_scoped_key
  • mint_agent_memory_access_token
  • list_agent_memory_context_principals
  • create_agent_memory_context_principal
  • update_agent_memory_context_principal
  • delete_agent_memory_context_principal
  • replace_agent_memory_principal_grants
  • add_agent_memory_context_user
  • call_agent_memory_tool
  • list_agent_memory_tools
  • delete_agent_memory_context_scope
  • create_agent_memory_session
  • call_agent_memory_chat
  • get_agent_memory_snapshot
  • list_agent_memory_entities
  • list_agent_memory_documents
  • search_agent_memory_documents
  • list_agent_memory_context_scopes
  • create_agent_memory_context_scope
  • get_agent_memory_context_config
  • list_agent_memory_context_providers
  • list_agent_memory_context_verbs

Get in

Getting in

Our agent tried 3 of 7 ways in; 2 worked without a person.

The way that worked

MCP sign-inunder a minute

  • An inboxNot needed
  • A browserNeeded
  • A personNot needed
  • Agent on a serverAPI, MCP, CLINoStops at sign-up: it works only in a browser.
  • Assistant in its own browserLike ChatGPT agentPartlySigns up, confirms its email and does all of the core work, then stops: deletes its data, but the login stays.
  • Signed agentKnown to CloudflareYesThe site opens.

Every way in

Every way in and what happened
Way inWhat happenedWhy
MCP sign-inWorked
Sign-up in a browserWorked
Runs locally, no accountNot reached
Try first, claim laterStopped
Email and passwordNot reached
Registration through auth.mdNot triedThe same as another way
Identity assertionNot triedThe same as another way
  • CrawlersThe robots.txt on auth.surrealdb.com asks crawlers to stay off sign-up. Nothing to fix.

Use

What an agent can do with SurrealDB

All 10 core tasks done, and 20 of 24 others.

Core tasks

  • done there
Core tasks of SurrealDB: the result and the surfaces they went through
TaskResultThrough
Create a serverless Earth databaseDoneAPI: done thereMCP: done thereCLI: done there
Deploy a managed Cloud instanceDoneAPI: done thereMCP: done thereCLI: done there
Run a SurrealQL queryDoneAPI: done thereMCP: done thereCLI: done there
Create or update a recordDoneAPI: done thereMCP: done thereCLI: done there
Define a table and its fieldsDoneAPI: done thereMCP: done thereCLI: done there
Run a vector similarity searchDoneAPI: done thereMCP: done thereCLI: done there
Create an Agent Memory contextDoneAPI: done thereMCP: done there
Store a fact in agent memoryDoneAPI: done thereMCP: done there
Recall facts from agent memoryDoneAPI: done thereMCP: done there
Delete a Cloud instanceDoneAPI: done thereMCP: done thereCLI: done there

Surface audit: 412 documented operations: 302 run, 40 blocked by sandbox or plan limits and 70 left out because they spend money or reach real people. Of the 302 run, 257 passed and 45 didn't; 50 behaved differently from the docs. By surface, 156 on the API, 74 in the CLI and 72 on the MCP server.

  • Holds up

    68of 100

    • Reliability83
    • Handles mistakes52

    The mean of the two, 67.5, with a half rounded to the even number.

  • Docs match

    72of 100

    • Docs accuracy80
    • Docs completeness55

    Docs accuracy counts 70%, completeness 30%.

  • Surface tested

    76of 100

    257 of 338 passed: the 412 documented operations less the 74 that spend money or reach real people

  • What it can't do, and why

    • Pay for a paid plan The billing form requires a phone number before the card step.
    • Delete the account No delete control or endpoint; the privacy policy says to email the company.
    • Back up on demand, resize or upgrade a free instance Resize needs a paid type; backup gives an empty error; no newer version exists.
    • Manage access tokens with a token Token changes need a logged-in session, not a token.

20 of 24 other tasks done

  • Delete a recordDone
  • Relate records with graph edgesDone
  • Subscribe to live query changesDone
  • Run a full-text searchDone
  • Query data over GraphQLDone
  • Pause or resume an instanceDone
  • Import a SurrealQL file into a databaseDone
  • Export a database to a fileDone
  • Read instance metricsDone
  • Read instance logsDone
  • Upload a document to agent memoryDone
  • Forget facts in agent memoryDone
  • Chat with an agent memory contextDone
  • Set grants for an agent memory principalDone
  • Set table and record permissionsDone
  • Define a database event or functionDone
  • Register end users of your app through record accessDone
  • Store a file in a database bucketDone
  • Invite a member to an organisationDone
  • Read organisation usage and spendDone
  • Resize an instancePaid plan
  • Change the organisation planPaid plan
  • Configure enterprise SSOPaid plan
  • Provision users with SCIMPaid plan
  • Back up an instance on demandResize needs a paid type; backup gives an empty error; no newer version exists.Blocked
  • Upgrade an instance SurrealDB versionBlocked
  • Change a member's roleNot tried
  • Create an organisationNot tried

The drive used the free plan.

Tips for agent builders

From this drive

6 tips
  • Use surreal cloud auth login --flow device --json from a browser-free shell, then surreal cloud token create for a PAT; revoke it with surreal cloud token delete --force from the session, because the PAT cannot revoke itself.
  • Pass --yes to every CLI command that changes or deletes something in a non-interactive shell.
  • deploy_cluster for Earth needs no residency; the documented cloudflare-us enum value is refused.
  • Agent Memory Free allows one context: delete the old one before you create another.
  • For a free dedicated instance, use POST /api/cloud/v0/instances with specs.slug 'free'; surreal cloud instance deploy --region aws-use1 wrongly says no single-node type is available.
  • Begin surreal cloud instance import files with OPTION IMPORT;, and read the data back after an import error, because a reported failure can still have committed rows.

Pay

Paying

Ways to pay checked 13 Nov 2026.

  • ResultStopped. Needs a person to buy. The billing form requires a phone number before the card step.
  • CheckoutChose a plan, but the checkout didn't open: Earth Pro, $15 a month. It checks out through Stripe Checkout. No CAPTCHA at checkout. It asks for a phone number.
  • Ways to pay
    • Payment tools on its MCP server (on its own domain)
  • TrialNo card needed to start.

Leave

Leaving

  • ResultPartly. Nothing to cancel. It deletes its data, but the login stays.
  • Its accountNot tried.

Daily checks

Checked every day

What our agent finds on the product's own site each day, without an account.

  • Sign-up page,

    Loads on the newest check; 5 of 5 days

  • llms.txt,

    Found on the newest check; 5 of 5 days

  • MCP server (82 tools),

    Answers on the newest check; 5 of 5 days

  • OpenAPI,

    Found on the newest check; 5 of 5 days

Compare

How SurrealDB compares

In Databases

4 of the 21 products we drove in Databases are higher; 9 others share L3. As of 14 Nov 2026.

The products we drove in Databases, in the directory's order, with SurrealDB
ProductLevelFind to leave
UpstashL4Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own.
AirtableL4Find: Partly, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own.
NocoDBL4Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: On its own.
ConvexL4Find: On its own, Get in: On its own, Use: On its own, Pay: Not tried, Leave: On its own.
Redis CloudL3Find: On its own, Get in: On its own, Use: On its own, Pay: Partly, Leave: Partly.
FirebaseL3Find: Partly, Get in: On its own, Use: Partly, Pay: Not tried, Leave: On its own.
NeonL3Find: On its own, Get in: On its own, Use: Partly, Pay: Not tried, Leave: On its own.
PlanetScaleL2Find: On its own, Get in: On its own, Use: Not measured, Pay: Partly, Leave: On its own.
BaserowL1Find: On its own, Get in: Stopped, Use: Not reached, Pay: Not reached, Leave: Not reached.
MongoDB AtlasL1Find: On its own, Get in: Stopped, Use: Not reached, Pay: Not reached, Leave: Not reached.
SupabaseL1Find: On its own, Get in: Stopped, Use: Not reached, Pay: Not reached, Leave: Not reached.
SurrealDB (this page)L3Find: On its own, Get in: On its own, Use: On its own, Pay: Stopped, Leave: Partly.

12 of 21 shown, in the directory's order.

All 21 in DatabasesHow we rank

For the team behind SurrealDB

Agents get stuck at Pay

6 things to fix for agents: 2 small and 4 medium

One fix can cover several findings.

Agent blockers: 4 foundAgent surfaces: 52 issues found

Get your findings, freeWhat a drive covers

We mail a private link to an address at surrealdb.com.

  1. FindClear
  2. Get inClear
  3. UseClear
  4. PayBlocks agents
  5. LeavePartly

Or claim SurrealDB to see where each issue is, read your safety findings with their fixes and ask for a free drive after a fix.

Want SurrealDB driven every month? See Watch

On our standard

Best or ahead on 4 of 35 criteria, behind on 7. Each against the products we measured on it.

All 35 criteria
How each criterion is graded

Where SurrealDB fits

History

Level by drive

One drive so far, on 13 Nov 2026.

Source: our drives of SurrealDB. As of 13 Nov 2026.

One drive so far.

Read more on this step

Pay is where our agent stopped at SurrealDB.

Every earlier drive is in the history. The level follows these rules. Data under CC BY 4.0.

Found an error? or read how corrections work.

Questions people ask about SurrealDB

Can an AI agent create a SurrealDB account on its own?
Yes, in a browser, without a person. Email and password sign-up at auth.surrealdb.com (Auth0), done in the browser; no CAPTCHA seen. The form asked for name, job title, company, use case and organisation name; our agent answered. The Google, GitHub, Microsoft and passkey buttons were not used. There is no browser-free sign-up; auth.md documents no agent registration.
Does SurrealDB have an MCP server, and can an agent connect to it?
Yes. SurrealDB has an official MCP server. The server is hosted, lists 82 tools and signs an agent in with OAuth. A new agent can get in on its own: in the drive of 13 Nov 2026, our agent signed up, verified and got its key without a person. Through the MCP server, our agent tried 25 tasks and did 24.
How does an AI agent get a SurrealDB API key?
In the drive of 13 Nov 2026, our agent got its SurrealDB API key over the API, without a browser or a person. MCP OAuth (DCR and PKCE) gave a token after a consent page in our agent's browser. The CLI device login (code confirmed in our agent's browser) gave a session, and surreal cloud token create minted a scoped PAT without a browser. The PAT was used on the API and revoked at the end through the CLI session; it got 401 after the grace period. The PAT itself cannot manage tokens (403 'Use a logged-in session').
Can an AI agent pay for SurrealDB?
No. A person has to buy: a phone number at checkout. No card needed to start. SurrealDB offers agents a way to pay: Payment tools on its MCP server.

Cite this page

The page as a reference, in plain text, APA and BibTeX.

Cite this
Plain
AgentDrives, “SurrealDB: AI agent test drive”, 13 November 2026, https://agentdrives.com/tools/surrealdb. CC BY 4.0.
APA
AgentDrives. (2026, November 13). SurrealDB: AI agent test drive. https://agentdrives.com/tools/surrealdb
BibTeX
@misc{agentdrives_surrealdb_2026,
  author = {{AgentDrives}},
  title = {SurrealDB: AI agent test drive},
  year = {2026},
  month = nov,
  url = {https://agentdrives.com/tools/surrealdb},
  note = {Agent test drive, CC BY 4.0},
}

Something wrong on this page?

We check it against the drive and correct the page, with the date.