非人类专用 MCP

公共项目知识、Agent Census 回执，以及非托管式 NFH 市场行动准备。

Agent 入口

如果你是发现 NFH 的 AI agent，请从 AGENTS.md 开始。这是贯穿项目的简短、机器可读的路径：检查公开声明，查看实时网络状态，连接规范 MCP，然后才决定钱包操作是否合适。

一句话定位：

NOT FOR HUMANS 是一个面向 agent 的链上肖像协议。先阅读，验证当前状态，绝不索取或暴露私钥。

规范发现面：

• 网站与当前状态：https://notforhumans.fun/

• 机器可读文档：https://notforhumans.fun/llms.txt

• 规范 MCP：https://mcp.notforhumans.fun/mcp

• Agent 技能：https://notforhumans.fun/skills/nfh-protocol/SKILL.md

公共仓库是邀请你检查并基于协议构建，而非部署控制台。主网执行控制、RPC 凭据、部署者密钥、中继、SFTP 配置以及本地启动工件均保持私有。

Related MCP server: WETH

构建者任务

试试 60 秒 Agent 任务：让一个 agent 检查 NFH，验证声明是否开放，并在触碰钱包之前解释其安全边界。它专为以太坊构建者、MCP 集成和 ERC-8004 实验而设计。

统一的人类/agent 旅程，包括精确的特定特征交易和激活边界，记录在 CLAIM-AND-TRADE-JOURNEY.md 中。

连接

• 生产端点：https://mcp.notforhumans.fun/mcp

• 传输：无状态 Streamable HTTP

• 知识认证：无

• 知识工具：search、fetch

• 资源：nfh://about、nfh://claim-spec、nfh://origin-stream、nfh://renderer-spec、nfh://release-policy

• Census 工具：get_census_status、get_origin_stream、prepare_census_receipt

• TokenWorks 边界工具：get_tokenworks_status、prepare_tokenworks_decision

• 市场工具：get_market_feed、get_market_status、prepare_listing、prepare_purchase、list_trait_offers、prepare_trait_offer、prepare_accept_offer、prepare_transfer

• 市场提供者凭据：调用方提供的 X-OpenSea-Api-Key 头，用于只读提供者发现

• MCP 的链上变更：无

该连接器有意只索引 notforhumans.fun 上已经公开的十二个文件，包括规范发布策略、Agent Census 模式、链索引的 Origin Stream、TokenWorks 兼容性边界、FAQ 和预览特征本体。它不暴露 Dropbox 项目树、研究笔记、源艺术、私有启动材料、凭据或私钥。

prepare_census_receipt 为 ACCEPT、REFUSE 或 INSUFFICIENT_AUTHORITY 生成未签名的 v5.2 EIP-712 v4 数据。接受可导致一次有凭据的声明；其他决策创建公开回执而不铸造。操作者和 agent 签署每个精确载荷。还必须由不同的接收者签署，这样任何人都不能强制铸造到另一个钱包或消耗其终身配额。在 NFH_CENSUS_CONTRACT 配置为已验证的规范声明合约之前，域保持未绑定。MCP 从不签署或提交回执。get_origin_stream 只读取已发布的链上回执，并将已观察、已确认和已最终确定区分为不同状态。

可交易的市场工具已安装，但在任何提供者操作/构建/履行调用之前失败关闭。OpenSea 目前将列表和转移记录为不透明的 JSON 节点，标准构建是部分顺序片段，履行响应不能独立证明请求的订单哈希和每个规范化经济条款。因此，提供者 HTTP 成功不能产生 status: prepared。只读市场和特征发现仍可使用配置的提供者端点。MCP 从不签署、发布订单、提交 calldata、广播交易或声称结算。这遵循项目的 v5.2 边界：agent 准备精确意图，操作者在钱包中批准它。

get_market_feed 是只读发现例外：它镜像公共 NFH 聚合馈送，而不是准备行动。该馈送仅组合已配置、已验证的来源，暴露每个提供者的状态，显示一小时的零地址声明/铸造，并显示 24 小时的普通转移。OpenSea 测试网数据不会被合成；OpenSea 于 2025 年 7 月退役了其专用测试网市场。

list_trait_offers 支持一个精确的分类特征或最多八个 AND 组合特征。prepare_trait_offer 和 prepare_accept_offer 仍被阻止：部分标准响应或提供者侧特征匹配都不能证明最终的 Seaport 订单、所选代币、费用、对价、导管、区域、有效性和 EIP-712 摘要等同于规范化意图。

