Agent Readiness Score
fal.ai
48 — Developing. Agents can find parts of this site, but key capabilities are hard to reach.
HonestClaw measured how well fal.ai's site and APIs work for AI agents — across 9 dimensions and 45 automated checks.
Dimensions
Discoverability14.5/24
Content Accessibility13.8/24
Bot Access Control0/12
Protocol & Capability Discovery19.3/41
Authentication & Credentials5.8/19
Documentation Quality6.8/10
Structured Data I/O8/13
Observable State & Reliability7.6/15
Agent Safety & Trust6.2/11
Checks
Discoverability
Subdomain sweepsubdomain-sweepBoth an API host and a docs host are live and serve their expected content kind (api.fal.ai, docs.fal.ai).Cross-verified
robots.txtrobots-txtrobots.txt at https://fal.ai/robots.txt declares a sitemap. Declared sitemap https://fal.ai/sitemap.xml resolves as valid XML.Cross-verified
Canonical domaincanonical-domainRoot and www converge on fal.ai, with a matching canonical tag.Cross-verified
sitemap.xmlsitemap-xmlhttps://fal.ai/docs/sitemap.xml is a dated sitemap whose URLs include docs/pricing/api surfaces.Cross-verified
API existenceapi-existenceA real API surface is declared at https://fal.ai/docs/api-reference/platform-apis/openapi/v1.json: the spec lists servers and paths. (source: spec)Parseable
API catalogapi-catalogNo RFC 9727 API Catalog found at /.well-known/api-catalog.Not detected
API versioningapi-versioningThe API version is declared in the spec (info.version) at https://fal.ai/docs/api-reference/platform-apis/openapi/v1.json. (source: spec)Parseable
Content Accessibility
llms.txtllms-txtA curated llms.txt index is published at https://fal.ai/llms.txt: 49 links across 11 sections.Cross-verified
llms-full.txtllms-full-txtAn llms-full.txt with substantial inline content is published at https://fal.ai/llms-full.txt (19,284 chars). To reach the top level, it would need more comprehensive inline coverage.Useful
Freshness signalsfreshness-signalsNo freshness signals found (no Last-Modified, ETag, or sitemap lastmod).Not detected
Crawl-cost estimatecrawl-cost-estimateInformational — not scoredSitemap index declares 3 child sitemap(s) — crawl cost is not directly observable from the index alone.Parseable
ai.txtai-txtNo ai.txt file found (HTML pages at .txt paths do not qualify).Not detected
Raw content extractabilityraw-content-extractabilitySubstantial visible text (6,429 chars) is readable without JavaScript on at least one probed page.Useful
Markdown twinmarkdown-twinA markdown twin is published at https://fal.ai/docs/documentation.md alongside the docs HTML surface (https://fal.ai/docs/documentation).Parseable
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 scoredAn MCP server is described at https://docs.fal.ai/.well-known/mcp.json, but the description doesn't include a web address for the server.Parseable
MCP supportmcp-supportFirst-party documentation at https://fal.ai/docs/documentation/setting-up/mcp identifies the MCP endpoint https://mcp.fal.ai/mcp and explains both its capabilities and how clients connect or authenticate.Cross-verified
SDK availabilitysdk-availabilitySDK libraries page at https://fal.ai/docs/api-reference: 0 GitHub repos, 0 registry links, 0 install commands (0 pointers).Parseable
A2A Agent Carda2a-agent-cardAn A2A Agent Card is described at https://docs.fal.ai/.well-known/agent-card.json, but it is missing required fields (name, description, version, supportedInterfaces, or skills).Parseable
MCP Server Cardmcp-server-cardA file exists at https://docs.fal.ai/.well-known/mcp/server-card.json, but it doesn't contain the fields that describe an MCP Server Card.Detected
DNS-AIDdns-aidNo DNS-AID index found at _index._agents.fal.ai.Not detected
.well-known indexwell-known-indexNo non-owned /.well-known/ descriptors found.Not detected
Auth discoveryauth-discoveryAgent-native auth discovery: a valid RFC 9728 PRM (via challenge) or a PRM plus a valid AS/OIDC descriptor.Cross-verified
GraphQL surfacegraphql-surfaceNo GraphQL transport surface found at conventional paths (GET-only; no introspection issued).Not detected
Link headerslink-headersLink header(s) present with recognized rel values.Parseable
OpenAPI specificationopenapi-specValid OpenAPI 3.1.0 spec at https://fal.ai/docs/api-reference/openapi.json: 3 operations, 3 schemas, 100% response coverage, servers declared.Cross-verified
Rate limit documentationrate-limit-docsRate limiting is mentioned at https://fal.ai/docs/documentation/model-apis/concurrency-limits, but not on a page dedicated to documenting it.Detected
WebMCPwebmcpInformational — not scoredWebMCP browser probing is not yet available in this scanner release.Couldn't verify
Authentication & Credentials
Programmatic auth flowprogrammatic-auth-flowProgrammatic authentication is mentioned at https://fal.ai/docs/documentation/setting-up/authentication, but not on a page dedicated to documenting it.Detected
Auth documentationauth-documentationAuthentication is documented at https://fal.ai/docs/documentation/setting-up/authentication with the specific detail an agent needs — the credential and how it is sent. To reach the top level, it would need to corroborate against another surface or document more than one complete method.Useful
Credential managementcredential-managementNo credential management documentation found at the standard docs locations an agent would check. Blocked by robots.txt for a generic compliant agent (Disallow: /dashboard).Not detected
Sandbox environmentsandbox-environmentA sandbox/testing page exists at https://fal.ai/docs/documentation/model-apis/sandbox, but it doesn't show how to obtain test credentials or a test base URL.Parseable
Documentation Quality
API reference depthapi-reference-depthAn API reference page exists at https://fal.ai/docs/model-api-reference, but it doesn't show parameters with example requests and responses.Parseable
Changelog presencechangelog-presenceA changelog is published at https://fal.ai/docs/changelog with multiple recent dated entries, indicating it is actively maintained.Cross-verified
Structured Data I/O
Structured data I/Ostructured-data-ioThe spec at https://fal.ai/docs/api-reference/platform-apis/openapi/v1.json declares typed, consistent response schemas (100% of operations) with a pagination pattern and a structured error envelope. (source: spec)Cross-verified
Machine-readable pricingmachine-readable-pricingNo machine-readable pricing endpoint found (HTML pricing pages do not qualify).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
Observable State & Reliability
Status & health endpointsstatus-and-healthStatus page found at https://status.fal.ai/ (HTTP 200).Detected
Webhook documentationwebhook-documentationA webhook documentation page exists at https://fal.ai/docs/documentation/model-apis/inference/webhooks, but it doesn't list specific event types with their payload shape.Parseable
Retry & idempotencyretry-and-idempotencyRetry/idempotency is documented at https://fal.ai/docs/documentation/serverless/reliability/retries with an idempotency-key mechanism or a concrete retry strategy. To reach the top level, it would need an idempotency key and backoff/retry guidance together.Useful
Error documentationerror-documentationErrors are documented at https://fal.ai/docs/documentation/model-apis/errors with specific codes or a documented response shape. To reach the top level, it would need recovery guidance and a machine-readable error format, or corroboration against the API spec.Useful
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 legal name, address, support contact, and social profile links.Cross-verified
Metadata consistencymetadata-consistencyHomepage metadata (canonical, Open Graph, schema) is present and consistent.Cross-verified
Legal policy pageslegal-pagesAt least one legal policy page is discoverable.Detected