{
  "name": "knowngood",
  "version": "1.8.0",
  "description": "Agentic search engine for AI agents: an index of websites verified usable by agents — every capability probed and tested live, tier 1–3 (declared · probe-verified · behaviourally verified), dated and citable. find_capability answers \"who can do X\"; get_site_report answers \"is this specific host agent-ready\", returning the dated evidence for one site. Nothing is hand-picked and placement cannot be bought: an automated probe decides. Human index of working MCP servers: https://knowngood.sh/mcp-servers",
  "endpoint": "https://knowngood.sh/mcp",
  "transport": "http",
  "tools": [
    {
      "name": "check_webmcp",
      "title": "Check a site for WebMCP tools",
      "description": "Check a website LIVE for WebMCP tools, and where a browser is available whether any tool actually registers when the page runs. Returns one of: registered, declared_only, declared, not_declared, could_not_ask, or excluded when the site's robots.txt refuses AI input. could_not_ask is a distinct answer and is never reported as a no. Tools are listed, never called. Reads only the site named plus published population figures — it does not consult the index, and running it changes no ranking or listing.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The site to check. A hostname or a full URL; https is assumed."
          }
        },
        "required": [
          "url"
        ]
      },
      "annotations": {
        "title": "Check a site for WebMCP tools",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "find_capability",
      "title": "Find agent-ready websites",
      "description": "Find websites where an agent can accomplish a task. Returns probe-verified agent-readiness signals, unverified apparent actions read from page content, the verification tier, how each site was found (it declared agent access, probe discovery, or it was submitted), and a report URL to cite. Returns count:0 with an empty_note when nothing in the index matches — never a nearest guess.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "restName": "q",
            "description": "What you are trying to do, in plain language. Optional when at least one filter is set: with no query the tool lists every listed site matching the filters, in a fixed published order, with `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 (the body is markdown and differs from the HTML), or a .md twin. Omit both class flags for the whole index — the default."
          },
          "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 in a headless browser with a modelContext supplied, and it registered at least one tool. Source-only hosts — the registration code is present but registers nothing when the page runs — are excluded, exactly as an MCP card that never answers is. Results include the registered tool names."
          },
          "limit": {
            "type": "integer",
            "default": 10,
            "maximum": 25
          }
        },
        "required": []
      },
      "annotations": {
        "title": "Find agent-ready websites",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "get_site_report",
      "title": "Fetch one site's verification report",
      "description": "Fetch Known Good's dated verification report for one listed website: which capabilities were tested, which passed, when it was probed, what an agent can apparently do there, and how the site was found: whether it declared agent access, came from probe discovery, or was submitted. Answers \"is this specific host agent-ready?\". Returns found:false for anything not in the index — it never guesses a nearest match. Cite the report URL and its date.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "host": {
            "type": "string",
            "description": "The site's hostname or URL, e.g. example.com"
          }
        },
        "required": [
          "host"
        ]
      },
      "annotations": {
        "title": "Fetch one site's verification report",
        "readOnlyHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      }
    }
  ]
}