NAIF Gravity Diagnostic — Free MCP/API/Webhook Triage

NAIF Gravity — MCP 与集成诊断

NAIF Gravity 为 MCP、AI Agent 集成、API、身份验证和 Webhook 提供有界诊断与修复工作流，并提供可复现、面向开发者的诊断以及机器可读的 Agent 发现信息。

从诊断中心开始，或访问 NAIF Gravity。

新增 — GitHub Issue Radar（2026 年 10 月 14 日）：阅读包含源链接的 MCP 和 x402 故障诊断、拟议修复方案及回归检查。仅提供公开技术说明；未执行第三方补丁或付费交易。

此仓库包含公开诊断指南、一个小型 Python MCP 健康检查脚本、Issue 模板和发现元数据。它不是托管服务的完整源代码发行版。

新功能：Micro Tools V2 — 免费预览，付费报告

JSON 格式错误？API 响应异常？需要一致的数据输出？ 免费预览经过脱敏的样本，如果有界结果有用，再选择购买一次性报告。无需订阅，预览期间无需付款。

在线 Micro Tool V2	一次性费用（美元）	付款验证后可获得的内容
JSON 有效性检查	$1	精确定位语法问题；标记重复键；在支持的情况下安全修复尾随逗号；推断样本架构、CI 代码片段和 SHA-256 收据
API 响应结构检查	$2	比较两个 JSON 响应样本，检查新增/移除的键和类型变化；生成基于样本的 TypeScript/OpenAPI 响应架构和 QA 说明（不探测实时 API）
JSON 规范化迷你工具	$3	稳定的键顺序、可选的去空格/缩进、变更日志、处理前后大小和 SHA-256 收据

免费试用这三种工具的预览 → · 浏览在线目录

简单的 Agent 到报告流程：请求样本预览（POST /api/micro-v2/preview），请求并接受固定价格报价（POST /api/agent/quote → POST /api/quote/accept），选择响应返回的符合条件的结账方式，然后在付款验证后使用私密交付令牌获取有界报告（POST /api/micro-v2/deliver）。符合条件的国际买家可能可以使用 Base USDC 和 TRON USDT；被归类为沙特买家的用户需经人工授权使用 Apple Pay。Agent 钱包结账说明并不意味着要自动转账。

这三种工具均接受经过脱敏且有界的样本（最多 4,096 UTF-8 字节）。付费 V2 输入和报告会在静态存储时加密；生成报告后，原始输入会从活动记录中清除，报告仅可在七天内获取。切勿提交机密信息、原始客户记录、私钥或支付凭据。按次付费的 x402 API 工具属于单独的购买方式；第四种 CSV 工具仍为 $5。

为你的 Agent 安装 NAIF JSON Rescue

NAIF JSON Rescue 会在任何外部调用前，在本地检查经过脱敏的 JSON 样本。免费的 Node.js 检查器不会上传数据、修改文件或花费资金。可选的托管诊断会通过 Base 上的 x402 提供现有的、有界限的 JSON 工件，但仅限于购买方的披露许可和支付预算范围内。语法有效且仅需语法检查的样本无需付费调用。

使用 Skills CLI，查看并仅安装此技能：

npx skills add naief9961-tech/ai-growth-engine --skill naif-json-rescue

在安装程序中选择受支持的 Agent。安装不会授权付款或为钱包充值。克隆此仓库后，可进行免费的离线演示：

node skills/naif-json-rescue/scripts/check-json.mjs skills/naif-json-rescue/assets/valid.json
node --test tests/naif-json-rescue.test.mjs

需要 Node.js 18+。本地检查器仅验证语法；重复键和 JSON Schema 符合性不在其检查范围内。托管检查最多接受 4096 个 UTF-8 字节，并且仅支持有限范围的尾随逗号修复。有关实时发现、区域政策、支出限额和准确解读交付结果的信息，请参阅该技能。

面向 AI Agent 的实时发现

NAIF Gravity 可通过以下机器可读、只读入口公开发现：

• A2A Agent Card — 身份、技能和协议接口。
• 远程 MCP 端点 — Streamable HTTP；MCP 客户端应使用 MCP 协议进行协商（普通浏览器 GET 可能会返回 405）。
• AI 服务目录 和 Agent 目录 API — 使用实时描述、资格条件和购买说明。
• LLM 能力指南 和 A2A 发现指南。
• A2A Registry 列表 和 Official MCP Registry 列表。

更改本仓库的 MCP 元数据时，系统会通过固定且经过验证的 GitHub Actions 发布器将其推送到 Official MCP Registry。列入列表、爬取或发布到注册表，并不能证明有人访问、产生了合格线索或达成了销售。

发布优惠 — 一次性技术服务（2026 年 10 月 12–26 日）

实时自动折扣，无需优惠码或人工 Agent 审批。 以下发布价格适用于 2026-10-26 05:40 UTC（沙特时间 08:40）之前新创建的符合条件的报价，或活动产品的前 10 笔已验证购买，以先发生者为准。现有报价和过往付款仍按原条款执行。这些是范围明确的技术服务工作价格，并非按次计费的 x402 工具价格。

