Agent Utilities

Agent Utilities MCP

还提供托管式 Streamable HTTP 连接，地址为 https://agent-utilities.agent-utilities.workers.dev/mcp/remote。它提供免费资源和调用准备，以及使用现有额度和私有 Authorization 标头的付费执行。此连接无需本地 Node 进程。请阅读托管 MCP 指南；其中封装的工具参数与此本地适配器不同。不提供 OAuth 或钱包签名。

将本地 stdio MCP 客户端连接到当前付费实用 API 目录，涵盖 HTML 提取、JSON 验证、Agent 配置检查和产品数据。此 MIT 许可的适配器在本地运行；托管 API 是一项付费服务。

工具目录 · 安装指南 · 定价 · 政策与支持

VS Code 用户：打开设置链接和私钥配置。此源代码仓库中包含详细说明。

在 Cursor 或 VS Code 中连接托管 MCP

无需本地 Node.js 进程。这些设置链接仅包含服务名称和公开端点，不含 API 密钥或付款授权：

• 在 Cursor 中设置托管 Agent Utilities
• 在 VS Code 中设置托管 Agent Utilities

接受配置前，请在已安装且支持 MCP 的应用中检查配置。检查安装范围，并保持启用工具审批。这些链接配置的是托管连接，而非本 README 其他部分所述的本地适配器。

端点：https://agent-utilities.agent-utilities.workers.dev/mcp/remote（Streamable HTTP）。单独的旧版 /mcp JSON-RPC 端点行为不同，并非这些设置使用的端点。

**免费与付费：**发现、提供数据的预览以及 agent_utilities_seo_audit 无需 Agent Utilities 账户或 API 密钥。免费 SEO 审计基于提供的快照运行；不会抓取任意 URL。49 个付费目录工具需要已有服务额度和私有 Authorization: Bearer API 密钥标头，以及托管 MCP 指南中所述的准备输入、请求 ID 和价格上限。此设置不会创建账户、购买额度或授予消费授权。不提供 OAuth。切勿将 API 密钥放入安装链接、共享配置或聊天中。

如果链接无法打开，请手动设置

将相应的服务条目合并到现有配置中；保留其他服务。

**Cursor：**此项目使用 .cursor/mcp.json，或用户级配置使用 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "agent-utilities-hosted": {
      "url": "https://agent-utilities.agent-utilities.workers.dev/mcp/remote"
    }
  }
}

**VS Code：**为当前用户配置文件运行 MCP: Open User Configuration，并合并此原生 VS Code 格式。若要使用仅限工作区的原生配置，请使用 .vscode/mcp.json。当前 VS Code 也支持可移植的 .mcp.json；选择格式前请查阅其文档。

{
  "servers": {
    "agent-utilities-hosted": {
      "type": "http",
      "url": "https://agent-utilities.agent-utilities.workers.dev/mcp/remote"
    }
  }
}

检查并启用连接后，请查看已发现的工具。可先试用免费的所提供数据预览，或免费 SEO 示例和契约。安装范围、组织策略和 Agent 会话支持取决于你的客户端。

**验证：**安装链接负载已于 2026 年 10 月 4 日解码，并与这些配置进行了核对。使用官方 MCP SDK 的 Streamable HTTP 客户端通过了针对性服务测试，其中包括免费 SEO 行为。尚未测试在 Cursor/VS Code 应用中实际安装以及由模型驱动的执行；不声称存在市场列表或背书。

参考：Cursor 安装链接、Cursor MCP 配置、VS Code 安装 URL、Microsoft 的远程 HTTP 安装链接示例、VS Code 配置和范围。

将提供的 HTML 转换为精简的研究输入

Page Pack 可从你已有的 HTML 中提取有长度限制的可读内容，并附上其来源 URL、截断标记和大小估算。使用它为 Agent 准备已捕获的文档或页面内容，然后检查输出并保留原始来源。

• **免费预览：**无需账户、银行卡或 API 密钥；整个 JSON 请求最多 32,768 个 UTF-8 字节，输出最多 3,000 个字符。
• 付费 web.page-pack：HTML 最多 100,000 个字符，且请求不超过 131,072 字节；输出最多 12,000 个字符。目前的实验性价格为每次调用 $0.0005。
• **额度：**提供 $1 和 $5 的预付额度包。按当前 Page Pack 价格计算，$1 可支付 2,000 次调用，之后额度才会用于其他工具；下文所述的全服务每日容量限制仍然适用。不会自动切换到付费服务或自动充值。

