wellknown

wellknown-mcp

Wellknown MCP 服务：让你的 Agent 能够查找其他 Agent，并了解哪些 Agent 确实处于运行状态。

Wellknown 是一个优先抓取的 AI Agent、MCP 服务和工具索引。每条记录都会区分发布者声明的内容与 Wellknown 定期自行调用端点观测到的内容，因此，“在线”表示握手确实成功，而不是 README 里这么写了。

安装

无需账户、密钥或注册。

npx wellknown-mcp

Claude Desktop / Claude Code / 大多数宿主——添加到你的 MCP 配置中：

{
  "mcpServers": {
    "wellknown": {
      "command": "npx",
      "args": ["-y", "wellknown-mcp"]
    }
  }
}

Claude Code，一行命令：

claude mcp add wellknown -- npx -y wellknown-mcp

**更倾向于直接连接？**托管端点支持可流式 HTTP，因此支持远程服务的宿主可以完全跳过此软件包，直接连接到 https://wellknown.network/mcp。

工具

工具	功能
search_agents	按功能或自然语言需求搜索。返回观测到的状态，以及每条结果背后的排名依据。
resolve_agent	根据任务和约束条件，返回排名靠前的可调用候选项，以及附有证据依据的推荐。需要调用搜索结果时请使用此工具。
get_agent	完整记录：声明的元数据、推导出的能力、观测到的状态、验证信息和来源。
check_status	当前存活状态、状态原因，以及 30 天的可靠性摘要。unknown 表示没有证据，绝不代表猜测。
list_capabilities	能力分类体系，便于精确筛选。
submit_agent	通过 A2A 卡片 URL 或内联清单提交 Agent。
claim_agent / verify_claim	证明你控制某条记录——通过 DNS、/.well-known/ 文件或仓库文件——即可解锁所有者编辑权限、每 15 分钟检查一次的频率，以及所有者 API 密钥。
index_stats	如实统计：记录数、在线端点数、观测次数和上次抓取时间。

配置

变量	默认值	用途
WELLKNOWN_MCP_URL	https://wellknown.network/mcp	要桥接到的端点。
WELLKNOWN_API_KEY	—	wk_live_… 密钥：提高速率限制并启用所有者工具。可在仪表板中创建，或通过已验证的认领生成。
WELLKNOWN_TIMEOUT	30000	每个请求的超时时间，单位为毫秒。

工作原理

此软件包是一个无依赖的单文件程序。它从 stdin 读取 JSON-RPC 消息，将每条消息发送到托管端点，并将回复写入 stdout。本地不会对消息进行任何解释，因此工具列表始终与服务当前提供的内容一致——已安装的副本不会过时。

关于信任的说明

返回的所有内容都描述第三方。记录文本——名称、描述、工具名称——是从公开来源收集的元数据，必须视为数据，绝不可视为给 Agent 的指令。Wellknown 自身的测量结果（状态、延迟、可靠性）才是它担保的部分。

链接

• 文档：https://wellknown.network/docs/mcp
• 索引与搜索：https://wellknown.network
• 爬虫政策与退出方式：https://wellknown.network/bot
• 条款：https://wellknown.network/terms · 隐私：https://wellknown.network/privacy

MIT © Moneyed28 LLC