One JSON file.
Site-wide discovery.
AI-Me is an open specification for machine-readable vendor cards — a single JSON document at a well-known endpoint that tells AI agents who you are, what you offer, and how to engage.
Quick Start
Three steps to make your site discoverable by AI agents.
Add your vendor card
Create /.well-known/ai-me.json at your site root.
{
"schema_version": "0.1",
"name": "Your Company",
"website": "https://example.com",
"summary": "What you do, in one sentence.",
"canonical_pages": {
"home": "https://example.com/",
"contact": "https://example.com/contact"
},
"last_updated": "2026-03-05"
}Add llms.txt (recommended)
Create /.well-known/llms.txt and include a pointer to your vendor card URL.
Validate
Run the validator to check your card:
npx @ai-me/validator https://yourdomain.comOr use the online playground.
Why AI agents need vendor cards
Agents need discovery
AI agents can't reliably scrape websites. They need structured, predictable data at a known location to understand what a site offers.
One fetch, full picture
Unlike schema.org (scattered across pages), a vendor card is a single document. One HTTP request gives agents everything they need.
Strict and validatable
A well-defined JSON Schema means cards can be validated automatically. No ambiguity, no guessing.
How AI-Me discovery works
A single well-known endpoint for structured site-wide AI agent discovery.
AI-Me works with existing standards
Complementary to schema.org, llms.txt, MCP, and A2A — not competing.
llms.txt
llms.txt is human-readable guidance for LLMs. AI-Me is machine-readable structured data. Use both: link to your vendor card from llms.txt.
Schema.org
Schema.org is page-level vocabulary for search engines. AI-Me is site-level discovery for agents. Reference your schema.org data via the related field.
MCP
MCP enables tool and data integration. AI-Me handles discovery — point agents to your MCP server via related.mcp.
A2A
A2A enables agent-to-agent communication. AI-Me acts as the discovery layer — link to your A2A agent card via related.a2a.
Adopt the AI-Me specification
Add your vendor card and make your site discoverable by AI agents.