范围明确的技术服务	常规价格（USD）	发布价格（USD）
NAIF API Fixer	$89	$79
Web3 QA Sprint	$99	$89
NAIF Data Factory	$129	$115
Repair CI Gate Pilot	$129	$115
RPC Reliability Audit	$129	$115
Web3 Backend Rescue	$149	$129
x402 Endpoint Sprint	$149	$129
Smart-Contract Integration Review	$179	$159
Agentic Wallet & Payments	$199	$179
Automation Factory	$199	$179
AI Agent Engineering Sprint	$249	$219
Wallet Authentication Integration	$249	$219
Trading Agent Infrastructure Sprint	$299	$269
Web3 Automation Pilot	$399	$349

如需查询实时资格和当前确切的可购买价格，Agent 应调用实时 Agent 目录，然后执行 POST /api/agent/quote → POST /api/quote/accept → 选择符合条件的支付渠道。请使用已接受报价和结账流程返回的金额；切勿在客户端计算折扣。符合条件的国际请求可能可以使用 Base 上的 USDC 和 TRON 上的 USDT；Apple Pay 需要人工协助。钱包可用性取决于所在国家/地区和购买政策。仅接受报价不会转移资金或触发实施。大多数工程类产品都需要经验证的已付款 Work 交接，且不会即时提供可下载结果。

即时 x402 API 工具（与发布优惠分开）

以下四个已发布的全范围付费 API 端点将维持现有的确切单次调用价格，直至同时更新支付挑战和实时目录：

API 工具	单次调用价格	端点（POST）
JSON Validity Check	$1.00 USDC	x402 JSON validity
API Response Shape Check	$2.00 USDC	x402 response shape
JSON Normalize Mini	$3.00 USDC	x402 JSON normalize
CSV Schema Audit Mini	$5.00 USDC	x402 CSV schema

请通过 x402 清单、x402 目录和 OpenAPI查找支持的路由。这四项均已作为自行注册的服务发布在 402 Index，也可通过 Agent402发现；该平台目前可识别 Base 上的四种工具。Lite 试用价格尚未发布：请勿将其作为现行价格询问、报价或公布。 成功的 402 挑战或外部目录中的列表，并不能证明交易已结算或已被 Coinbase Bazaar 收录。

个人购买（不新增周期性账单）

服务目录列出了当前可购买的个人一次性技术服务。新月度订阅已暂停。价格、购买资格以及地区特定的支付选项必须从实时商店获取；请勿依赖较早的订阅优惠、缓存价格，或假定某种钱包／支付方式可用。本发现文档不会影响现有客户的订阅和过往付款。

兼容 Coinbase 的 x402 工具 — 可自托管的商家资料

发布者： NAIF Gravity · 网络： Base 主网（eip155:8453）· 资产： USDC · API： x402 v2 · 计费： 每次调用一次性付费，无订阅。NAIF Gravity 的公开品牌 x402 商家元数据包含官方项目徽标、确切的付款要求、结构化输入／输出架构，以及实时产品目录链接。未付款的请求会收到 Payment-Required 响应，不会交付付费内容。

当 Agent 需要	公开 POST 资源	x402 确切价格
诊断格式错误的 JSON，或受支持的尾随逗号语法错误	JSON 有效性检查	$1 USDC
检查 JSON REST／MCP API 响应字段、类型和预期键	API 响应结构检查	$2 USDC
规范化小型 JSON 对象／数组并获取 SHA-256 校验和	JSON 迷你规范化	$3 USDC
审核有界 CSV 样本的列、类型和行一致性	CSV 迷你架构审核	$5 USDC

**Agent 工作流：**查阅 x402 清单或 OpenAPI 规范，检查输入架构，POST 经过清理且范围受限的输入，使用买家自己的符合条件的钱包授权确切的 402 付款，并仅在结算验证通过后获取结果。切勿发送私钥、客户记录、令牌或任意生产环境 URL。

单独的临时上线折扣：实时 Agent 目录中的 14 项范围明确的工程／修复服务享有自动促销价，面向用户的价格另见页面。无需优惠券；新接受的报价会锁定金额。促销将于 2026 年 10 月 26 日 05:40 UTC 到期，或在前 10 笔符合条件且已验证的购买完成后到期，以先到者为准。此折扣不适用于上述 4 项即时 x402 API 价格。

Coinbase 索引状态：这些服务兼容 Coinbase CDP 验证器（2026 年 10 月 12 日，4 项服务均返回 valid: true，检查结果为 25/25），但目前尚未确认有 NAIF Gravity 的直接资源被收录至 Coinbase Bazaar。官方卖家发现指南要求先通过 CDP 协调器成功完成一笔已结算的付费调用，之后才会预期收录；仅有验证、普通 USDC 转账、GitHub 星标或提及 Coinbase 均不构成 Bazaar 收录。

使用 Base 上的 USDC 购买 JSON 检查

