{
  "name": "ML-NTWX Agent Intelligence Layer",
  "url": "https://agents.ml-nightworx.io/mcp",
  "transport": "streamable-http",
  "protocol_version": "2025-06-18",
  "implementation_status": "offline-review",
  "availability_note": "Stage B match and read-only MCP tools are implemented for offline review. Commander must merge, redeploy and verify these endpoints before live use. Stage A static discovery remains verified live.",
  "authentication": "none",
  "stateless": true,
  "response_format": "application/json",
  "serverInfo": {
    "name": "ntwx-agent-layer",
    "version": "1.1.0"
  },
  "tools": [
    {
      "name": "list_capabilities",
      "description": "List registry capabilities, optionally filtered by canonical product ID and status.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string",
            "enum": [
              "product:aaas",
              "product:studio",
              "product:dome",
              "product:infra",
              "product:hawk",
              "product:onos"
            ]
          },
          "status": {
            "enum": [
              "live",
              "service-only",
              "registry-only"
            ]
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "capabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "pattern": "^capability:[a-z0-9-]+$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1
                },
                "product_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "live",
                    "service-only",
                    "registry-only"
                  ]
                },
                "callable": {
                  "type": "boolean"
                },
                "tool": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "intent_id": {
                  "type": "string",
                  "pattern": "^intent:[a-z0-9-]+$"
                },
                "description": {
                  "type": "string",
                  "minLength": 1
                },
                "next_action": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "enum": [
                        "visit",
                        "engage",
                        "contact",
                        "read_registry",
                        "clarify",
                        "none"
                      ]
                    },
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "type",
                    "url",
                    "description"
                  ],
                  "additionalProperties": false
                },
                "rules": {
                  "type": "object",
                  "properties": {
                    "aliases": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "requires": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "excluded_terms": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    }
                  },
                  "required": [
                    "aliases",
                    "requires",
                    "excluded_terms"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "name",
                "product_id",
                "status",
                "callable",
                "tool",
                "intent_id",
                "description",
                "next_action",
                "rules"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "capabilities"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_capability",
      "description": "Read a capability by canonical capability ID.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "capability:aaas",
              "capability:studio",
              "capability:dome",
              "capability:infra",
              "capability:hawk",
              "capability:onos",
              "capability:catalogue",
              "capability:support"
            ]
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^capability:[a-z0-9-]+$"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "product_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "enum": [
              "live",
              "service-only",
              "registry-only"
            ]
          },
          "callable": {
            "type": "boolean"
          },
          "tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "intent_id": {
            "type": "string",
            "pattern": "^intent:[a-z0-9-]+$"
          },
          "description": {
            "type": "string",
            "minLength": 1
          },
          "next_action": {
            "type": "object",
            "properties": {
              "type": {
                "enum": [
                  "visit",
                  "engage",
                  "contact",
                  "read_registry",
                  "clarify",
                  "none"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "description": {
                "type": "string",
                "minLength": 1
              }
            },
            "required": [
              "type",
              "url",
              "description"
            ],
            "additionalProperties": false
          },
          "rules": {
            "type": "object",
            "properties": {
              "aliases": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "requires": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "excluded_terms": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1
                }
              }
            },
            "required": [
              "aliases",
              "requires",
              "excluded_terms"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "name",
          "product_id",
          "status",
          "callable",
          "tool",
          "intent_id",
          "description",
          "next_action",
          "rules"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_product",
      "description": "Read a product by canonical product ID.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "enum": [
              "product:aaas",
              "product:studio",
              "product:dome",
              "product:infra",
              "product:hawk",
              "product:onos"
            ]
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^product:[a-z0-9-]+$"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "status": {
            "enum": [
              "live",
              "service-only"
            ]
          },
          "in_scope": {
            "type": "boolean"
          },
          "agent_interface": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "acquisition_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "disambiguation": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "status",
          "in_scope",
          "agent_interface",
          "url",
          "acquisition_url",
          "disambiguation"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "match_capability_to_intent",
      "description": "Use the DEFAULT deterministic router to select navigation, engagement or clarification; no product execution.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "intent": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500,
            "pattern": "\\S"
          },
          "context": {
            "type": "object",
            "properties": {
              "preferred_product": {
                "type": "string",
                "pattern": "^product:[a-z0-9-]+$"
              },
              "allow_service_engagement": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "intent"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "match": {
            "enum": [
              "match",
              "ambiguous",
              "no-match"
            ]
          },
          "capability": {
            "type": [
              "string",
              "null"
            ]
          },
          "product": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "minLength": 1
          },
          "rationale": {
            "type": "string",
            "minLength": 1
          },
          "next_action": {
            "type": "object",
            "properties": {
              "type": {
                "enum": [
                  "visit",
                  "engage",
                  "contact",
                  "read_registry",
                  "clarify",
                  "none"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "description": {
                "type": "string",
                "minLength": 1
              },
              "enquiry_email": {
                "type": "string",
                "const": "enquiries@ml-nightworx.io"
              },
              "candidates": {
                "type": "array",
                "minItems": 1,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "pattern": "^capability:[a-z0-9-]+$"
                }
              }
            },
            "required": [
              "type",
              "url",
              "description"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "match",
          "capability",
          "product",
          "status",
          "rationale",
          "next_action"
        ],
        "additionalProperties": false,
        "allOf": [
          {
            "if": {
              "properties": {
                "match": {
                  "enum": [
                    "no-match",
                    "ambiguous"
                  ]
                }
              }
            },
            "then": {
              "properties": {
                "next_action": {
                  "required": [
                    "enquiry_email"
                  ],
                  "properties": {
                    "url": {
                      "const": "https://aaas.ml-nightworx.io/api/catalogue"
                    }
                  }
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "match": {
                  "const": "ambiguous"
                }
              }
            },
            "then": {
              "properties": {
                "next_action": {
                  "required": [
                    "candidates"
                  ]
                }
              }
            }
          }
        ]
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_engagement_path",
      "description": "List service-only product engagement paths, optionally filtered by canonical product ID. Live products have no service-only engagement path.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "product": {
            "type": "string",
            "enum": [
              "product:aaas",
              "product:studio",
              "product:dome",
              "product:infra",
              "product:hawk",
              "product:onos"
            ]
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "paths": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "product": {
                  "type": "string",
                  "enum": [
                    "product:aaas",
                    "product:studio",
                    "product:dome",
                    "product:infra",
                    "product:hawk",
                    "product:onos"
                  ]
                },
                "name": {
                  "type": "string"
                },
                "next_action": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "enum": [
                        "visit",
                        "engage",
                        "contact",
                        "read_registry",
                        "clarify",
                        "none"
                      ]
                    },
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "type",
                    "url",
                    "description"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "product",
                "name",
                "next_action"
              ],
              "additionalProperties": false
            }
          },
          "enquiry_email": {
            "const": "enquiries@ml-nightworx.io",
            "type": "string"
          },
          "catalogue_url": {
            "const": "https://aaas.ml-nightworx.io/api/catalogue",
            "type": "string"
          }
        },
        "required": [
          "paths",
          "enquiry_email",
          "catalogue_url"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_catalogue",
      "description": "Read the full registry product, capability and indicative-offer catalogue.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string"
          },
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "pattern": "^product:[a-z0-9-]+$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1
                },
                "status": {
                  "enum": [
                    "live",
                    "service-only"
                  ]
                },
                "in_scope": {
                  "type": "boolean"
                },
                "agent_interface": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "acquisition_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "disambiguation": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "id",
                "name",
                "status",
                "in_scope",
                "agent_interface",
                "url",
                "acquisition_url",
                "disambiguation"
              ],
              "additionalProperties": false
            }
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "pattern": "^capability:[a-z0-9-]+$"
                },
                "name": {
                  "type": "string",
                  "minLength": 1
                },
                "product_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "live",
                    "service-only",
                    "registry-only"
                  ]
                },
                "callable": {
                  "type": "boolean"
                },
                "tool": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "intent_id": {
                  "type": "string",
                  "pattern": "^intent:[a-z0-9-]+$"
                },
                "description": {
                  "type": "string",
                  "minLength": 1
                },
                "next_action": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "enum": [
                        "visit",
                        "engage",
                        "contact",
                        "read_registry",
                        "clarify",
                        "none"
                      ]
                    },
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "description": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "type",
                    "url",
                    "description"
                  ],
                  "additionalProperties": false
                },
                "rules": {
                  "type": "object",
                  "properties": {
                    "aliases": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "requires": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    },
                    "excluded_terms": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1
                      }
                    }
                  },
                  "required": [
                    "aliases",
                    "requires",
                    "excluded_terms"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "name",
                "product_id",
                "status",
                "callable",
                "tool",
                "intent_id",
                "description",
                "next_action",
                "rules"
              ],
              "additionalProperties": false
            }
          },
          "offers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "pattern": "^offer:[a-z0-9-]+$"
                },
                "product_id": {
                  "type": "string",
                  "pattern": "^product:[a-z0-9-]+$"
                },
                "currency": {
                  "const": "AUD"
                },
                "indicative_amount": {
                  "type": "integer",
                  "minimum": 0
                },
                "block_0_required": {
                  "const": true
                },
                "is_quote": {
                  "const": false
                },
                "engagement_url": {
                  "type": "string",
                  "minLength": 1
                }
              },
              "required": [
                "id",
                "product_id",
                "currency",
                "indicative_amount",
                "block_0_required",
                "is_quote",
                "engagement_url"
              ],
              "additionalProperties": false
            }
          },
          "conformance": {
            "type": "string"
          }
        },
        "required": [
          "version",
          "products",
          "capabilities",
          "offers",
          "conformance"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ],
  "contacts": {
    "business": "enquiries@ml-nightworx.io",
    "support": "support@ml-nightworx.io"
  }
}