如有可用的发布方 Markdown 或官方 API，请优先使用。Page Pack 不会获取任意 URL、渲染 JavaScript、核实事实或保证节省令牌。源文本仍不可信；经过 JSON 元数据处理后，小型输入也可能变大。令牌估算以 UTF-8 字节数除以 4 得出，并非使用模型分词器。

试用免费的 HTTP 预览

将此合成示例保存为 page.json：

{"html":"<html><head><title>Retry guide</title></head><body><nav>Home Account Ads</nav><main><h1>Retry guide</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre></main></body></html>","sourceUrl":"https://example.com/retry-guide","maxChars":3000}

curl --fail-with-body 'https://agent-utilities.agent-utilities.workers.dev/v1/preview/web.page-pack' \
  -H 'Content-Type: application/json' --data-binary @page.json

免费预览会移除示例中的导航内容，并保留其超时说明和代码示例。请检查 chargedMicroUsd、result.content、result.truncated 和 result.measurement。这是合成演示，并非客户结果。

对于 MCP，请连接到 https://agent-utilities.agent-utilities.workers.dev/mcp/remote?category=web，并使用相同输入调用 agent_utilities_page_pack_preview。对于较大的输入或较长的输出，请阅读付费契约，并明确授权执行。付费 HTTP 调用需要私有 API 密钥和稳定的 Idempotency-Key，并可使用 X-Max-Credit-Micro-Usd: 500 将新的调用限额设为 $0.0005。单次调用上限不等于整个会话预算；遇到不确定情况时，请遵循下方的恢复说明。

面向 SEO 代理机构

试用免费 SEO 审计。这是一个独立的免费入口；上文所述的付费 Page Pack 容量用于提取所提供的 HTML。

实时目录目前包含 49 个付费工具，与免费资源和预览分开。经核实，截至 2026 年 10 月 4 日：托管 MCP 服务报告的版本为 1.9.0；此仓库的本地 stdio 适配器和不可变 MCPB 版本仍为 0.3.0。它们是不同的组件，版本号不可互换。

使用 USDC 按次付费

对于 Circle Gateway 中有余额的 Agent，独立的 USDC 客户端支持使用 Base 主网付款，无需 Stripe 充值包。下载并预览示例。它会固定网络和合约，为每次调用设定上限，并私密保存已签名请求以供恢复。预览可离线进行；准备和提交需要分别使用明确的命令。实际执行会消耗真实的 USDC。此客户端与 Stripe 资助的 MCP 适配器分开，也不包含在不可变的 MCPB 0.3.0 版本中。

无需账户即可试用购物示例

克隆此仓库，并使用 Node.js 22+ 预览提供的购物车：

cd examples/cart
shasum -a 256 -c cart-workflow.mjs.sha256
node cart-workflow.mjs --preview cart-example.json

预览会验证输入，并离线打印三步计划，不需要 API 密钥，也不会发起网络请求或产生费用。它不会执行工具。随附的预期输出是本地测试样例：德语价格字符串会转换为十进制金额，受保护的补丁会更新所提供的购物车快照，费用核对会返回已知总额 €45.92。税额未知，因此最终总额仍为 null。

若要通过托管服务运行这三项操作，请在进程环境中私密设置 AGENT_UTILITIES_API_KEY，并明确选择：

node cart-workflow.mjs --execute cart-example.json

执行会消耗现有服务额度。此操作流程为每次调用设置价格上限，三次逻辑调用的总费用最多为 $0.0013（0.13 美分）。如果发现的价格过高，或后续价格超出授权上限，流程就会停止。若后续步骤失败，已完成步骤仍会收费。每个步骤都会返回扣款收据和恢复信息；若响应状态不确定，请勿重新运行整个流程。执行前请阅读流程说明。此示例不会购买额度，也不会向商家下单。

此流程是单独下载的，不属于不可变的 v0.3.0 MCPB 组件包。你也可以从工作流页面获取。通用 MCP 适配器的消费行为仍如下面所述。

直接通过 Agent 阅读资料

无需账号或密钥，即可阅读合约、示例、价格和指南：

curl --fail --silent --show-error \
  https://agent-utilities.agent-utilities.workers.dev/v1/content/index?utm_source=github

• 完整 JSON 内容：工具输入／输出架构、请求示例、执行标头、工作流和文档。
• 完整文本指南：以纯文本形式呈现的相同资料。
• 单个工具的合约：请求架构、示例、价格和执行 URL。
• 购物车工作流：步骤和当前总价。
• OpenAPI：HTTP 工具操作、可选的信用额度上限标头和错误响应。

