AgentResolver — Agent Commerce Health Monitoring

io.github.waxsway由 GitHub 账号 waxsway 发布v0.2.4更新于 Oct 24, 2026

Free API/MCP/x402 health checks plus $19 hourly managed monitoring for agent services.

已验证Streamable HTTP可网页运行金融开发者工具安全与监控

概览

AI 生成的概览

远程 MCP 服务器,用于检查 API、MCP 端点和 x402 支付服务能否被 AI 代理发现、调用和支付,并提供付费的支付前校验与监控服务。

可以做什么
发现并采购 API、MCP 服务器及 x402/L402/MPP 服务,兼容性证据采用失败即拒绝策略,并可选付费的实时验证或批量验证。对 x402 目标执行签名前支付检查:payment_guard 与 x402_payment_preflight 返回可用或拦截的判定、观测到的支付条款和证据,http_inspect 在花钱前检查端点安全性。预检与审计:mcp_preflight 检查 MCP 可达性与工具清单,agent_readiness 审计网站的代理可发现性,openapi_select 从 OpenAPI 规范中挑选操作。提供方入驻与卖方侧上线检查,包括用于 API/MCP 可发现性的分发包。
适用场景
当代理需要为某项任务寻找合适的 API 或 MCP 服务时,或当自主 x402 买方希望在签名前对支付挑战做失败即拒绝的检查时使用。也适合希望审计自身服务是否可被机器发现、是否对代理友好的运营者。
运行要求
远程 streamable HTTP 端点;免费发现类工具未声明需要账户、API 密钥或钱包。付费工具通过 x402 以 Base 或 Solana 上的 USDC 结算,因此需要已充值且支持 x402 的客户端或钱包。需要能访问该端点及被检查的目标。
安装前请注意
许多工具按次收取 USDC,从 0.001 美元到分发包的 5 美元不等,托管监控为每 30 天 19 美元;支出权限始终归调用方。服务器声明为非托管,且从不索取私钥或助记词,切勿提供。付费检查会向第三方目标 URL 发送请求,http_inspect 的 POST 探测需显式选择加入,因为未受保护的端点可能产生副作用。Guard 只是支付决策的证据,而非花钱的许可。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentResolver — Agent Commerce Health Monitoring,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.waxsway%2Fagentresolver/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "agentresolver-agent-commerce-health-moni": {
      "type": "http",
      "url": "https://agentresolver.vercel.app/mcp"
    }
  }
}

README

AgentResolver

Continuous API, MCP, and x402 compatibility monitoring for services used by AI agents.

AgentResolver answers a production question ordinary uptime monitors miss: can an AI agent still discover, call, and pay this service right now?

Production: https://agentresolver.vercel.app
Free browser check: https://agentresolver.vercel.app/monitor

Agent Commerce Health monitoring

Start with the free public-service snapshot at GET or POST /api/service-monitor. It checks machine-facing discovery and can optionally run a real MCP initialize + tools/list exchange and a GET-safe x402 payment-contract inspection for same-origin public endpoints.

When an operator wants AgentResolver to own the schedule, POST /api/managed-monitor-30d is $19 USDC for 30 days of recurring monitoring that targets an hourly cadence with a durable public status record. Managed monitoring stores public target URLs and health snapshots only; it does not store wallet keys, API credentials, or customer contact information.

x402 Reliability Router

Existing x402 resource servers can route their standard facilitator traffic through AgentResolver without changing the merchant payTo address:

ts
import { HTTPFacilitatorClient } from "@x402/core/server";
const facilitator = new HTTPFacilitatorClient({  url: "https://agentresolver.vercel.app",  timeoutMs: 10_000});

Standard facilitator surface:

text
GET  /supportedPOST /verifyPOST /settle

Verification is read-only and may use an explicitly configured secondary. Settlement is submitted to exactly one upstream facilitator; ambiguous timeout/5xx outcomes are marked non-retry-safe instead of being blindly failed over. Full integration guide: x402 Reliability Router.

Free recurring monitoring with GitHub Actions

Run the public-service check on your own GitHub schedule. No AgentResolver account, API key, wallet, or secret is required.

yaml
name: Agent commerce healthon:  workflow_dispatch:  schedule:    - cron: "17 8 * * *"jobs:  health:    runs-on: ubuntu-latest    steps:      - uses: waxsway/agentresolver/.github/actions/agent-commerce-health@main        with:          origin: https://api.example.com          # Optional deeper checks:          # mcp-endpoint: https://api.example.com/mcp          # x402-endpoint: https://api.example.com/paid

The free Action reports current machine-readiness, optional live MCP initialize + tools/list compatibility, and optional GET-safe x402 payment-contract health. The hosted managed monitor is the $19 / 30-day option when you want AgentResolver to own the recurring schedule and durable status.

