--- title: "SurrealDB agent readiness score: 92/100 · Agentrail" description: "The website is strongest in discovery, with an entity presence on Wikipedia or Wikidata and discoverable developer resources, but lacks Idempotency-Key support and content without JavaScript." canonical: "https://www.agentrail.co/agent-readiness/surrealdb.com" --- Full report ## See what each check found, and how to fix it. Evidence, step-by-step fixes and your score over time, for your own site. [Get started →](https://app.agentrail.co/login?utm%5Fsource=agentrail.co&utm%5Fmedium=website&utm%5Fcampaign=agent-readiness%2Fsurrealdb.com&utm%5Fcontent=company-report) Free to start. No card. Usability 13 to fix - Web Bot Auth directoryEmergingHow to fix → - auth.md structureRecommendedHow to fix → - Agent auth discovery metadataRecommendedHow to fix → - Agent auth WWW-Authenticate hintRecommendedHow to fix → Fixes unlock with the full report Where the score comes from 83 of 90 points How surrealdb.com scores on each of the four questions agents ask. Discovery20/20 Access28/30 Usability35/40 Paymentsnot scored yet Strongest ### Discovery Every point is in. ARD trust manifest still fails. 20/20 Most to gain ### Usability auth.md structure, Agent auth discovery metadata, and 8 more are missing. 35/40 Most to gain ### Access Content without JavaScript, Sitemap freshness (lastmod), and 4 more are missing. 28/30 Not scored yet ### Payments ( bonus ) 6 checks partly met. Counts when scoring opens. — Agent path ## How an agent moved through the site We asked an agent a question about surrealdb.comand recorded every request it made. **S**surrealdb.comAnsweredRan Nov 8, 2026 Question I want to start using SurrealDB (surrealdb.com). Find its setup and getting-started guide. 2 Steps 24s Duration 2 Pages opened 0 Failed Every address the agent typed itself loaded. 1. 1surrealdb.com /Named in the question _→_ **Read** 2. 2/docsTyped by the agent _→_ **Read** 2/2 steps StepsHow it found itCame back as Step 2 of 2 `surrealdb.com/docs` How it got here Typed by the agent Response 200 Came back as Markdown 100% Pages that loaded 0% Followed site links 100% Read as markdown How it found each page Named in the question**1** A link on a page it read**0** Typed by the agent**1** A search result**0** What it reached Home page**Step 1** Pricing**Never reached** Docs**Step 2** Its answer Answers aren’t shown publicly See what agents answer about your own site. Run agents on your site and read every answer, with every page they opened. [Get started →](https://app.agentrail.co/login?utm%5Fsource=agentrail.co&utm%5Fmedium=website&utm%5Fcampaign=agent-readiness%2Fsurrealdb.com&utm%5Fcontent=journey-answer) Free to start. No card. Every check 125checks - Passed**49** - To fix**23** - Not in the score**53** 72 checks count toward the score. The other 53 are tracked for later. Discovery20 of 201 to fix8 passed ARD trust manifestRecommended0 / 2 ARD discoveryRequired1 / 1 AI Catalog discoveryRecommended1 / 1 ARD entry validityRecommended2 / 2 Developer resource discoverabilityRecommended3 / 3 Brand name discoverabilityRequired3 / 3 Wikipedia / Wikidata entity presenceRecommended4 / 4 robots.txt AI crawler policyRequired2 / 2 NPM/PyPI SDK packageRecommended1 / 1 \+ 6 checks not in the score Category share of voiceRecommendedNot counted Listed in MCP registriesRecommendedNot counted Agent platform configsEmergingNot counted Agent Plugins manifestEmergingNot counted Registry brandingEmergingNot counted ChatGPT app listedRecommendedNot counted Access28 of 301 to fix5 partly21 passed Sitemap freshness (lastmod)Recommended0 / 1 Content without JavaScriptRequired2 / 3 llms.txt formattingRecommended1 / 2 Schema type breadthRecommended1 / 2 Trust anchor pagesRequired1 / 2 API catalog (RFC 9727)Required1 / 2 Sitemap existsRequired2 / 2 Not blocked by bot detectionRequired2 / 2 Agent discovery fileRequired2 / 2 A2A / agent-cardRecommended2 / 2 MCP well-known discoveryRecommended2 / 2 HTTP Link headers (RFC 8288)Required1 / 1 robots.txt agent-user policyRequired2 / 2 llms.txt existsRequired1 / 1 JSON-LD structured dataRequired4 / 4 Pricing info accessibleRequired3 / 3 Public API/docs linked from homepageRequired3 / 3 JSON-LD entity linking (sameAs)Recommended2 / 2 Metadata completenessRequired2 / 2 Organization schema completenessRecommended2 / 2 llms.txt links resolveRecommended2 / 2 Redirect hygieneRecommended1 / 1 Page token budgetRecommended1 / 1 OpenAPI spec publishedRequired7 / 7 Developer portalRecommended6 / 6 Markdown content negotiation (acceptmarkdown.com)Recommended1 / 1 Agent crawler reachabilityRecommended2 / 2 \+ 15 checks not in the score Agent Skills index conformance (v0.2.0)EmergingNot counted Listed on skills.shEmergingNot counted pricing.md existsEmergingNot counted NLWeb Schema FeedsEmergingNot counted Agent mode viewEmergingNot counted Markdown URL fallbackEmergingNot counted Modular llms.txt per product areaEmergingNot counted Agent instruction / when-to-useRequiredNot counted Skills.sh skill qualityEmergingNot counted Markdown alternate linkEmergingNot counted Markdown frontmatter metadataEmergingNot counted Code fence validityEmergingNot counted Content behind authRecommendedNot counted Markdown agent docsEmergingNot counted Bot-UA markdown servingEmergingNot counted Usability35 of 406 to fix4 partly20 passed Agent auth WWW-Authenticate hintRecommended0 / 1 agent\_auth endpoints reachableRecommended0 / 2 Rate limit response headersRecommended0 / 2 Idempotency-Key supportRecommended0 / 3 REST async-job patternRecommended0 / 2 REST batch / bulk endpointRecommended0 / 2 auth.md structureRecommended1 / 2 Agent auth discovery metadataRecommended2 / 3 MCP server / manifestRequired5 / 6 REST versioning / deprecation policyRecommended1 / 3 Public API with reachable endpointsRequired7 / 7 OAuth 2.0 supportRequired5 / 5 Scoped permissionsRecommended5 / 5 MCP auth mechanismRecommended2 / 2 MCP OAuth metadataRecommended2 / 2 MCP PKCE S256 supportRecommended2 / 2 Agent onboarding frictionRecommended2 / 2 OAuth Protected Resource metadata (RFC 9728)Required2 / 2 auth.md existsRequired2 / 2 WebMCP supportRequired5 / 5 JSON error responsesRequired4 / 4 REST typed error modelRecommended3 / 3 CLI tool availableRecommended3 / 3 MCP server-card.jsonRecommended2 / 2 Sandbox / test environmentRecommended2 / 2 Agent-friendly 404sRecommended2 / 2 Accessible document structureRecommended3 / 3 Accessible names on controlsRecommended2 / 2 API schema complexity analysisRecommended2 / 2 Function calling compatibilityRecommended2 / 2 \+ 32 checks not in the score MCP tool descriptionsRecommendedNot counted MCP parameter schemasRecommendedNot counted MCP server identityRecommendedNot counted MCP tool listingRecommendedNot counted MCP tool namingRecommendedNot counted Web Bot Auth directoryEmergingNot counted auth.md walkthrough simulationRecommendedNot counted MCP error handlingRecommendedNot counted MCP modern transportRecommendedNot counted REST pagination patternRecommendedNot counted Multi-language SDK packagesRecommendedNot counted NLWeb /ask endpointEmergingNot counted NLWeb streaming supportEmergingNot counted REST response schema coverageRecommendedNot counted MCP tool annotationsRecommendedNot counted Product + docs MCP coverageRecommendedNot counted MCP resources exposedRecommendedNot counted GraphQL typed error modelRecommendedNot counted GraphQL versioning / deprecation policyRecommendedNot counted GraphQL pagination patternRecommendedNot counted GraphQL async-job patternRecommendedNot counted GraphQL schema description coverageRecommendedNot counted GraphQL batch mutationsRecommendedNot counted Native interactive controlsRecommendedNot counted Form control labelingRecommendedNot counted Accessibility-tree injection safety (bonus)RecommendedNot counted MCP Apps supportRecommendedNot counted A2UI / generative UI supportEmergingNot counted MCP Apps UI qualityRecommendedNot counted MCP App view reachableRecommendedNot counted MCP App view CSPRecommendedNot counted MCP resource qualityRecommendedNot counted PaymentsNot scored yet6 partly MPP payment protocolRequired0 / 2 x402 payment protocolRequired0 / 2 UCP - Universal Commerce ProtocolRequired0 / 3 ACP - Agentic Commerce ProtocolRequired0 / 3 ACP delegate paymentRecommended0 / 3 AP2 - Agent Payments ProtocolRecommended0 / 3