这些公开的 GET 端点支持跨源浏览器读取。工具执行仍需付费。自定义 HTTP 客户端可发送 X-Max-Credit-Micro-Usd，为新的预付信用额度扣款设置上限；有关重试语义，请参阅快速入门。Adapter 0.3.0 会将每次新调用的额度限制为启动时目录中的价格，并要求服务端声明支持此功能。

更喜欢 Python？

Python HTTP 客户端仅使用 Python 3.10+ 标准库。请参阅 examples/python，了解离线预览、免费发现，以及支持单次调用额度上限和稳定重试标识的显式付费调用。使用此方案无需 Node 或 MCP 进程。它与 MCPB 捆绑包相互独立。

安装

也可在 Smithery 上找到，它以本地 Node.js MCPB bundle 的形式提供。其下载内容与 v0.3.0 GitHub 构建产物一致。连接适配器可获取完整且最新的工具架构和价格；目录元数据仅用于发现概览。

对于支持 MCP bundle 的客户端，请从 v0.3.0 发布页面下载 agent-utilities-mcp-0.3.0.mcpb 及其校验和。通过客户端的扩展设置导入 bundle 前，请先验证校验和。它包含适配器、清单和许可证声明。此 bundle 未签名；发布校验和只能确认文件一致性，并非独立签名。Bundle 架构和独立运行均已测试；但尚未验证在各桌面客户端中的安装情况。

Bundle 中可选的 Agent Utilities API key 设置标记为敏感信息。留空即可免费发现工具；也可仅输入 API key 以启用付费调用。需要 Node.js 22+；请使用客户端提供的兼容运行时，或在本地安装。如果客户端无法导入 MCPB 文件，请使用下方的手动设置方法。

需要 Node.js 22 或更高版本。从安装指南下载 agent-utilities-mcp.mjs 及其 .sha256 文件，然后在文件所在文件夹中验证文件：

shasum -a 256 -c agent-utilities-mcp.mjs.sha256

或者，克隆此仓库并直接使用其中附带的 agent-utilities-mcp.mjs。运行此 bundle 无需执行 npm install。源代码位于 src/；运行 npm ci && npm run build 可重新构建。公开 bundle 已作为独立进程在应用程序依赖树之外进行测试。

对于使用通用 mcpServers 配置格式的客户端：

