Make your site understandable to every AI.

npx -p @ai2web/validator ai2web validate https://your-site.com

npm install @ai2web/core       # types, builder, validation, discovery
npm install @ai2web/server     # /ai2w route handler (Node + Cloudflare)
npm install @ai2web/mcp-bridge # expose your capabilities as an MCP server

npm install @ai2web/core       # ships as ESM with bundled types, no build step
npm install @ai2web/server     # /ai2w route handler (Node + Cloudflare)
# Or drop the build-free <ai2w-badge> web component into any page, no bundler.

npm install @ai2web/core @ai2web/react
# hooks: useDiscover / useValidate / useNegotiate + <Ai2wBadge/>

pip install ai2web

composer require ai2web/ai2web

go get github.com/ai2web-foundation/ai2web-go

dotnet add package Ai2Web

gem install ai2web

# Install the "AI2Web" plugin from the WordPress admin, then enable it.
# It serves /ai2w automatically from your posts, products and pages.

import { ai2web, validateManifest } from "@ai2web/core";

const manifest = ai2web({ name: "Northwind", url: "https://northwind.com", type: "ecommerce" })
  .capability("content")
  .capability("commerce", { endpoint: "/ai2w/products", checkout: true })
  .capability("search", { endpoint: "/ai2w/search" })
  .transports({ mcp: { enabled: true, endpoint: "/ai2w/mcp" }, rest: { enabled: true } })
  .auth({ methods: ["none", "oauth2"], oauth2: { pkce: true, scopes: ["checkout"] } })
  .consent({ requires_user_approval_for: ["purchase"] })
  .contact({ support: "[email protected]" })
  .build();

const { score, tier } = validateManifest(manifest); // 100, "Enterprise"

import { ai2web, validateManifest } from "@ai2web/core";

// The packages ship as standard ESM, so plain JavaScript works unchanged.
const manifest = ai2web({ name: "Northwind", url: "https://northwind.com", type: "ecommerce" })
  .capability("content")
  .capability("commerce", { endpoint: "/ai2w/products", checkout: true })
  .transports({ mcp: { enabled: true, endpoint: "/ai2w/mcp" }, rest: { enabled: true } })
  .contact({ support: "[email protected]" })
  .build();

console.log(validateManifest(manifest).score); // 90+

import { Ai2wBadge, useValidate } from "@ai2web/react";

export function Readiness() {
  // Fetches /ai2w for the URL and scores it, live.
  const { result, loading } = useValidate("https://northwind.com");

  if (loading) return <span>Scanning...</span>;
  return (
    <div>
      <Ai2wBadge url="https://northwind.com" />
      <p>Score: {result?.score}/100 - {result?.tier}</p>
    </div>
  );
}

from ai2web import Manifest, validate_manifest

manifest = (
    Manifest.for_site("Northwind", "https://northwind.com", "ecommerce")
    .capability("content")
    .capability("commerce", {"endpoint": "/ai2w/products", "checkout": True})
    .capability("search", {"endpoint": "/ai2w/search"})
    .transports({"mcp": {"enabled": True, "endpoint": "/ai2w/mcp"}, "rest": {"enabled": True}})
    .auth({"methods": ["none", "oauth2"], "oauth2": {"pkce": True, "scopes": ["checkout"]}})
    .consent({"requires_user_approval_for": ["purchase"]})
    .contact({"support": "[email protected]"})
    .build()
)

result = validate_manifest(manifest)   # {"score": 100, "tier": "Enterprise", ...}

use Ai2Web\Manifest;
use Ai2Web\Validator;

$manifest = Manifest::forSite('Northwind', 'https://northwind.com', 'ecommerce')
    ->capability('content')
    ->capability('commerce', ['endpoint' => '/ai2w/products', 'checkout' => true])
    ->capability('search', ['endpoint' => '/ai2w/search'])
    ->transports(['mcp' => ['enabled' => true, 'endpoint' => '/ai2w/mcp'], 'rest' => ['enabled' => true]])
    ->auth(['methods' => ['none', 'oauth2'], 'oauth2' => ['pkce' => true, 'scopes' => ['checkout']]])
    ->consent(['requires_user_approval_for' => ['purchase']])
    ->contact(['support' => '[email protected]'])
    ->build();

$result = Validator::validate($manifest);   // ['score' => 100, 'tier' => 'Enterprise']

import "github.com/ai2web-foundation/ai2web-go"

manifest := ai2web.ForSite("Northwind", "https://northwind.com", "ecommerce").
    Capability("content", true).
    Capability("commerce", map[string]any{"endpoint": "/ai2w/products", "checkout": true}).
    Capability("search", map[string]any{"endpoint": "/ai2w/search"}).
    Transports(map[string]any{
        "mcp":  map[string]any{"enabled": true, "endpoint": "/ai2w/mcp"},
        "rest": map[string]any{"enabled": true},
    }).
    Auth(map[string]any{"methods": []string{"none", "oauth2"}, "oauth2": map[string]any{"pkce": true}}).
    Consent(map[string]any{"requires_user_approval_for": []string{"purchase"}}).
    Contact(map[string]any{"support": "[email protected]"}).
    Build()