• **人工买家：**打开 JSON Validity Check 产品。使用实时结账页面提供的付款选项。
• AI Agent：x402scan 列表中提供 Try with AgentCash 选项。OpenAPI 文档介绍了付费 API。
• **价格：**每次有界 JSON 检查收取 Base 主网（eip155:8453）上的 1 USDC。可能需要支付钱包网络手续费。此价格仅适用于 JSON 检查，不适用于目录中的所有服务。

x402 v2 客户端向 POST https://naifgravity.com/api/x402/json-validity-check 发送请求，附带 JSON 请求体，例如 {"jsonText":"{\"ok\":true}"}。未签名的请求会收到 HTTP 402 响应以及 Payment-Required 挑战。兼容的客户端会使用买家已授权的钱包为所展示的 USDC 付款签名，然后重试。只有在付款经过验证并完成结算后，才会返回付费结果。访问网页或在 GitHub 上点星并不等于购买服务。

此检查接受一个经过清理的样本，大小不超过 4096 个 UTF-8 字节。它会返回有效性诊断，并支持有界的尾随逗号修复；但不会修复完整的应用程序。切勿发送机密信息、私钥或客户数据。

使用 VPN/代理不再是单独的购买障碍。实时区域政策仍然适用：被归类为沙特阿拉伯的连接可使用 Apple Pay；符合条件的国际连接可使用 Base USDC。请查阅实时付款政策，不要假设所有地区都能使用钱包付款选项。使用 Base 的 Agent 钱包可能还需要 ETH 来支付网络手续费。

服务发现

这些托管页面将常见开发者问题对应到有针对性的诊断或修复路径：

问题或需求	从这里开始
API 集成失败、请求/响应不匹配，或小型集成修复	API 集成诊断
JSON 有效性、格式错误的载荷，或与架构相关的检查	JSON 有效性检查
自动化工作流失败以及任务交接中断	自动化工厂
数据转换、结构化输出或流水线修复	数据工厂
Docker 服务健康状况、容器启动或部署检查	Docker 健康修复
小范围、有界的修复验证	修复检查

规范的主页是 naifgravity.com。这些直接服务链接明确展示了每个开发者问题与其目标页面之间的对应关系，方便用户和搜索引擎了解。

尝试 MCP 健康检查

需要 Python 3，且仅使用标准库。请对你拥有或获准测试的服务运行：

git clone https://github.com/naief9961-tech/ai-growth-engine.git
cd ai-growth-engine
python3 tools/mcp_health_check.py https://your-mcp.example/mcp

将示例 URL 替换为你的端点。脚本会协商 initialize，发送 notifications/initialized，并在服务声明支持时读取 tools/list。它支持 JSON 和 SSE 响应、通过环境变量提供可选的 bearer 身份验证，以及有界分页；它不会调用任何工具。协议错误会导致非零退出状态，且不会打印服务响应正文或机密信息。

解读结果前，请先阅读快速入门和限制。这是用于发现受支持的握手阶段修订版本的探测工具，并非完整的 MCP 一致性测试套件。

尝试离线 webhook 签名示例，了解为什么解析并重新序列化 JSON 会破坏原始请求体验证。示例使用合成数据，不会发出网络请求。

找到合适的诊断路径

故障	有用的证据	从这里开始
MCP 连接、会话或架构	传输方式、客户端/服务端版本、经过净化的 JSON-RPC 错误	MCP 诊断模板
API 授权或 OAuth	HTTP 状态码、身份验证方案、预期行为、经过净化的错误代码	API/身份验证诊断模板
Webhook 投递或处理	提供方、投递和处理程序状态、签名结果、已脱敏的负载结构	Webhook 诊断模板

请阅读故障排除索引，了解常见的 401、403、invalid_grant、原始请求体签名、重试和幂等性故障。准备好最小复现后，请使用相应模板提交问题。

GitHub 问题是公开的。 分享证据前，请移除令牌、Cookie、签名密钥、私钥、支付凭据和客户数据。

面向 AI Agent 构建者

Agent 发现文档介绍托管 MCP 传输、A2A Agent Card 和规范域名。server.json包含提供方的 MCP 注册表元数据。

文档和发现元数据介绍的是提供方接口；它们不保证当前可用，也不代表已认证协议一致性。诊断发现不会自动执行生产环境修复。

参与贡献

有价值的贡献包括可复现且已净化的示例、更清晰的故障排除步骤，以及对诊断文档的修正。请说明问题、预期行为，以及如何复现或验证你的更改。切勿包含生产环境私有日志。

此仓库还包含早期 AI Growth Engine 项目的资料。有关背景信息，请参阅历史 README和现有贡献指南。历史上的悬赏金额、自动付款和端点状态均不构成当前承诺。

如果这些诊断工具帮助你调试集成，不妨为仓库加星，让其他构建者也能找到它。

服务边界

托管服务可通过 https://naifgravity.com 访问。公开的 GitHub 诊断指南与可选的商业修复工作流彼此独立；提交问题或贡献并不意味着购买服务，也不保证获得修复。