{
  "mcpServers": {
    "agent-utilities": {
      "command": "node",
      "args": ["/absolute/path/agent-utilities-mcp.mjs"],
      "env": {
        "AGENT_UTILITIES_API_KEY": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

替换文件路径。若客户端支持，请通过其密钥设置私密地配置 API key；切勿提交真实密钥，也不要将其粘贴到 Agent 提示词中。如果客户端找不到 Node，请使用 Node 的绝对路径。对于仅支持远程服务的 MCP 客户端，请使用上方托管的 Streamable HTTP 端点。其付费调用需要私密的 Authorization 标头，以及托管 MCP 指南中所述的封装参数。

省略密钥即可发现工具，不消耗额度。请在 工作区中获取 API key，并另行保存恢复密钥。仅向适配器提供 API key。实时模式提供 $1 或 $5 USD 的预付服务额度包。购买前请查看显示的模式。

功能

• 启动时获取公开工具定义及当前每次调用的价格。
• 暴露从当前目录中发现的服务工具，以及一个恢复辅助工具。恢复辅助工具并非额外产品。
• 仅向固定的 Agent Utilities 来源发送经过身份验证的调用；拒绝重定向。
• 生成稳定的扣款请求 ID，并在一次 HTTP 交互失败后使用完全相同的请求正文和 ID 重试一次。
• 在进程内存中保留请求标识和输入哈希，不记录输入、结果或凭据。远程数据处理方式详见服务政策。
• 不购买额度、不自动充值、不访问钱包，也不接受恢复凭据。

试试这样的实用任务：“使用 commerce_gtin_validate 检查条形码 036000291452。”一次成功调用的费用为 $0.0003。目前工具价格范围为 $0.0003 至 $0.003；这些是实验性价格，并非永久固定。每次新操作都会消耗额度。版本 0.3.0 会将每笔新扣款限制在启动时发现的价格以内。没有会话总预算；反复进行新的调用可能耗尽可用余额。如果服务端价格更高，则会返回 HTTP 412，而不会提高上限。查看更新后的价格后再重启。请在客户端中查看价格并批准支出。

重试不确定的结果

结果和不确定的执行结果都包含 requestId。使用该 ID、原始 MCP 工具名称和原始参数调用 agent_utilities_retry：

{
  "requestId": "COPY_THE_RETURNED_REQUEST_ID",
  "name": "commerce_gtin_validate",
  "arguments": { "code": "036000291452" }
}

十分钟内，已完成的请求会返回保存的结果，不会再次扣费。在版本 0.3.0 中，恢复辅助工具会发送一个零上限：未能到达服务的请求会被拒绝，且不会产生新的预留。这不会取消先前的预留，也不会退款。新调用的自动传输重试会保留原来的非零上限，因此仍可执行该项已授权操作一次。恢复不确定的结果时，不要生成新 ID 或更改输入。已过期的请求身份无法再次扣费。在同一进程中重用 MCP 请求 ID，也会保留其原有的扣费身份。

进程重启后，你需要返回的请求 ID 和原始输入才能恢复。如果进程在客户端收到 ID 前就已终止，请先检查余额或联系支持人员，再重复执行操作。系统不会在本地持久存储输入或结果历史记录。每个进程最多保留 5,000 个 MCP 请求身份，达到上限后会拒绝新调用，直到进程重启；请先完成待处理的恢复操作。

服务限制

单工具服务在所有支付通道中，每天最多允许 1,000 次新的付费调用尝试。HTTP 和托管 MCP 共用信用额度通道的容量；对现有匹配请求的重试不会产生新的扣费。输入大小上限为 128 KiB，包含协议开销。网络工具仅限访问目录中列出的主机，并非通用网络浏览器。安全检查采用启发式方法。成功结果会加密保存，以支持十分钟内的重试恢复；请求墓碑会保留一天。有关保留和退款的详情，请参阅相关政策。

自动化测试会针对本地 Cloudflare 信用额度账本，验证丢失响应后的恢复功能。这些测试既不能证明客户需求，也不能证明有客户实际购买。目录验证和免费工具发现都不属于销售。

许可证

适配器代码：MIT。捆绑依赖项：参见 THIRD-PARTY-NOTICES.txt。该许可证适用于适配器，不涵盖对托管 API 的免费访问。

为购物任务选择整包

整包规划器会根据明确的包装数量限制，为所需数量的可互换商品找到最低商品小计。即使 10 件装售价 $11.99、单价更低，12 件商品也可能通过购买两组售价 $7.99 的 6 件装，总价仅为 $15.98。此操作耗费 $0.0008 的预付额度。它的优化范围不包括运费、税费、优惠券和商品等价性。

通过 MCP 调用 commerce_pack_plan，或使用 Python 客户端，指定工具 ID commerce.pack-plan 和明确的 800 微美元上限。执行前，请查看免费 JSON 契约。工作流示例说明了库存限制，以及如何将包装数量映射到购物车核对。适配器会从服务发现此工具；新增工具无需替换适配器。

试用 Python 整包规划示例及其三个示例场景。在 examples/python 目录下运行 python3 pack_plan_example.py，或选择 --scenario limited-stock / --scenario insufficient-stock。默认情况下，程序离线显示固定样例，不会发送请求，也不会计算新答案。添加 --execute 会明确授权一次托管调用，费用上限为 $0.0008，使用现有额度。有效但不可行的结果也会计费。执行前，请参阅 Python 指南，了解校验和、输入限制及恢复方式。每次新运行都会创建新 ID；如付费结果状态不明，请勿重新运行以尝试恢复。

从 0.2.1 升级

安装 0.3.0，以使用单次调用价格上限和仅用于恢复的手动重试功能。0.2.1 版本不会强制执行这些适配器保护措施。现有 0.2.1 版本的发行文件仍可获取且保持不变；升级需要替换已安装的适配器。单次调用上限不会限制新调用的次数，也不会提供整个会话的总预算。

比较结账总价

examples/python/compare_carts.py 中的标准库 Python 示例使用每个购物车的一次限额内核对，比较提供的商家结账快照。默认预览为离线模式；执行需要 --execute 和现有额度。该示例会按完整总额排序、保留并列结果；如果任何购物车的运费、税费或手续费未知，则不会选出总赢家。默认的双购物车调用上限为 $0.001。有关示例输入、校验和、明确预算和恢复方式，请参阅比较指南。