result := ai2web.Validate(manifest)   // score 100, tier "Enterprise"

using Ai2Web;

var manifest = Manifest.ForSite("Northwind", "https://northwind.com", "ecommerce")
    .Capability("content")
    .Capability("commerce", new() { ["endpoint"] = "/ai2w/products", ["checkout"] = true })
    .Capability("search", new() { ["endpoint"] = "/ai2w/search" })
    .Transports(new() {
        ["mcp"]  = new Dictionary<string, object?> { ["enabled"] = true, ["endpoint"] = "/ai2w/mcp" },
        ["rest"] = new Dictionary<string, object?> { ["enabled"] = true },
    })
    .Auth(new() { ["methods"] = new[] { "none", "oauth2" } })
    .Consent(new() { ["requires_user_approval_for"] = new[] { "purchase" } })
    .Contact(new() { ["support"] = "[email protected]" })
    .Build();

var result = Validator.Validate(manifest);   // Score 100, Tier "Enterprise"

require "ai2web"

manifest = Ai2Web.ai2web(name: "Northwind", url: "https://northwind.com", type: "ecommerce")
  .capability("content")
  .capability("commerce", endpoint: "/ai2w/products", checkout: true)
  .capability("search", endpoint: "/ai2w/search")
  .transports(mcp: { enabled: true, endpoint: "/ai2w/mcp" }, rest: { enabled: true })
  .auth(methods: %w[none oauth2], oauth2: { pkce: true, scopes: ["checkout"] })
  .consent(requires_user_approval_for: ["purchase"])
  .contact(support: "[email protected]")
  .build

result = Ai2Web.validate(manifest)   # { score: 100, tier: "Enterprise", ... }

The AI2Web plugin generates your manifest automatically. No code required:

1. Install and activate the "AI2Web" plugin.
2. It maps your content, WooCommerce products and pages to capabilities.
3. /ai2w and /.well-known/ai2w go live instantly, scored 100/100.
4. Optional: enable Agent checkout and OAuth2 + PKCE in Settings -> AI2Web.

Works with WordPress 7.0 native AI (Abilities API + AI Client).

import { cloudflareHandler } from "@ai2web/server";

// One handler serves /ai2w, /.well-known/ai2w, actions, and the
// /llms.txt + /.well-known/agent.json projections from a single manifest.
export default cloudflareHandler({ manifest });

import { createServer } from "node:http";
import { nodeListener } from "@ai2web/server";

// Serves /ai2w, the well-known anchor, actions and the llms.txt +
// agent.json projections from one manifest.
createServer(nodeListener({ manifest })).listen(3000);

from ai2web import handle

# Framework-agnostic: hand it the request method + path, get status/headers/body.
res = handle({"manifest": manifest}, request.method, request.path)
return Response(res["body"], status=res["status"], headers=res["headers"])

use Ai2Web\Server;

$res = Server::handle(['manifest' => $manifest],
    $_SERVER['REQUEST_METHOD'],
    parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));

http_response_code($res['status']);
foreach ($res['headers'] as $k => $v) { header("$k: $v"); }
echo json_encode($res['body']);

res := ai2web.Handle(
    ai2web.ServerOptions{Manifest: manifest},
    r.Method, r.URL.Path, nil, "",
)
for k, v := range res.Headers {
    w.Header().Set(k, v)
}
w.WriteHeader(res.Status)
json.NewEncoder(w).Encode(res.Body)

using Ai2Web;

var res = Server.Handle(manifest, ctx.Request.Method, ctx.Request.Path);

ctx.Response.StatusCode = res.Status;
foreach (var (k, v) in res.Headers) ctx.Response.Headers[k] = v;
await ctx.Response.WriteAsJsonAsync(res.Body);

GET  /.well-known/ai2w   discovery anchor (required) - carries or points to the manifest
GET  /ai2w               the capability manifest (recommended canonical endpoint)
GET  /ai2w/mcp           MCP transport for actions and tools
GET  /llms.txt           projection for llms.txt-aware agents
GET  /.well-known/agent.json  projection for agent.json-aware agents
POST /ai2w/negotiate     capability + transport negotiation

Scan your site at ai2web.dev/validator, then click "Add to directory".
The backend verifies your live manifest before listing - one click, no account.

import { createAi2wHandler } from "@ai2web/server";

// Announces this origin to the directory once, on its first discovery serve.
export default createAi2wHandler({ manifest, announce: true });

curl -X POST https://directory.ai2web.dev/register \
  -H 'content-type: application/json' \
  -d '{"url": "https://your-site.com"}'

# Add the network connector once - then find + use any AI-ready site.
claude mcp add ai2web --transport http https://connector.ai2web.dev/mcp

# Or add https://connector.ai2web.dev/mcp as a custom connector in the Claude app.

Point your MCP client at:  https://connector.ai2web.dev/mcp

Tools:
  find_sites(capability?, type?, q?)   discover AI-ready sites
  describe_site(url)                    read its capabilities + actions
  call_site_action(url, action, input, confirm?)   invoke an action