AGENT ARDVARK ARD spec v1.0

AI agents are looking for websites like yours.
Can they find you?

The new open standard from Google, Microsoft and Hugging Face decides which sites AI agents can discover. I check yours against it in seconds, free.

no signup · nothing stored · or paste a file / draft one from scratch

02

Draft your papers

Answer in plain English. I type up a valid ai-catalog.json as you go. Everything happens in your browser.

03

The finished file


  
  

  

    Where do I put this file?
    
It must be reachable at https://yourdomain.com/.well-known/ai-catalog.json. The folder is literally called .well-known, dot included.

    
    
      
  • Cloudflare Pages / Netlify / Vercel: put the file at .well-known/ai-catalog.json inside your published folder and redeploy.
    • 
      
  • WordPress: upload via your host's file manager or FTP into a .well-known folder in the site root (the same level as wp-content).
    • 
      
  • Shopify / Squarespace / Wix: these do not let you upload root files directly yet. Ask support about serving a .well-known path, or proxy it through Cloudflare.
    • 
      
  • Any Linux server: drop it in your web root, e.g. /var/www/html/.well-known/ai-catalog.json.
    • 
    

    
Then run the check at the top and I will confirm the job is done.

  







  
04
Hand me the paperwork directly

  
Already have a catalog file? Paste it here and I examine it against the official schema, entirely in your browser.

  

    
    
  







  
05
The situation, briefly

  
AI assistants increasingly act as agents: they book, buy, compare and research on a person's behalf. In 2026, Google, Microsoft and Hugging Face published Agentic Resource Discovery (ARD), a standard way for a website to declare what it offers in a form agents can read: one small file at /.well-known/ai-catalog.json.

  
Sites that publish the file can be discovered and used by agents. Sites that do not are, to an agent, a locked shop with no sign. I check the lock, and I write the sign.

  
Is this official? Who are you?
    
The ARD specification is real and open, developed by Google, Microsoft and Hugging Face with collaborators including Cisco, GitHub, Nvidia and Salesforce. Agent Ardvark is an independent free tool built on the official spec and its published JSON Schema. Not affiliated with the ARDS project. No data is stored; domain checks pass through this site's server only to fetch the file, and pasted or generated files never leave your browser.