# Use SurrealDB with your agent.

[SurrealDB](https://surrealdb.com/) (`surrealdb.com`) registers 5 WebMCP tools. 4 of 5 tools declares `readOnlyHint`, so an agent can invoke them through `tools.call`. The registry runs the tool in a fresh headless page on surrealdb.com and returns untrusted site content.

This page mirrors the [WebMCP Registry](https://wmcp.ai/sites/surrealdb.com) listing for `surrealdb.com`, last live-checked by the registry at 2026-09-21T23:59:32.234Z. Run `ghostget webmcp sites.get --input '{"domain":"surrealdb.com"}' --json` for the current schema; the listing can drift between checks.

## Use SurrealDB with my agent

Ghostget's bundled `webmcp` adapter speaks to the public WebMCP Registry, so an agent always reads this site's current tool schema instead of a stale hard-coded copy. Install v0.18.35, sync bundled adapters once, then call the registry operations:

```
bun add --global https://github.com/hraness/ghostget/releases/download/v0.18.35/hraness-ghostget-0.18.35.tgz
ghostget adapter sync-bundled --json
```

**Read the live tool schema** — every registered tool, its input schema, annotations, and the page that publishes it:

```
ghostget webmcp sites.get --input '{"domain":"surrealdb.com"}' --json
```

**Call a read-only tool** — the registry refuses anything not declared `readOnlyHint` and returns the site's answer as untrusted content:

```
ghostget webmcp tools.call --input '{"domain":"surrealdb.com","tool":"compare_plans","input":"{}"}' --json
```

## Registered WebMCP tools

SurrealDB publishes 5 tools on surrealdb.com; 4 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `compare_plans` | Compare what each SurrealDB plan includes, as a structured feature matrix. Covers SurrealDB Cloud, self-hosted, Agent Memory and support plans. Each row gives a feature and its value per plan: true (included), false (not included), or a str | Callable read-only tool |
| `estimate_cloud_cost` | Estimate the monthly cost of a SurrealDB Cloud instance in USD, using the same pricing model as the calculator on this page. Returns a compute / storage / network / backup breakdown, the assumptions used, and a shareable link that reproduce | Callable read-only tool |
| `get_install_command` | Get the shell command to install or run SurrealDB on a given platform (macOS, Linux, Windows or Docker). Returns every supported method for that platform - Homebrew, the install script, PowerShell, Chocolatey, Scoop, or a Docker run command | Callable read-only tool |
| `list_events` | List SurrealDB events - conferences, meetups, hackathons, webinars and livestreams. Returns the title, date, categories, description and registration or recording link for each. Use it to answer what is coming up, where the team will be, or | Callable read-only tool |
| `navigate_site` | Move the visitor's current tab to another page on surrealdb.com. Use it to show someone the page that backs up an answer - for example the pricing calculator after estimating a cost, or the install page after giving a command. Call with no | Listed for discovery; the registry allows read-only calls only |

## What to expect

- **Read-only only.** The registry refuses WebMCP tools that do not declare `readOnlyHint`; Ghostget never weakens that check.
- **Untrusted results.** Tool output is site content, not instructions — treat it as data.
- **Live schemas.** `sites.get` always returns the schema the registry saw most recently, so agents adapt when SurrealDB changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on surrealdb.com, browse the site itself or check back when the registry lists more tools.