Agentic Web Protocol — Machine-native contracts for the web

Tools

Everything you need to build, validate, convert, and operate AWP-enabled sites. All tools are open-source, available as npm packages, and require zero configuration.

Interactive Validator

Paste your /.well-known/agentic-web-protocol.json below to validate it against the AWP 1.0 schema. The validator checks all required fields, token budgets, and returns a readiness score out of 100.

CLI ValidationFor server-side validation with live URL support, use the CLI: npx create-awp analyze https://yoursite.com

Token Savings Calculator

See exactly how much money AWP saves by eliminating HTML scraping. Adjust your traffic volume and model selection to get your personalized estimate.

CLI — create-awp

The create-awp CLI is the primary developer interface. It scaffolds AWP files, validates implementations, converts OpenAPI specs, and analyzes live sites.

Install
npm install -g @agentic-web-protocol/cli
# or use without installing
npx create-awp@latest

Commands
# Initialize AWP on your existing project
npx create-awp init

# Analyzes your site and reports readiness score
npx create-awp analyze https://example.com

# Validate a local manifest
npx create-awp validate .well-known/agentic-web-protocol.json

# Convert your OpenAPI spec to AWP functions
npx create-awp convert openapi.yaml --output ./awp/

# Start the dev server (live reload)
npx create-awp dev

init

Scaffold AWP files interactively. Detects Next.js, Express, WordPress, and Shopify.

analyze

Score any live site's AWP readiness. Returns a 0–100 score with actionable fixes.

validate

Validate a local JSON file or live URL against all AWP 1.0 schemas.

convert

Convert OpenAPI 3.x specs to AWP function schemas and MCP tool definitions.

dev

Start a local dev server that live-reloads AWP content on file changes.

deploy

Deploy to Vercel, Netlify, S3, or Cloudflare Pages with one command.

Validator SDK

Use the TypeScript or Python validator SDK to integrate AWP validation directly into your CI/CD pipeline or runtime health checks.

TypeScript
import { validateDiscoveryManifest, scoreAWPReadiness } from "@agentic-web-protocol/validator";

const result = await validateDiscoveryManifest({
  url: "https://example.com/.well-known/agentic-web-protocol.json",
});

if (!result.valid) {
  console.error("Errors:", result.errors);
} else {
  const score = await scoreAWPReadiness("https://example.com");
  console.log("AWP Score:", score.score, "/ 100");
  console.log("Breakdown:", score.breakdown);
}

Python
from agentic_web_protocol import validate_discovery, score_readiness

result = validate_discovery("https://example.com/.well-known/agentic-web-protocol.json")
print("Valid:", result.valid)
print("Errors:", result.errors)

score = score_readiness("https://example.com")
print(f"AWP Score: {score.score}/100")

OpenAPI Converter

Convert any OpenAPI 3.x spec (JSON or YAML) into AWP function schemas and MCP tool definitions. Supports $ref resolution, request body extraction, and parameter mapping.

openapi-converter
# Convert OpenAPI → AWP functions + MCP tools
npx awp-convert-openapi openapi.json --output ./awp/api/

# Output files:
# awp/api/tools/functions.json    — AWP function schema
# awp/api/tools/mcp-tools.json   — MCP tool definitions
# awp/api/openapi.json            — Source spec copy
# awp/api/conversion-summary.json — Stats

What it generates

functions.json — AWP function schema your agents call directly
mcp-tools.json — Ready-to-use MCP tool definitions
openapi.json — Original spec preserved

Content Generator

Auto-generate all AWP content files from any existing website. Scrapes the page, extracts structure, and uses GPT-4o-mini to write token-optimized summaries within the 500-token budget. Works without an API key in scrape-only mode.

content-generator
# Generate AWP content from any website
npx awp-generate-content https://example.com --output ./

# With AI summarization (requires OPENAI_API_KEY)
OPENAI_API_KEY=sk-... npx awp-generate-content https://example.com

# Scrape-only mode (no API key needed)
npx awp-generate-content https://example.com --no-ai

# Output files:
# .well-known/agentic-web-protocol.json
# awp/content/summary.md           (≤500 token AI summary)
# awp/content/structure.json
# awp/instructions.md
# llms.txt