Implementations

Reference code, live sites, and how to get started

Reference Implementations

Reference

Rootz AI Discovery Plugin

By Rootz Corp · WordPress

Full three-tier implementation for WordPress. Auto-generates ai.json, knowledge, feed, content, and policies from existing site data. Includes plugin wallet for cryptographic signing, AI proxy for content generation, WebMCP tool registration, and analytics dashboard.

Reference

rootz.global Static Implementation

By Rootz Corp · Express.js + Static JSON

Hand-crafted static JSON files served via Express.js. Demonstrates the full specification including all three tiers, cryptographic signing with content hashes, and WebMCP tools. The reference that all other implementations validate against.

Enterprise

Veritize™ Platform

By Made in USA Inc. · Managed Service

Enterprise managed implementation with AI readiness scanning, certification scoring (13 checks / 120 points), monitoring, and compliance reporting. Deployed for government and regulated industries through existing contracts.

Live Implementations

Sites currently serving /.well-known/ai in production.

Rootz Global

rootz.global/.well-known/ai
Full v1.2: Discovery + Knowledge + Feed. Static JSON with cryptographic signing. WebMCP tools active. Content hashes on all pages.
Scan this site →

Made in USA Inc.

home.miusa.one/.well-known/ai
Enterprise implementation via Veritize platform. Discovery + Knowledge + Feed. Scanner and certification tools.
Scan this site →

Rootz Lab Site

discover.rootz.global/.well-known/ai
WordPress plugin v2.1.1. Full auto-generated implementation. Plugin wallet signing. AI access metrics. Content endpoint with assertion types.
Scan this site →

Epistery Dev

dev.epistery.host/.well-known/ai
Agent platform implementation. Discovery tier with signing infrastructure. Demonstrates AI proxy service integration.
Scan this site →

Getting Started

Option 1: WordPress (2 minutes)

1

Install the Plugin

Search "Rootz AI Discovery" in the WordPress plugin directory, or download from rootz.global/ai-discovery.

2

Fill In Your Identity

Go to Settings > AI Discovery. Enter your organization name, mission, and sector. Click "Auto-Populate with AI" to generate descriptions from your existing content.

3

Verify

Visit yoursite.com/.well-known/ai to see your manifest. Scan your site at rootz.global/ai-discovery to check your score.

Option 2: Static JSON (Any Server)

1

Create the JSON File

Create ai.json with your organization's identity. A minimum implementation is 10 lines:

{
  "$schema": "https://rootz.global/ai/schemas/ai-discovery-v1.json",
  "specVersion": "1.2.0",
  "standard": "rootz-ai-discovery",
  "generated": "2026-02-27T00:00:00Z",
  "organization": {
    "name": "Your Company",
    "domain": "yourcompany.com",
    "mission": "What your company does, in one sentence.",
    "sector": ["your-industry"]
  },
  "coreConcepts": [
    {
      "term": "Your Key Term",
      "definition": "What this means in your context."
    }
  ]
}
2

Serve It at the Right Path

Configure your web server to serve ai.json at /.well-known/ai with:

  • Content-Type: application/json
  • Access-Control-Allow-Origin: *

Nginx:

location = /.well-known/ai {
    alias /var/www/yoursite/ai.json;
    default_type application/json;
    add_header Access-Control-Allow-Origin *;
}

Apache:

RewriteRule ^\.well-known/ai$ /ai.json [L]
<Files "ai.json">
    Header set Content-Type "application/json"
    Header set Access-Control-Allow-Origin "*"
</Files>
3

Add the HTML Link Tag

Add to every page's <head>:

<link rel="ai-discovery" type="application/json"
      href="/.well-known/ai"
      title="AI Discovery Standard">
4

Scan and Verify

Visit rootz.global/ai-discovery to scan your site and see your score. Add knowledge, feed, and content endpoints to increase your tier.

Option 3: Enterprise (Managed)

For organizations that want a managed implementation with certification, monitoring, and compliance reporting, Made in USA Inc. offers the Veritize™ platform. They handle the implementation, you get certified.

Tools & Resources

Scanner

Scan any URL to check its AI Discovery implementation. Scores across 8 categories, A-F grade, with specific recommendations.

Scan a site →

JSON Schema

Validate your ai.json against the official schema. Catches missing required fields, incorrect types, and structural issues.

Download schema →

Specification

The full v1.2 specification in markdown format. CC-BY-4.0 licensed. Use it as your implementation reference.

Read the spec →