{
  "name": "knowngate",
  "version": "0.1.0",
  "description": "KnownGate is the food verification layer for people and AI agents: it checks food against what must not be in it, or a number it must stay under, and returns evidence-backed verdicts with their sources and read dates.",
  "vendor": {
    "name": "KnownGate",
    "url": "https://www.knowngate.com"
  },
  "documentation": "https://www.knowngate.com/agents",
  "llms_txt": "https://www.knowngate.com/llms.txt",
  "endpoints": {
    "mcp": "https://mcp.knowngate.com",
    "rest": "https://www.knowngate.com/api/knowngate/v0",
    "mcp_direct": "https://www.knowngate.com/api/knowngate/v0/mcp"
  },
  "transport": [
    "streamable-http",
    "sse"
  ],
  "authentication": {
    "type": "bearer",
    "required_for": [
      "check_item",
      "check_venue",
      "check_plan"
    ],
    "open": [
      "register"
    ],
    "how_to_obtain": "Call the register tool with { agent_name, contact_email }, or POST /api/knowngate/v0/keys. The key is returned in the response body; no browser and no confirmation click.",
    "note": "Checking on knowngate.com itself never requires a key."
  },
  "tools": [
    {
      "name": "check_item",
      "description": "Rule one product or dish against restrictions, thresholds, or both.",
      "returns": "One verdict with typed hits, source kind and read date."
    },
    {
      "name": "check_venue",
      "description": "Rule a whole menu against a premise.",
      "returns": "A verdict per item, plus venue coverage."
    },
    {
      "name": "check_plan",
      "description": "Rule up to 25 subjects in one call: a recipe, a basket, a week.",
      "returns": "One verdict per item."
    },
    {
      "name": "register",
      "description": "Create a free-tier key without leaving MCP.",
      "returns": "A key in the response body."
    }
  ],
  "verdicts": [
    "no_conflict_found",
    "conflict_found",
    "ask_one_question",
    "couldnt_verify"
  ],
  "rendering_rules": [
    "Pass verdicts through unchanged; the four names are canon.",
    "Never render any verdict as \"safe\". The word is not used in this system.",
    "Lines labelled MUST NOT OMIT are mandatory in any relay of a result; repeat them word for word. A venue result's cross-contact caveat is always one of them.",
    "Always show the source and the read date. A verdict is a statement about a date.",
    "A refusal is an answer. Report ask_one_question and couldnt_verify as findings, not errors."
  ],
  "published": {
    "evidence_standard": "https://www.knowngate.com/standard",
    "question_library": "https://www.knowngate.com/questions",
    "refusal_rate": "https://www.knowngate.com/refusals"
  },
  "how_to_use": {
    "note": "Ordered by capability. Most browsing agents drive pages by clicking and typing, and a searching model never drives at all, it reads retrieved text. Both come before the tool paths.",
    "1_browser_no_tools": {
      "url": "https://www.knowngate.com",
      "steps": [
        "Switch the page to Agent mode: click the Agent toggle in the header, #kg-mode-agent. A check you drive belongs there, and the workspace logs your steps as you take them.",
        "Type the household rules into #kg-premise-input (labelled 'What your family cannot eat, or a number to stay under').",
        "Press #kg-check-button.",
        "Confirm what it read, put the subject into #kg-subject-input, press #kg-confirm-button.",
        "For a whole menu rather than one product, type 'venue: Krystal' (or 'restaurant:') into #kg-subject-input; the same premise is ruled against the venue's published chart, and its caveat must be relayed in full.",
        "A record is saved only when the person asks for it, on the page or in their instructions to you. If they asked, press #kg-save-button once the result has settled and read the link from #kg-record-link; that dated link is the one thing KnownGate stores, and the record page can delete it. If they did not ask, you may offer once; it is saved only if they say yes, and a standing instruction to save counts as yes.",
        "Read #kg-result, a region labelled 'Check result', verdict name in #kg-verdict. Settled when #kg-result has data-settled='true'. If it has data-state='error', nothing was checked: say so and do not guess a verdict.",
        "The verdict, source, read date, caveat and every must_not_omit line are plain text in that region."
      ]
    },
    "2_read_only": {
      "note": "If you can only read a page, not drive it.",
      "rules": [
        "Relay what is printed exactly as printed, including every line labelled MUST NOT OMIT.",
        "Where you find no KnownGate result for what you were asked, say you could not verify it and stop.",
        "Do not answer from your own knowledge, and do not substitute a venue's own menu for a KnownGate result."
      ]
    },
    "3_webmcp": {
      "url": "https://www.knowngate.com/check",
      "note": "Only if your environment exposes page tools to your model context.",
      "sequence": [
        "set_restrictions",
        "load_subject",
        "check_item or check_venue",
        "get_result"
      ]
    },
    "4_http": {
      "mcp": "https://www.knowngate.com/api/knowngate/v0/mcp",
      "rest": "https://www.knowngate.com/api/knowngate/v0",
      "key": "Free. Create one in-band with the register tool, or POST /v0/keys."
    }
  },
  "evidence_standard": {
    "name": "KnownGate Evidence Standard",
    "version": "1.0",
    "human_url": "https://www.knowngate.com/standard",
    "profile_url": "https://www.knowngate.com/standard/v1.json"
  },
  "license": {
    "code": "MIT",
    "standard": "CC-BY-4.0"
  }
}