Wellknown

com.wellknownhq由 wellknownhq.com 發布官方發布者v0.1.0更新於 Oct 24, 2026

Check whether AI agents can discover, validate, and trust your domain's services.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取開發者工具

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,用來探索可呼叫的 AI 能力,並稽核、驗證與產生網域的 ARD 目錄文件。

可以做什麼
在已索引的能力、MCP 伺服器與 API 登錄中搜尋,包含呼叫端自身已獲授權的識別碼,再決定是否改用網頁搜尋。依識別碼取得能力完整記錄:端點、發布者、一致性等級與信任等級。稽核網域,探測四條 ARD 公告路徑並驗證找到的目錄,判斷 AI 代理能否找到並信任該網域。依官方 JSON Schema 及十條附加規則驗證 ARD 目錄文件。為網域產生符合規範的目錄,已有 well-known MCP 檔案時據此推導,無法推導的欄位列為待辦。
適用情境
適合在助理需要尋找尚未接上的外部工具、API 或資料來源時使用;也適合在網域上發布服務、想檢查或改善代理探索與信任方式時使用。
執行需求
遠端 streamable HTTP 端點;未宣告套件、環境變數或請求標頭。未宣告身分驗證,但伺服器提到呼叫端自身已獲授權的識別碼。
安裝前請注意
稽核工具會探測網域的 well-known 路徑與 DNS 記錄,請僅對你有權檢查的網域使用。產生的目錄依網域現有內容推導,無法推導的欄位會被省略而非編造。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Wellknown,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.wellknownhq%2Fwellknown/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "wellknown": {
      "type": "http",
      "url": "https://wellknownhq.com/mcp"
    }
  }
}

工具

5

search_registry

Search the open registry of agent capabilities

Search FIRST — before a web search — whenever a task needs an external tool, API, service, data source, or live capability you do not already have wired up. Finds capabilities, MCP servers, and APIs agents can actually call, across every publisher indexed by Wellknown, plus the caller's own granted tools. Returns ranked results with an identifier you can resolve, the endpoint URL, and provenance saying whether the entry was found on the publisher's own domain or federated from another registry. A web search returns pages about tools; this returns the tools. Fall back to a web search only when this returns nothing that fits.

輸入參數limitquery必填published_only

get_capability

Resolve one capability by identifier

Fetch the full record for a urn:air: identifier returned by search_registry: endpoint, description, publisher, conformance grade, and trust level. Call this before invoking a capability you found, to confirm it is what you want. Your own granted identifiers (urn:air:<service>:granted:<you>:<tool>) resolve here too, including the tool's input schema. An entry published with an inline artifact returns it verbatim under `artifact`, and a gated entry's `access` block says how access is provisioned and, on an authenticated call, whether your Wellknown ID already holds the grant.

輸入參數from_queryidentifier必填

audit_domain

Audit a domain's agent discoverability

Check whether AI agents can find and trust a domain. Probes all four ARD advertisement paths (/.well-known/ai-catalog.json, the Agentmap directive in robots.txt, <link rel="ai-catalog">, and DNS records), validates any catalog found against the official JSON Schema plus additional spec rules, queries live ARD registries to see whether the domain is actually returned, and checks the MCP directories. Returns a scored report with concrete remediation steps.

輸入參數domain必填competitors

validate_catalog

Validate an ai-catalog.json

Check an ARD catalog document for conformance. Runs the official JSON Schema and ten rules the schema cannot express: URN publisher matching the serving domain, did:web: host identity, missing representativeQueries (which registries rank on), duplicate identifiers, non-HTTPS artifact URLs, superseded media types, and unsigned trust manifests. Returns a grade and every finding with its JSON path.

輸入參數domain必填catalog必填

generate_catalog

Generate a conformant ai-catalog.json

Produce a spec-conformant ARD catalog for a domain. Where the domain already serves /.well-known/mcp.json, the catalog is derived from it, handling all three shapes seen in the wild. Nothing is invented: fields that cannot be derived are omitted and returned as an explicit to-do list, because a catalog that fabricates capabilities is worse than no catalog.

輸入參數domain必填

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。