knowngood.sh

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What you are trying to do, in plain language. Optional when at least one filter is set: with no query every matching listed site is listed, in a fixed order, with a total."
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2, e.g. GB"
    },
    "entity_type": {
      "type": "string",
      "enum": [
        "business",
        "ecommerce",
        "saas",
        "documentation",
        "media",
        "blog",
        "government",
        "education",
        "nonprofit",
        "personal",
        "community",
        "directory",
        "tool",
        "other"
      ]
    },
    "transactional": {
      "type": "boolean",
      "description": "Only sites where an agent can act, not just read"
    },
    "has_mcp": {
      "type": "boolean",
      "description": "Only sites whose MCP server answered tools/list when we tested; results include the tool names"
    },
    "has_md": {
      "type": "boolean",
      "description": "Only sites with verified markdown: negotiation that passed the strict re-grade, or a .md twin"
    },
    "has_endpoint": {
      "type": "boolean",
      "description": "Only sites with a verified endpoint surface (working MCP server or API catalog)"
    },
    "has_webmcp": {
      "type": "boolean",
      "description": "Only sites whose in-page WebMCP tools were runtime-verified: the page was executed and registered at least one tool. Source-only hosts are excluded."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "required": []
}