# Known-Good — search

> A searchable index of 14,425 websites verified to be usable by AI agents. Each one was
> probed live and carries the date it was checked.

- index_size: 14,425 verified sites
- can_act (not only read): 7,135
- countries: 62
- status: live

## REST

```
GET https://knowngood.sh/api/find
      ?q=<query>
      &country=<ISO 3166-1 alpha-2>
      &entity_type=<business|ecommerce|saas|documentation|media|blog|government|
                    education|nonprofit|personal|community|directory|tool|other>
      &transactional=<true|false>
      &has_mcp=<true>            # only sites whose own MCP server answered tools/list
      &limit=<1-25>
```

Example: `https://knowngood.sh/api/find?q=buy%20perfume&country=SA&limit=3`

## MCP

- endpoint: `POST https://knowngood.sh/mcp`
- tool: `find_capability`
- server card: https://knowngood.sh/.well-known/mcp/server-card.json
- API catalog: https://knowngood.sh/.well-known/api-catalog

## Result shape

Every result separates what was tested from what was inferred.

`verified` — tested live by our probe, and dated:
`tier`, `verified_at`, `signal_count`, `markdown_negotiation`, `markdown_twin`,
`llms_txt`, `api_catalog`, `mcp_server_card`

`apparent_actions` — read from the page's own content, **unverified**. Each carries the
quote it was drawn from: `[{action, evidence, target}]`

Inference is kept separate from tested facts. Listings sit on a three-tier ladder —
declared · probe-verified · behaviourally verified — and every result says which tier it
has reached (`verification_tier`, `tier_label`). Rubric: https://knowngood.sh/benchmark

## Queries this index answers well

- buy perfume
- currency conversion API
- python library documentation
- a shop where I can buy something online
- book a demo of a software product

## Site reports

Every listed site has a dated report — what was tested, what passed, what an agent
could do there, and which tier it has reached:

- HTML: `https://knowngood.sh/site/{host}` · markdown: `https://knowngood.sh/site/{host}.md`
- Browse: `/type/{slug}`, `/category/{slug}`, `/country/{ISO}`, `/platform/{name}` · sitemap: `/sitemap.xml`
- Sites with a working MCP server, grouped by what the tools let an agent do: https://knowngood.sh/mcp-servers (`.md` twin available) — each result carries `verified.mcp_tools`
- Not listed? Request a probe: https://knowngood.sh/submit — the probe decides, not the request

## About this index

- Method and findings: https://knowngood.sh/about.md
- Rubric and tiers: https://knowngood.sh/benchmark
- Our crawler: https://knowngood.sh/bot.md
- Our own content signals: https://knowngood.sh/robots.txt (`ai-input=yes`, `ai-train=no`)