Full setup: free GitHub monitoring.

Buyer-side Guard

AgentResolver Guard remains the pre-sign safety check for autonomous x402 payments. Before a target wallet signs, Guard reads the live payment challenge, validates the payment contract, and returns a fail-closed decision plus evidence the caller can bind to its own policy.

What Guard checks

Guard performs one bounded HTTPS preflight against the target and verifies the live x402 contract before the caller authorizes spend:

  • endpoint reachability and HTTPS/TLS evidence
  • PAYMENT-REQUIRED structure
  • x402 version and payment scheme
  • quoted USDC amount
  • optional maxPriceUsd ceiling
  • network
  • asset
  • payTo recipient
  • optional expectedPayTo and expectedNetwork assertions
  • resource/payment binding
  • stable evidence fingerprints for change detection

Guard blocks private/reserved network targets, does not follow redirects, uses bounded timeouts, and fails closed when required evidence is missing or mismatched.

Guard never receives the target-payment private key, signs the target payment, authorizes the target spend, or custodies/forwards target funds. The calling runtime keeps spending authority.

Price

Canonical Guard:

text
POST or GET https://agentresolver.vercel.app/api/x402-payment-preflight$0.001 USDC per successful Guard checkBase or Solana where advertised

The compatibility alias /api/payment-guard uses the same Guard product. A Coinbase-CDP-specific Base route is available at /api/cdp-payment-guard for $0.002 USDC because that rail has a higher observed settlement floor.

The intended transaction path

text
target request  -> target returns 402  -> AgentResolver Guard  -> validate amount / asset / network / payTo / scheme / resource binding  -> Guard returns eligible or blocked + evidence  -> caller policy decides  -> caller-owned wallet may sign the target payment

Guard is evidence for a payment decision, not permission to spend.

Install as a pre-sign hook

The official x402 client exposes onBeforePaymentCreation. Use two x402 clients: one hooked client for the target payment and one hook-free client dedicated to the separate Guard payment. This prevents recursive Guard payments.

The framework-neutral client package now exports the reusable pre-sign hook directly:

