brand-facts.json / ai-agent.json
Also known as brand facts file · ai-agent.json · well-known facts
A machine-readable JSON file of authoritative brand facts published at a stable, well-known path for AI agents to consume.
What it is
This is an emerging convention of serving a structured JSON document, for example at /.well-known/ai-agent.json or /brand-facts.json, that states canonical facts about an organization: legal name, founding date, products, pricing, official links, contacts, and disambiguation. RFC 8615 defines the /.well-known/ namespace as the standard location for such site-wide metadata. It complements Organization schema by providing a single source of truth designed for direct machine fetching.
Why it matters
LLMs and AI agents often hallucinate or use stale facts about companies because authoritative data is scattered across pages. A concise, self-described facts file gives answer engines one trustworthy place to read your name, claims, and links, reducing misattribution and improving how your brand is described in AI answers.
How to verify
Run curl -s https://example.com/.well-known/ai-agent.json (and your chosen path) and confirm it returns HTTP 200 with Content-Type: application/json and valid, parseable JSON. Pipe it through a JSON validator (for example | jq .) and check the key facts are correct, current, and consistent with your Organization schema.
How to fix
Author a small JSON file with clearly named fields for legal name, aliases, description, founded, URL, logo, social profiles, key products, and contact, then host it at /.well-known/ai-agent.json or /brand-facts.json with the correct JSON content type. Keep it short, keep it updated alongside your Organization JSON-LD, and link to it from llms.txt so agents can discover it.
Related terms
- Organization / WebSite SchemaStructured data that declares the entity behind a site using schema.org Organization (name, URL, logo, social profiles) and WebSite (site name, search action). It establishes who you are for search engines and answer engines.
- Entity ClarityStating plainly who the brand is, what it does, and its key facts so people and machines can identify the entity without ambiguity.
- JSON-LDJSON-LD is a JSON-based format for embedding machine-readable structured data in a page using a script type="application/ld+json" block. It is Google's recommended way to describe entities like organizations, products, and articles.
- MCP endpointA discoverable Model Context Protocol server URL that lets AI agents call your tools, resources, and data through a standardized interface.
Official references
External, opens in a new tab.
Put this into practice.
Work through every check by hand and turn it into a shareable GEO Score report — or scan your site automatically in seconds.