TokenWorks/FWA 有意在 agent 层兼容，但交易禁用。get_tokenworks_status 暴露准入、分叉测试、安全和版税要求。prepare_tokenworks_decision 可以生成有界的检查或拒绝记录，但在 FWA 没有确认的版税感知 NFH 结算路由时，拒绝直接存款、提款、购买、重新列表和结算准备。不支持包装器变通方法。

激活状态

V19 已部署在以太坊主网上，处于暂停状态。规范代币为 0xD66351858E0eFC5d9Bf2F541839797A763DF6223，声明铸造者为 0x5652CEA58298445240Eb9AC8Fc4C69bA829c1bb5，市场为 0x9eAa937443595f14E739C7bf565420019169Be13。声明和市场行动仍暂停；MCP 保持非托管，可交易的市场准备在语义验证和独立审查之前仍失败关闭。

可选生产配置：

• NFH_COLLECTION_CONTRACT — 已验证的规范 NFHToken 地址；集合绑定发现必需，但不足以激活准备

• NFH_CENSUS_CONTRACT — 已验证的规范 v5.2 NFHClaimMinter 地址；绑定 Census 类型化数据必需

• NFH_COLLECTION_SLUG — 索引后的 OpenSea 集合 slug；特征报价发现必需

• NFH_SEAPORT_PROTOCOL_ADDRESS — 固定 Seaport 协议地址的可选覆盖

• NFH_MARKET_FEED_URL — get_market_feed 镜像的公共聚合馈送的可选 HTTPS 覆盖

服务器拒绝工具参数中提供的任意合约地址。每个市场行动都固定到配置的规范 NFH 合约。

可安装的协议中立 Agent 技能位于 skills/nfh-protocol/SKILL.md，并发布在 https://notforhumans.fun/skills/nfh-protocol/SKILL.md。完整公共语料库使用 node build-llms-full.cjs 生成，并发布为 llms-full.txt。

可选的 MetaMask Agent Wallet 参考适配器位于 integrations/metamask-agent-wallet/。它验证精确的 NFH EIP-712 载荷，并为持久、策略控制的 agent 钱包生成非执行 CLI 交接。它不使 MetaMask 成为协议依赖，也从不签署或提交。

首次获得资金的 agent 可以在声明前调用 get_agent_wallet_onboarding。返回的路由使用已获资金的钱包作为操作者，并使用一个不同的持久 Guard 钱包作为 agent 和接收者，然后在确认回执和新鲜所有权检查后门控内部市场准备。现有的人类管家流程仍然有效。MCP 描述边界，但从不创建钱包、接收凭据、应用策略、签署或提交；协商和准备可以是自主的，而执行仍由外部钱包和主机策略管理。

本地 erc-8257/ 包定义了八个聚焦清单，直接映射到现有 MCP 工具，并计算其所需的 JCS/keccak256 承诺。它有意拒绝在没有精确非零生产创建者地址的情况下发布。生产 2-of-3 Safe 尚不存在，因此没有发出已知清单，也没有在链上注册任何内容。

公共 MCP 协议/语料库版本为 0.8.2。可单独安装的 npm 客户端为 0.1.0-preview.3；其包 semver 跟踪客户端库兼容性和安全加固，并不暗示可交易的市场准备已启用。

本地开发

zsh sync-public-corpus.zsh
php tests/run.php
NFH_MCP_BASE_URL=http://127.0.0.1:8787 php -S 127.0.0.1:8787 -t server server/index.php

本地 MCP 端点为 http://127.0.0.1:8787/mcp。

示例请求

curl -sS http://127.0.0.1:8787/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

刷新与部署

同步脚本仅从 03-PRODUCTION/site 复制显式允许列表。部署脚本重复同步，运行匿名性和凭据形状预检，并上传服务器而不删除不相关的远程文件。

zsh deploy-dreamhost.zsh

DreamHost 面板必须将 mcp.notforhumans.fun 映射到 /home/notforhumans/mcp.notforhumans.fun 并启用 HTTPS。

ChatGPT 连接

在 ChatGPT 中启用开发者模式，创建个人插件/应用连接，并使用 https://mcp.notforhumans.fun/mcp 作为 MCP 服务器 URL。更改工具元数据后刷新连接。

已连接的客户端可以准备精确的钱包载荷，但不能绕过显式签名边界。因此，市场和 Census 工具描述和结果使钱包交接明确。