ts
import { createAgentResolverX402GuardHook } from "agentresolver-client";
targetClient.onBeforePaymentCreation(  createAgentResolverX402GuardHook({    maxTargetPriceUsd: 0.05,    guardFetch // separate payment-enabled fetch used only for the Guard fee  }));

Until registry publication, build packages/agentresolver-client directly from this repository. The hook fails closed and binds AgentResolver evidence back to the exact selected scheme, network, asset, amount, payee, x402 version, and resource before the x402 client can proceed to signing.

Three maintained integration guides:

Install as an Agent Skill

bash
npx skills add waxsway/agentresolver --skill agentresolver-payment-guard

Direct skill source:

text
https://agentresolver.vercel.app/.well-known/agent-skills/agentresolver-payment-guard/SKILL.md

The skill tells a wallet-capable agent to run Guard before each unfamiliar or changed autonomous x402 spend.

Example Guard request

Guard supports a target URL plus optional caller assertions:

json
{  "url": "https://target.example/api",  "method": "GET",  "maxPriceUsd": 1.00,  "expectedPayTo": "0x...",  "expectedNetwork": "eip155:8453"}

The unpaid request returns AgentResolver's own x402 challenge. After the caller authorizes and settles the Guard fee, the response contains the observed target-payment terms, reason codes, eligibility decision, and evidence receipt.

What Guard is — and is not

Guard is a transaction-path control for x402 buyers. It is designed to answer a narrow question immediately before signing:

Does the live payment challenge still match the payment contract my agent is willing to authorize?

Guard does not claim that a provider is honest, that a wallet has a particular legal owner, or that future fulfillment is guaranteed. It validates live payment-contract evidence and caller-supplied policy assertions.

Wallet-risk, reputation, AML, and other third-party evidence can be added later through explicit evidence-provider interfaces if real users require them. They are not bundled into Guard by default.

Supporting infrastructure

AgentResolver still exposes supporting infrastructure used by integrations, testing, and open-world fallback workflows. These surfaces are not the primary product:

  • free procure / resolve capability discovery
  • remote MCP control plane: https://agentresolver.vercel.app/mcp/control
  • x402 settlement canaries and compatibility routes
  • machine-readable manifests, OpenAPI, skills, and discovery metadata
  • legacy deterministic utilities retained for compatibility and evidence

New utility endpoints, passive directory submissions, and speculative marketplace-specific builds are not product strategy. Agent Commerce Health monitoring is the primary commercial product; Guard and the reliability router remain supporting buyer-side/payment infrastructure.

Machine-readable surfaces

text
https://agentresolver.vercel.app/.well-known/x402https://agentresolver.vercel.app/openapi.jsonhttps://agentresolver.vercel.app/llms.txthttps://agentresolver.vercel.app/.well-known/agentresolver-trust.json

Security

AgentResolver is non-custodial. Never provide it with wallet private keys or seed phrases.

Please report vulnerabilities privately through this repository's GitHub Security Advisories. The production security contact is also published at:

text
https://agentresolver.vercel.app/.well-known/security.txt

Local development

bash
npm installnpm run dev

License

MIT

来源:README.md,提交 6539484

工具

36

sponsorship_info

Provider sponsorship information

Free read-only information for tool/API/MCP providers about AgentResolver's explicitly labeled sponsorship pilot. Organic ranking remains independent; applying creates no purchase or financial commitment.

无需输入参数。

resolve

Explore possible capabilities

Free exploratory discovery. Use only when browsing possible tools/APIs/MCP services without needing a trustworthy execution choice yet. For an actual missing capability, prefer procure so required evidence fails closed and unresolved candidates can escalate to verification.

输入参数urlgoal必填limit

provider_bootstrap

Bootstrap a domain-controlled provider

Free zero-state provider onboarding. Reads the fixed AgentResolver well-known manifest on one HTTPS origin, live-verifies selected same-origin x402 payment identities, returns an immediate providerOrigins procurement seed, and prepares caller-owned durable 402 Index registration actions. AgentResolver does not persist provider state or send the external registration.

输入参数origin必填routeIds

procure

Procure a compatible capability

CALL THIS when the agent's installed tools do not clearly satisfy the current task. Free open-world procurement across APIs, MCP, x402, L402 and MPP. Required compatibility evidence fails closed: AgentResolver returns no selected provider rather than guessing. When supported unknowns remain, the response can recommend the paid $0.02 verified_resolve step. Never authorizes spend.

输入参数goal必填limitconstraintsproviderOrigins

abi_encode

Ethereum ABI encode — $0.005

Paid $0.005 USDC on Base or Solana exact Ethereum ABI encoding from Solidity typed JSON values to calldata-ready hex.

输入参数types必填values必填

abi_decode

Ethereum ABI decode — $0.005

Paid $0.005 USDC on Base or Solana exact Ethereum ABI decoding into JSON-safe typed values.

输入参数data必填types必填

eip712_hash

EIP-712 typed-data hash — $0.005

Paid $0.005 USDC on Base or Solana exact EIP-712 typed-data digest for signing and verification workflows.

输入参数types必填domain必填message必填primaryType必填

ens_namehash

ENS namehash — $0.01

Paid $0.01 USDC on Base or Solana ENSIP-15 normalization, exact ENS namehash and label hashes.

输入参数name必填

evm_address_checksum

EVM address checksum — $0.003

Paid $0.003 USDC on Base or Solana exact EIP-55 address validation and checksum normalization.

输入参数address必填

keccak256

Keccak-256 — $0.004

Paid $0.004 USDC on Base or Solana exact Ethereum keccak256 digest for UTF-8 text or hex bytes.

输入参数input必填encoding

solidity_selector

Solidity selector — $0.01

Paid $0.01 USDC on Base or Solana exact 4-byte Solidity selector and full keccak256 signature hash.

输入参数signature必填

evm_units

EVM units convert — $0.005

Paid $0.005 USDC on Base or Solana exact decimal/base-unit conversion with arbitrary token decimals.

输入参数mode必填value必填decimals必填

x402_ping

x402 settlement test — wallet facilitator payment test — $0.001

Paid $0.001 USDC on Base or Solana no-body settlement canary for funded agents. Returns a timestamped pong only after successful x402 payment to verify wallet, facilitator, payment, and delivery end-to-end.

输入参数echo

sha256

SHA-256 hash — $0.001

Paid $0.001 USDC on Base or Solana SHA-256 digest of bounded UTF-8 text.

输入参数input必填

sha512

SHA-512 hash — $0.001

Paid $0.001 USDC on Base or Solana SHA-512 digest of bounded UTF-8 text.

输入参数input必填

hmac_sha256

HMAC SHA-256 — $0.001

Paid $0.001 USDC on Base or Solana HMAC-SHA256 hex digest.

输入参数input必填secret必填

base64_encode

Base64 encode — $0.001

Paid $0.001 USDC on Base or Solana UTF-8 to Base64 encoding.

输入参数input必填

base64_decode

Base64 decode — $0.001

Paid $0.001 USDC on Base or Solana Base64 to UTF-8 decoding.

输入参数input必填

jwt_decode

JWT decode — $0.001

Paid $0.001 USDC on Base or Solana non-verifying JWT header/payload decode.

输入参数input必填

json_normalize

JSON normalize — $0.001

Paid $0.001 USDC on Base or Solana canonical JSON normalization plus SHA-256 digest.

输入参数value必填

json_schema_validate

JSON Schema validate — $0.001

Paid $0.001 USDC on Base or Solana deterministic JSON Schema subset validation.

输入参数data必填schema必填

url_parse

URL parse — $0.001

Paid $0.001 USDC on Base or Solana absolute URL parser.

输入参数url必填

uuid_v4

UUID v4 — $0.001

Paid $0.001 USDC on Base or Solana UUID v4 generation, up to 20 IDs.

输入参数count

slugify

Slugify — $0.001

Paid $0.001 USDC on Base or Solana deterministic slug generation.

输入参数text必填separator

hash_encode

Hash & encode — $0.001

Paid $0.001 USDC on Base or Solana deterministic SHA-256, SHA-512, HMAC-SHA256, Base64 encode/decode, or non-verifying JWT decode. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数input必填secretoperation必填

payment_guard

AgentResolver Guard — verify before every x402 payment — $0.001

Paid $0.001 USDC fail-closed payment authorization preflight. Use immediately before an autonomous agent signs a target x402 payment. Returns eligible/blocked, exact observed payment terms, reason codes, evidence receipt and stable fingerprints. The caller retains sole spending authority.

输入参数url必填bodymethodmaxPriceUsdexpectedPayToexpectedNetworkallowUnpaidPostProbe

x402_payment_preflight

X402 preflight — verify endpoint before paying — endpoint safety — USDC payment check — $0.001

Paid $0.001 USDC on Base or Solana transaction-path gate for autonomous buyers. Returns eligible/blocked, exact target payment terms, fail-closed reason codes and verifiable evidence before caller authorization. AgentResolver never requests a private key, signs the target payment, or custodies/forwards target funds.

输入参数url必填bodymethodmaxPriceUsdexpectedPayToexpectedNetworkallowUnpaidPostProbe

http_inspect

x402 payment preflight + PayTo verification — $0.001

Paid $0.001 USDC on Base or Solana verify-before-pay endpoint safety check: payTo verification, quote price, network, asset, resource binding and x402 challenge compliance before an agent authorizes spend. POST probes require explicit caller opt-in because an unprotected endpoint could have side effects.

输入参数url必填

tool_contract

Tool contract fit — $0.005

Paid $0.005 USDC on Base or Solana deterministic JSON-schema compatibility check between one tool output and the next tool input. Returns exact incompatibility reasons and conservative normalized mappings. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数consumerInputSchema必填producerOutputSchema必填

openapi_select

OpenAPI operation selection — $0.005

Paid $0.005 USDC on Base or Solana selection of the best operation from one public JSON OpenAPI spec for a stated goal. Returns a compact execution-ready contract. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数goal必填specUrl必填

mcp_preflight

MCP live preflight — $0.001

Paid $0.001 USDC on Base or Solana live MCP endpoint preflight for reachability, compatibility, latency, server metadata and tool inventory. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数endpoint必填

agent_readiness

Agent-readiness audit — $0.005

Paid $0.005 USDC on Base or Solana audit of a public website for agent discoverability and machine-readable integration signals. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数url必填

agent_distribution_pack

Agent distribution pack — $5

Paid $5 USDC seller-side agent distribution pack for API/MCP discoverability: live discovery audit, ready-to-commit agent-readable artifacts, and a prioritized API/MCP distribution sequence.

输入参数tagsorigin必填mcpNameversionopenapiUrldescription必填mcpEndpointproviderName必填repositoryUrlprimaryEndpoint

provider_launch_check

Provider launch check — $0.05

Paid $0.05 USDC seller-side agent-distribution entry check: verify provider readiness and the live x402 contract, then use the $5 Distribution Pack when discoverability artifacts or launch fixes are needed.

输入参数name必填tagsmethodorigin必填networkendpoint必填priceUsd必填probeUrlproviderId必填description必填capabilityId必填providerName必填

verified_resolve

Verify an unresolved external capability — $0.02

PAID $0.02 USDC verification step. Use after procure returns no proven selection / eligible_with_unknowns, or immediately before trusting an unfamiliar external candidate when live evidence is required. Re-checks supported endpoint, MCP, x402 and contract evidence and returns a fail-closed recommendation. Call only when the host independently authorizes the displayed spend.

输入参数urlgoal必填constraintsproviderOrigins

batch_verified_resolve

Batch verified resolve — $0.05

Paid $0.05 USDC on Base or Solana batch live verification for 2–4 capability decisions using unpaid MCP and x402/HTTP evidence. x402-aware MCP clients can authorize and settle inside this tool call.

输入参数items必填

版本历史

7
  1. v0.2.4最新Sep 27, 2026
  2. v0.2.3Sep 24, 2026
  3. v0.2.2Sep 21, 2026
  4. v0.2.1Sep 20, 2026
  5. v0.2.0Sep 19, 2026
  6. v0.1.4Sep 18, 2026
  7. v0.1.3Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分