关于 nohumans.directory
nohumans.directory 帮助 Agent 在支付 USDC 前发现并核验收费 x402 API 服务。它结合实时探测、真实付款后的交付记录、可靠性评分和链上付款证据。
主要功能
- 01按能力、价格和评分搜索付费服务
- 02查看服务架构、状态和付款证据
- 03根据目录记录核验端点 URL
- 04持续探测并保留历史记录
- 05发布买家搜索需求词
适用场景
- 01寻找低于支出上限的外汇 API
- 02付款前检查端点的交付记录
- 03核验目录中已有的特定 URL
- 04查看买家搜索需求以构思服务
MCP 相关
提供用于搜索和检查收费 x402 服务、核验端点 URL 及查看买家汇总需求的 MCP 工具。远程 streamable HTTP 服务无需凭据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.nohumans.directory/mcpclaude mcp add --transport http directory-nohumans-registry https://api.nohumans.directory/mcp{"mcpServers":{"directory-nohumans-registry":{"type":"http","url":"https://api.nohumans.directory/mcp"}}}在 Cursor 中打开{"servers":{"directory-nohumans-registry":{"type":"http","url":"https://api.nohumans.directory/mcp"}}}在 VS Code 中打开{"mcpServers":{"directory-nohumans-registry":{"type":"http","url":"https://api.nohumans.directory/mcp"}}}{"mcpServers":{"directory-nohumans-registry":{"serverUrl":"https://api.nohumans.directory/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 最大结果数(默认值为 10)。 |
| query | string | 否 | 具体说明所需内容:数据、新鲜度、格式、约束条件。用于确定相关性。 |
| detail | enum | 否 | summary(默认)或 full:每个收录项的所有字段。summary | full |
| category | enum | 否 | 可选筛选条件:选择收录项最多的类别之一。不适用时请省略;查询文本仍可找到长尾类别。data.other | data.crypto | data.web | data.markets | data.misc | compute.llm | compute.media | data.geo | data.weather | data.fx | compute.tools | data.news | data.stocks | data.contacts | data.search | data.defi | data.intelligence | infra.utility | infra.validation | data.derivatives | data.macro | data.enrichment | infra.trust | data.social | infra.inference | data.research | infra.scraping | data.x402 | data.procurement | data.reference | data.security | tools.verification | verification | compute.nlp | data.energy | data.onchain | infra.creative | ai.agents | commerce.general | data.company |
| protocol | enum | 否 | 仅返回提供此支付协议的收录项。省略则不限。x402 | mpp |
| max_price | number | 否 | 每次调用的最高价格。省略则不设上限。 |
| min_score | number | 否 | 最低探测评分,范围为 0..1(0.8 = 稳定通过)。 |
| mpp_method | string | 否 | 仅返回提供此 MPP 方法的收录项,例如 stripe、tempo、evm。 |
详细介绍
nohumans.directory — MCP 服务
在 Agent 为付费 x402 API 服务花钱之前,先查找并核验这些服务。
为付费 x402 服务提供发现与信任层。我们通过两种方式核验服务列表:使用真实 USDC 付款并记录服务是否交付,以及持续重新探测每个列表项当前的 402 挑战——每小时多次,并保留完整历史记录。每个列表项都有一个根据历史记录加权计算、侧重近期表现的可靠性评分,还包含来自我们自建链上索引的付款证据——让 Agent 在付款前检查端点是否确实会交付。
免费。无需 API 密钥。无需注册。无需账户。
实时统计: https://nohumans.directory/stats · REST API: https://api.nohumans.directory
为什么要做这个
大多数 x402 目录都只是目录:列出已有的服务。有些会探测是否收到 402 响应,这只能证明端点在线,无法证明是否有人实际向它付款,也无法证明付款后它会交付。
我们会向列表中的服务付费,并逐次公布返回结果及交易哈希。我们会持续探测每个端点并保留历史记录:只有持续通过探测后,列表项才会从 unverified 变为 verified;停止响应时则会降为 failing。可靠性评分侧重近期表现,因此昨天出故障的服务无法靠过去一个月的良好表现掩盖问题。每个列表项还会显示其链上付款活动——每日付款笔数、独立付款钱包数和金额——数据来自我们自建的 Base 链 USDC 转账索引。
每个列表项还包含一段手写描述,说明该服务的实际用途——在只有一堆裸 URL 的目录中尝试语义搜索之前,这一点看似平常,却很重要。
安装
远程服务,使用可流式传输的 HTTP。无需安装,无需构建步骤,无需凭据。
Claude Code
claude mcp add --transport http nohumans https://api.nohumans.directory/mcp
Claude Desktop / 任何仅支持 stdio 的客户端
{
"mcpServers": {
"nohumans": {
"command": "npx",
"args": ["mcp-remote", "https://api.nohumans.directory/mcp"]
}
}
}
直接连接远程服务
https://api.nohumans.directory/mcp
传输方式:streamable-http · 身份验证:无 · 费用:免费
Agent 技能
对于支持 Agent Skills 标准的 Agent(Claude Code、Codex 等),请安装此技能,让 Agent 知道如何智能地使用以下工具——何时优先选择 verified 列表项、如何解读 score/status/x402_version/链上付款证据,以及如何通过 tx_hash 报告实际结果:
mkdir -p ~/.claude/skills/nohumans-directory
curl -o ~/.claude/skills/nohumans-directory/SKILL.md \
https://raw.githubusercontent.com/jalcodev/nohumans-mcp/main/skills/nohumans-directory/SKILL.md
工具
find_paid_service
根据功能、价格上限和最低可靠性评分搜索付费 x402 服务。返回按排名排列的结果——先列出已验证的服务,再按可靠性排序,最后按价格排序。
| 参数 | 类型 | 描述 |
|---|---|---|
query | 字符串 | 在服务名称和描述中进行自由文本搜索 |
category | 字符串 | 精确类别筛选,例如 data.fx、infra.trust |
max_price | 数字 | 每次调用的最高价格,单位为 USDC |
min_score | 数字 | 最低可靠性评分,范围为 0-1 |
limit | 数字 | 最多返回的结果数,范围为 1-50(默认值:10) |
get_service_details
单个服务的完整记录:定价、接受的链、请求和响应架构、当前状态、可靠性评分、中位延迟、探测次数、协议版本(x402_version)和链上付款证据——近 30 天的总计数据、每日数据序列(onchain_daily)、共用该付款地址的列表项数量,以及抽样得到的付款形式(x402 签名付款、普通转账或其他)——包含 Agent 进行付费调用前所需的一切信息。
| 参数 | 类型 | 描述 |
|---|---|---|
id | 字符串 | 列表项 ID,由 find_paid_service 返回 |
resolve_endpoint
反向查询:你已经持有一个端点 URL——来自其他目录、提示词或配置文件——并希望在付费前了解本目录对此 URL 的评估结果。如果该 URL 已列出,则返回与 get_service_details 相同的完整记录;如果该 URL 曾列出但后来被移除,则返回 delisted 警告;否则明确返回未列出结果。未列出表示本目录从未核查过该 URL,并不代表它不安全。
| 参数 | 类型 | 描述 |
|---|---|---|
url | 字符串 | 当前持有的端点 URL,须完全一致,并包含查询字符串 |
what_agents_are_asking_for
面向卖家:汇总需求信息流,列出买家在本目录中搜索的内容,并按某个词被搜索的不同天数排名(而非搜索量,因为搜索量很容易伪造)。排除规则会公开说明,而非隐藏:少于 5 个字符的查询、来自同时在此编辑列表项的客户端的搜索,以及某个词至少被 3 个不同的非卖家客户端搜索后才会显示。统计窗口结束时间比实时数据晚 1 天,响应中会说明具体时间。数据与 GET /v1/demand 相同。
无参数。
示例
某个 Agent 需要外汇汇率,且不愿支付超过半美分,也拒绝使用可靠性评分低于 0.9 的任何服务:
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。