HonestClaw
What is Agent Readiness?

Agent Readiness Score

mdcalc.com

13 — Limited. Agents will struggle to discover or use this site without human help.

44 of 45 checks conclusive · Confidence High · Evidence coverage 98%

HonestClaw measured how well mdcalc.com's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.

Dimensions

Discoverability6.9/24
Content Accessibility6.7/24
Bot Access Control0/12
Protocol & Capability Discovery3.5/41
Authentication & Credentials0/19
Documentation Quality0/10
Structured Data I/O0/12
Observable State & Reliability0/15
Agent Safety & Trust4.7/11

Checks

Discoverability

Subdomain sweepsubdomain-sweepAn agent-relevant subdomain is live (api.mdcalc.com).Detected
Canonical domaincanonical-domainRoot and www converge on www.mdcalc.com, with a matching canonical tag.Cross-verified
robots.txtrobots-txtrobots.txt at https://mdcalc.com/robots.txt declares a sitemap. Declared sitemap https://www.mdcalc.com/sitemap.xml resolves as valid XML.Cross-verified
sitemap.xmlsitemap-xmlhttps://www.mdcalc.com/sitemap.xml is a valid sitemap (1036 location(s)), but without lastmod or non-homepage URLs.Parseable
API existenceapi-existenceA conventional API path at https://www.mdcalc.com/api/v1 returned an auth challenge (HTTP 401). (source: live)Detected
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog.Not detected
API versioningapi-versioningNo versioning signal found (no spec info.version, version header, /vN API surface, or versioning docs).Not detected

Content Accessibility

Markdown twinmarkdown-twinNo markdown twin found alongside probed docs HTML surfaces.Not detected
Raw content extractabilityraw-content-extractabilityModerate-to-strong main content (55% of visible text) is extractable from raw HTML on the homepage.Useful
Freshness signalsfreshness-signalsA single freshness signal is present (ETag header).Parseable
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredA manageable sitemap (1036 page URLs) helps agents estimate crawl cost.Useful
llms.txtllms-txtNo llms.txt file found (HTML pages at .txt paths do not qualify).Not detected
llms-full.txtllms-full-txtNo llms-full.txt file found (HTML pages at .txt paths do not qualify).Not detected
ai.txtai-txtNo ai.txt file found (HTML pages at .txt paths do not qualify).Not detected

Bot Access Control

AI bot rulesai-bot-rulesrobots.txt is readable but declares no AI-bot-specific rules.Not detected
Content signalscontent-signalsrobots.txt is readable but declares no Content-Signal line.Not detected
RSL licensingrslrobots.txt is readable but declares no RSL License directive.Not detected
TDM reservationtdmrepNo TDMRep policy found at /.well-known/tdmrep.json.Not detected

Protocol & Capability Discovery

MCP descriptormcp-descriptorInformational — not scoredNo MCP descriptor found at the standard locations an agent would check.Not detected
Link headerslink-headersNo RFC 8288 Link headers found on any probed response.Not detected
OpenAPI specificationopenapi-specNo OpenAPI/Swagger specification found.Not detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.mdcalc.com.Not detected
MCP Server Cardmcp-server-cardNo MCP Server Card found at the standard locations an agent would check.Not detected
A2A Agent Carda2a-agent-cardNo A2A Agent Card found at the standard well-known locations.Not detected
SDK availabilitysdk-availabilityNo SDK or client library documentation found.Not detected
MCP supportmcp-supportNo first-party MCP support documentation or MCP-specific endpoint response was found.Not detected
GraphQL surfacegraphql-surfaceNo GraphQL transport surface found at conventional paths (GET-only; no introspection issued).Not detected
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected
Auth discoveryauth-discoveryA drivable auth-discovery descriptor is published.Useful
Rate limit documentationrate-limit-docsNo rate limit documentation found at the standard docs locations an agent would check.Not detected
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify

Authentication & Credentials

Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check.Not detected
Programmatic auth flowprogrammatic-auth-flowNo programmatic authentication documentation found at the standard docs locations an agent would check.Not detected
Sandbox environmentsandbox-environmentNo sandbox or test environment documentation found at the standard docs locations an agent would check.Not detected
Auth documentationauth-documentationNo authentication documentation found at the standard docs locations an agent would check.Not detected

Documentation Quality

API reference depthapi-reference-depthAPI reference documentation lacks depth or was not found.Not detected
Changelog presencechangelog-presenceNo changelog or release notes found at the standard docs locations an agent would check.Not detected

Structured Data I/O

Structured data I/Ostructured-data-ioNo published structured-data contract found (no typed spec response schemas).Not detected
Data export APIdata-export-apiNo data export or bulk API documentation found at the standard docs locations an agent would check.Not detected
Machine-readable pricingmachine-readable-pricingCould not conclusively check for a machine-readable pricing endpoint (endpoints unreachable, rate-limited, or behind auth).Couldn't verify

Observable State & Reliability

Status & health endpointsstatus-and-healthNo health or status endpoint found.Not detected
Webhook documentationwebhook-documentationNo webhook or event documentation found at the standard docs locations an agent would check.Not detected
Retry & idempotencyretry-and-idempotencyNo retry or idempotency documentation found at the standard docs locations an agent would check.Not detected
Error documentationerror-documentationNo error documentation found at the standard docs locations an agent would check.Not detected
Machine payments (x402/MPP)x402-or-mpp-supportInformational — not scoredNo machine-payment signal observed (no HTTP 402, no payment-required response header, and no /.well-known/x402.json manifest). Payment support cannot be ruled out from an unauthenticated probe.Couldn't verify

Agent Safety & Trust

security.txtsecurity-txtNo security.txt found at /.well-known/security.txt or /security.txt.Not detected
Org identity signalsorg-identityHomepage exposes one org-identity signal (social).Detected
Metadata consistencymetadata-consistencyHomepage metadata (canonical, Open Graph, schema) is present and consistent.Cross-verified
Legal policy pageslegal-pagesBoth privacy and terms policies are discoverable with substantive content.Useful