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 分