SurrealDB GraphQL API
SurrealDB exposes an experimental GraphQL interface that dynamically generates a complete schema from your database's table definitions, field types, custom functions, and access definitions. Enabling GraphQL requires running the server with the `--allow-experimental graphql` flag (pre-1.0 series) or configuring the capability in the server config. Once enabled, each namespace/database pair activates GraphQL by executing a `DEFINE CONFIG GRAPHQL` statement, which controls which tables and user-defined functions are surfaced (`TABLES AUTO`, `TABLES INCLUDE ...`, `TABLES EXCLUDE ...`) along with optional depth and complexity limits and introspection behavior.
Overview
SurrealDB GraphQL API is a GraphQL API specification published by SurrealDB on the APIs.io network.
SurrealDB exposes an experimental GraphQL interface that dynamically generates a complete schema from your database’s table definitions, field types, custom functions, and access definitions. Enabling GraphQL requires running the server with the --allow-experimental graphql flag (pre-1.0 series) or configuring the capability in the server config. Once enabled, each namespace/database pair activates GraphQL by executing a DEFINE CONFIG GRAPHQL statement, which controls which tables and user-defined functions are surfaced (TABLES AUTO, TABLES INCLUDE ..., TABLES EXCLUDE ...) along with optional depth and complexity limits and introspection behavior.
The GraphQL endpoint is available at https://<host>/graphql. documentation is published at https://surrealdb.com/docs/surrealdb/querying/graphql.
The specification includes 2 reference links.
Tagged areas include Database, Multi-Model, Graph Database, Document Database, and Vector Database.
Endpoint
References
- Documentation https://surrealdb.com/docs/surrealdb/querying/graphql
- GettingStarted https://surrealdb.com/docs/surrealdb/querying/graphql/getting-started
Work with this as data
Every GraphQL schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for graphql
4 MCP tools reach this
find_graphqlBrowse and filter every GraphQL schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/graphql/surrealdb-graphql"curl "https://apis.io/api/v1/graphql?limit=25"Discovery needs no key. Ratings and market analysis are Pro.