{
  "schema_version": "1.0",
  "name": "AgentWeb Public Action Catalog",
  "url": "https://agentweb.us/.well-known/action-catalog.json",
  "description": "Public catalog of AgentWeb-approved action families, endpoint requirements, auth boundaries, payment rules, and verification semantics for agent scanners.",
  "allowed_actions": [
    {
      "id": "scan_business",
      "status": "public",
      "method": "POST",
      "endpoint": "https://agentweb.us/api/readiness/scan",
      "auth": "none",
      "required_fields": ["url"],
      "optional_fields": ["session_id", "agent_protocol", "discovery_surface", "payment_session_intent", "scan_authorization", "agent"],
      "verification": ["score", "grade", "surfaces", "agent_work_order", "privacy_and_scope_review"],
      "disallowed": ["form_submission", "payment", "credential_collection", "private_account_access"]
    },
    {
      "id": "price_setup",
      "status": "public_metadata",
      "method": "GET",
      "endpoint": "https://agentweb.us/pricing.md",
      "auth": "none",
      "required_fields": [],
      "verification": ["published_terms", "payment_authority_required_for_paid_checkout"],
      "disallowed": ["creating_checkout_without_payment_authority"]
    },
    {
      "id": "create_checkout_session",
      "status": "available_with_payment_authority",
      "method": "POST",
      "endpoint": "https://agentweb.us/api/billing/create-checkout-session",
      "auth": "scoped_payment_authority",
      "required_fields": ["email", "plan", "paymentAuthority"],
      "verification": ["stripe_checkout_url", "webhook_entitlement_after_payment", "receipt_required"],
      "disallowed": ["raw_card_data", "unbounded_spend", "meter_event_reporting_by_external_agents"]
    },
    {
      "id": "mcp_tool_enumeration",
      "status": "public",
      "method": "GET",
      "endpoint": "https://agentweb.us/.well-known/mcp/tools.json",
      "auth": "none",
      "required_fields": [],
      "verification": ["tool_name", "description", "input_schema", "output_schema", "annotations"],
      "disallowed": ["tool_execution_without_key"]
    },
    {
      "id": "execute_mapped_action",
      "status": "design_partner",
      "method": "POST",
      "endpoint": "https://mcp.agentweb.us/mcp",
      "auth": "Authorization: Bearer aw_<key> or OAuth token",
      "required_fields": ["domain", "action", "params"],
      "verification": ["workflow_id", "success", "receipt_or_status_proof", "structured_error"],
      "disallowed": ["unmapped_irreversible_action", "private_payload_without_scope", "payment_without_authority"]
    }
  ],
  "policy": {
    "public_scan_only": true,
    "credentials_never_requested_in_public_scan": true,
    "human_or_customer_approval_required_for_irreversible_actions": true,
    "payment_authority_required": true,
    "receipt_required_for_paid_actions": true,
    "revocation_required_for_delegated_authority": true
  },
  "docs": [
    "https://agentweb.us/api-reference",
    "https://agentweb.us/docs/api",
    "https://agentweb.us/docs/auth-and-limits.html",
    "https://agentweb.us/docs/agent-commerce",
    "https://agentweb.us/docs/scopes",
    "https://agentweb.us/docs/sandbox"
  ]
}