Agent Ardvark, aardvark detective

Case files · Agentic Resource Discovery

Agent Ardvark

AI agents are out there looking for websites like yours.
I find out whether they can find you. Then we fix it.

Open a case

I will call at /.well-known/ai-catalog.json on the premises and inspect whatever I find against the official ARD specification.

or hand me the paperwork directly

Draft your papers

Answer in plain English. I type up a valid ai-catalog.json as you go. No account, nothing stored, nothing leaves your browser.

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 come back to the Investigate tab and I will confirm the job is done.

  







  
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.