{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "name": "WorldWebDesign Agentic Specification",
  "version": "1.4.0",
  "description": "Machine-actionable interface for AI agents to query web design packages, compute dynamic quotes, submit briefs, run multi-model open AI visibility scans, and perform semantic site search.",
  "mcp_server": {
    "endpoint": "https://worldwebdesing.com/api/mcp",
    "transport": "streamable-http",
    "protocolVersion": "2025-06-18",
    "description": "MCP-native clients (Claude, ChatGPT, Cursor, custom agents) can connect here directly instead of parsing this REST spec. JSON-RPC 2.0, stateless, no auth. Exposes tools: get_packages, get_quote, submit_brief."
  },
  "a2a_protocol": {
    "agent_card": "https://worldwebdesing.com/.well-known/agent-card.json",
    "endpoint": "https://worldwebdesing.com/api/a2a",
    "transport": "JSONRPC",
    "protocolVersion": "0.3.0",
    "description": "A2A (Agent2Agent, Linux Foundation) orchestrators can send a Message to this endpoint and receive a completed Task back. Stateless, no auth. Skills: get_packages, get_quote, submit_brief."
  },
  "acp_commerce": {
    "base_url": "https://worldwebdesing.com/api/acp",
    "spec_version": "2026-04-17",
    "spec_url": "https://agenticcommerce.dev",
    "endpoints": {
      "create": "POST /api/acp/checkout_sessions",
      "retrieve": "GET /api/acp/checkout_sessions/{id}",
      "complete": "POST /api/acp/checkout_sessions/{id}/complete",
      "cancel": "POST /api/acp/checkout_sessions/{id}/cancel"
    },
    "purchasable_item_ids": [
      "landing_page",
      "business_website",
      "custom_build"
    ],
    "auth": "None required.",
    "idempotency": "Idempotency-Key header required on POST, per spec.",
    "payment_collection": "deferred_manual_approval",
    "description": "ACP (Agentic Commerce Protocol, OpenAI + Stripe) checkout surface. Shopping agents can build and price a real project cart. No payment instrument is ever collected: sessions settle at status 'pending_approval' and hand off to a human via continue_url, because this merchant only charges after the design is approved. Each session carries an AP2-style cart mandate in metadata.cart_mandate binding the agent's intent to the priced cart."
  },
  "provider": {
    "name": "WorldWebDesign",
    "url": "https://worldwebdesing.com",
    "founder": "Fatih Sağcan",
    "contact": {
      "whatsapp": "https://wa.me/905455744092",
      "email": "izletenadam@gmail.com"
    }
  },
  "endpoints": {
    "packages": {
      "path": "/api/v1/packages",
      "method": "GET",
      "description": "Retrieve fixed-price website packages, included features, turnaround times, and guarantees."
    },
    "quote": {
      "path": "/api/v1/quote",
      "method": "POST",
      "description": "Calculate an exact price quote and delivery timeline based on page count, required languages, and custom features.",
      "parameters": {
        "pages": "integer (1-20, default 1)",
        "languages": "integer (1-6, default 1)",
        "e_commerce": "boolean (default false)"
      }
    },
    "aeo_scan": {
      "path": "/api/v1/aeo-scan",
      "method": "POST",
      "description": "Execute a live multi-model open AI visibility audit across 6 AI models (Meta Llama 3.3, Nemotron, Mistral Large, DeepSeek V4, Gemma) via NVIDIA NIM.",
      "parameters": {
        "business_name": "string (required)",
        "sector": "string (required)",
        "city": "string (optional)"
      }
    },
    "semantic_search": {
      "path": "/api/v1/semantic-search",
      "method": "GET",
      "description": "Perform natural language semantic site search powered by NVIDIA NIM Llama 3.1.",
      "parameters": {
        "q": "string (search query)"
      }
    },
    "brief": {
      "path": "/api/v1/brief",
      "method": "POST",
      "description": "Submit a structured website brief. Returns confirmation token and pre-filled WhatsApp handoff URL.",
      "parameters": {
        "business_name": "string (required)",
        "business_type": "string (required)",
        "target_audience": "string",
        "desired_pages": "integer"
      }
    },
    "generative_ui": {
      "path": "/api/v1/generative-ui",
      "method": "POST",
      "description": "Compile a live 2027 Generative UI website prototype configuration from natural language prompt via NVIDIA NIM.",
      "parameters": {
        "business_name": "string",
        "prompt": "string (free form business description)"
      }
    }
  },
  "guarantees": {
    "payment": "Pay only after design approval",
    "turnaround": "48 to 72 hours for standard builds",
    "included_tech": [
      "Mobile-first CSS",
      "SEO & Schema.org",
      "LLM/AEO Optimization",
      "NVIDIA NIM Multi-Model AI Engine"
    ]
  }
}