Skip to main content
Glama

Observe document changes

fresh402_check
Destructive

Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials and with evaluation:true omitted, a valid call returns an unpaid quote without executing the observation. Use Check for on-demand changed/unchanged, hash, cache status and optional text diff across sessions. Exactly one url or real watch_id; URL/rules can create a watch, while watch_id reuses rules and forbids overrides. Save returned ID/hash. First URL observation may return changed:null. max_age_seconds defaults0 (conditional revalidation); positive age permits cached evidence. html_attributes observes selected same-text attribute changes. Public HTTPS, no JavaScript or scheduler. Use Smart Diff for structured changes; when advertised, Website Change Intelligence combines observation and supported evidence in one charge. Walletless first Check: require root instant_evaluation.enabled, then set evaluation:true with valid URL/watch input. One attempt per verified network prefix per approved period, sharing finite capacity; no wallet, key, custom header or proprietary SDK. Exact replay returns retained evidence, not a new fetch;429 never authorizes payment. $0.005 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta["fresh402/prepaid"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.

Input Schema

NameRequiredDescriptionDefault
urlNoSupply exactly one of url or watch_id. URL must be absolute public HTTPS on port 443, at most 4096 characters, with no credentials/private targets, e.g. 'https://example.com/docs'. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. With url, optional content rules identify the watch; an existing watch is reused or a new one is created by this paid Check. Separate registration is not required. No JavaScript rendering.
selectorNoOptional HTML CSS scope, 1-256 characters, e.g. 'main'; accepted only with url. Omit for the page after built-in noise removal. No match returns 422; not supported for JSON/plain text. With watch_id, omit this field: the saved selector is reused.
watch_idNoSupply exactly one of watch_id or url. An existing ID returned by fresh402_register (free), POST /v1/register, or a URL-based Check: 'w_' followed by 32 lowercase hexadecimal characters. Reuses that watch's stored URL and rules. When supplied, omit selector, ignore_selectors and ignore_json_paths entirely, even empty arrays. Do not invent an ID.
evaluationNoOptional, default false. Set true to request one walletless Check attempt per verified network prefix during the current approved evaluation period. No wallet, API key or payment header is needed. Shared capacity and source limits apply; repeat the identical input to recover its retained result. A network is not a unique agent. Never combine true with paid/prepaid/trial credentials. False or omission keeps normal paid behavior. Inspect live availability before requesting evaluation.
include_diffNoOptional boolean; runtime default: true. Request a compact deterministic text diff when content changed and compatible prior text is retained. False omits the diff; true cannot recover unavailable old content and does not enable Smart Diff's structural analysis.
previous_hashNoOptional previous Fresh402 content hash: exactly 64 hexadecimal characters, case-insensitive. Overrides comparison with the watch's current stored hash. Omit to use that stored hash; a new URL watch without a prior hash returns changed:null. Hash comparison does not require retained old text, but a text diff does; a hash cannot reconstruct missing content.
html_attributesNoOptional HTML-only watch rule: up to4 of href,title,alt,aria-label; default[] retains existing text-only normalization. Distinct names are sorted; nonempty rules create a separate version1 watch/baseline. Records bounded meaningful attributes within the saved selector or filtered page, including same-text link destination changes. Cannot be supplied with watch_id, even[]. Unsafe hrefs are hashed, never fetched. Limits:200 elements,2048 characters/value,32768 evidence bytes; excess fails, never clips silently.
max_age_secondsNoOptional integer cache age in seconds, 0-86400; runtime default: 0. A positive value permits reuse of a sufficiently recent watch result without fetching. Zero contacts the source (conditional HTTP may return 304). Cached Checks still require payment; this does not schedule background polling.
ignore_selectorsNoOptional HTML-only exclusion array, up to 20 supported CSS selectors of 1-256 characters each, e.g. ['.timestamp']. Accepted only with url; default []. With watch_id, omit the field entirely (including []): saved exclusions are reused.
ignore_json_pathsNoOptional JSON-only exclusions, up to 20 paths of 1-256 characters starting with '/'; '~0'/'~1' escapes and '*' segments are supported. Example: ['/updated_at']. Accepted only with url; default []. With watch_id, omit entirely (including []): saved paths are reused.

Output Schema

NameRequiredDescriptionDefault
urlNo
diffNo
hashNo
cachedNo
changedNo
watch_idNo
final_urlNo
checked_atNo
observationNoScoped observation status, exact observation time and live-versus-retained execution; no claim about excluded fields or runtime API behavior.
raw_changedNo
cache_statusNo
content_kindNo
previous_hashNo
noise_detectedNo
snapshot_savedNo
html_attributesNo
network_fetchedNo
comparison_sourceNo
persistence_errorNo
normalizer_versionNo
snapshot_truncatedNo
html_attribute_rules_versionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "cache_status": {
      -        "type": "string"
      -      },
      -      "cached": {
      -        "type": "boolean"
      -      },
      -      "changed": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "checked_at": {
      -        "type": "string"
      -      },
      -      "comparison_source": {
      -        "type": "string"
      -      },
      -      "content_kind": {
      -        "type": "string"
      -      },
      -      "diff": {
      -        "$ref": "#/$defs/TextDiff"
      -      },
      -      "final_url": {
      -        "type": "string"
      -      },
      -      "hash": {
      -        "type": "string"
      -      },
      -      "html_attribute_rules_version": {
      -        "const": 1
      -      },
      -      "html_attributes": {
      -        "items": {
      -          "enum": [
      -            "href",
      -            "title",
      -            "alt",
      -            "aria-label"
      -          ]
      -        },
      -        "type": "array"
      -      },
      -      "network_fetched": {
      -        "type": "boolean"
      -      },
      -      "noise_detected": {
      -        "type": "boolean"
      -      },
      -      "normalizer_version": {
      -        "type": "integer"
      -      },
      -      "persistence_error": {
      -        "type": "string"
      -      },
      -      "previous_hash": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "raw_changed": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "snapshot_saved": {
      -        "type": "boolean"
      -      },
      -      "snapshot_truncated": {
      -        "type": "boolean"
      -      },
      -      "url": {
      -        "type": "string"
      -      },
      -      "watch_id": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "watch_id",
      -      "hash",
      -      "changed",
      -      "content_kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Tool error only; accompanied by isError=true.",
      -    "properties": {
      -      "error": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "retryable": {
      -        "type": "boolean"
      -      },
      -      "status": {
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      -    "properties": {
      -      "accepts": {
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "resource": {
      -        "type": "object"
      -      },
      -      "x402Version": {
      -        "const": 2
      -      }
      -    },
      -    "required": [
      -      "x402Version",
      -      "accepts"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "cache_status": {
      +        "type": "string"
      +      },
      +      "cached": {
      +        "type": "boolean"
      +      },
      +      "changed": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "checked_at": {
      +        "type": "string"
      +      },
      +      "comparison_source": {
      +        "type": "string"
      +      },
      +      "content_kind": {
      +        "type": "string"
      +      },
      +      "diff": {
      +        "$ref": "#/$defs/TextDiff"
      +      },
      +      "final_url": {
      +        "type": "string"
      +      },
      +      "hash": {
      +        "type": "string"
      +      },
      +      "html_attribute_rules_version": {
      +        "const": 1
      +      },
      +      "html_attributes": {
      +        "items": {
      +          "enum": [
      +            "href",
      +            "title",
      +            "alt",
      +            "aria-label"
      +          ]
      +        },
      +        "type": "array"
      +      },
      +      "network_fetched": {
      +        "type": "boolean"
      +      },
      +      "noise_detected": {
      +        "type": "boolean"
      +      },
      +      "normalizer_version": {
      +        "type": "integer"
      +      },
      +      "observation": {
      +        "description": "Scoped observation status, exact observation time and live-versus-retained execution; no claim about excluded fields or runtime API behavior.",
      +        "type": "object"
      +      },
      +      "persistence_error": {
      +        "type": "string"
      +      },
      +      "previous_hash": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "raw_changed": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "snapshot_saved": {
      +        "type": "boolean"
      +      },
      +      "snapshot_truncated": {
      +        "type": "boolean"
      +      },
      +      "url": {
      +        "type": "string"
      +      },
      +      "watch_id": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "watch_id",
      +      "hash",
      +      "changed",
      +      "content_kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Tool error only; accompanied by isError=true.",
      +    "properties": {
      +      "error": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "retryable": {
      +        "type": "boolean"
      +      },
      +      "status": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +    "properties": {
      +      "accepts": {
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "resource": {
      +        "type": "object"
      +      },
      +      "x402Version": {
      +        "const": 2
      +      }
      +    },
      +    "required": [
      +      "x402Version",
      +      "accepts"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / observation
      Added value: +{
      +  "description": "Scoped observation status, exact observation time and live-versus-retained execution; no claim about excluded fields or runtime API behavior.",
      +  "type": "object"
      +}
  2. Changed3 schema fields changed
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "required": [
      -      "url"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "watch_id"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "watch_id"
      +      ]
      +    },
      +    "required": [
      +      "url"
      +    ]
      +  },
      +  {
      +    "not": {
      +      "anyOf": [
      +        {
      +          "required": [
      +            "url"
      +          ]
      +        },
      +        {
      +          "required": [
      +            "selector"
      +          ]
      +        },
      +        {
      +          "required": [
      +            "ignore_selectors"
      +          ]
      +        },
      +        {
      +          "required": [
      +            "ignore_json_paths"
      +          ]
      +        },
      +        {
      +          "required": [
      +            "html_attributes"
      +          ]
      +        }
      +      ]
      +    },
      +    "required": [
      +      "watch_id"
      +    ]
      +  }
      +]
    • addedInput schema / properties / url / pattern
      Added value: +"^[Hh][Tt][Tt][Pp][Ss]:\\/\\/"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "TextDiff": {
      +      "properties": {
      +        "added_excerpt": {
      +          "type": "string"
      +        },
      +        "available": {
      +          "type": "boolean"
      +        },
      +        "change_ratio": {
      +          "type": "number"
      +        },
      +        "changed": {
      +          "type": "boolean"
      +        },
      +        "content_truncated": {
      +          "type": "boolean"
      +        },
      +        "excerpt_truncated": {
      +          "description": "True when bounded contextual added/removed excerpts were clipped; independent of retained snapshot completeness.",
      +          "type": "boolean"
      +        },
      +        "reason": {
      +          "type": "string"
      +        },
      +        "removed_excerpt": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "cache_status": {
      +          "type": "string"
      +        },
      +        "cached": {
      +          "type": "boolean"
      +        },
      +        "changed": {
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "checked_at": {
      +          "type": "string"
      +        },
      +        "comparison_source": {
      +          "type": "string"
      +        },
      +        "content_kind": {
      +          "type": "string"
      +        },
      +        "diff": {
      +          "$ref": "#/$defs/TextDiff"
      +        },
      +        "final_url": {
      +          "type": "string"
      +        },
      +        "hash": {
      +          "type": "string"
      +        },
      +        "html_attribute_rules_version": {
      +          "const": 1
      +        },
      +        "html_attributes": {
      +          "items": {
      +            "enum": [
      +              "href",
      +              "title",
      +              "alt",
      +              "aria-label"
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        "network_fetched": {
      +          "type": "boolean"
      +        },
      +        "noise_detected": {
      +          "type": "boolean"
      +        },
      +        "normalizer_version": {
      +          "type": "integer"
      +        },
      +        "persistence_error": {
      +          "type": "string"
      +        },
      +        "previous_hash": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "raw_changed": {
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "snapshot_saved": {
      +          "type": "boolean"
      +        },
      +        "snapshot_truncated": {
      +          "type": "boolean"
      +        },
      +        "url": {
      +          "type": "string"
      +        },
      +        "watch_id": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "watch_id",
      +        "hash",
      +        "changed",
      +        "content_kind"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "description": "Tool error only; accompanied by isError=true.",
      +      "properties": {
      +        "error": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "retryable": {
      +          "type": "boolean"
      +        },
      +        "status": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "error"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.",
      +      "properties": {
      +        "accepts": {
      +          "minItems": 1,
      +          "type": "array"
      +        },
      +        "resource": {
      +          "type": "object"
      +        },
      +        "x402Version": {
      +          "const": 2
      +        }
      +      },
      +      "required": [
      +        "x402Version",
      +        "accepts"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.",
      +  "properties": {
      +    "cache_status": {
      +      "type": "string"
      +    },
      +    "cached": {
      +      "type": "boolean"
      +    },
      +    "changed": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "comparison_source": {
      +      "type": "string"
      +    },
      +    "content_kind": {
      +      "type": "string"
      +    },
      +    "diff": {
      +      "$ref": "#/$defs/TextDiff"
      +    },
      +    "final_url": {
      +      "type": "string"
      +    },
      +    "hash": {
      +      "type": "string"
      +    },
      +    "html_attribute_rules_version": {
      +      "const": 1
      +    },
      +    "html_attributes": {
      +      "items": {
      +        "enum": [
      +          "href",
      +          "title",
      +          "alt",
      +          "aria-label"
      +        ]
      +      },
      +      "type": "array"
      +    },
      +    "network_fetched": {
      +      "type": "boolean"
      +    },
      +    "noise_detected": {
      +      "type": "boolean"
      +    },
      +    "normalizer_version": {
      +      "type": "integer"
      +    },
      +    "persistence_error": {
      +      "type": "string"
      +    },
      +    "previous_hash": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "raw_changed": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "snapshot_saved": {
      +      "type": "boolean"
      +    },
      +    "snapshot_truncated": {
      +      "type": "boolean"
      +    },
      +    "url": {
      +      "type": "string"
      +    },
      +    "watch_id": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / evaluation
      Added value: +{
      +  "description": "Optional, default false. Set true to request one walletless Check attempt per verified network prefix during the current approved evaluation period. No wallet, API key or payment header is needed. Shared capacity and source limits apply; repeat the identical input to recover its retained result. A network is not a unique agent. Never combine true with paid/prepaid/trial credentials. False or omission keeps normal paid behavior. Inspect live availability before requesting evaluation.",
      +  "type": "boolean"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / html_attributes
      Added value: +{
      +  "description": "Optional HTML-only watch rule: up to4 of href,title,alt,aria-label; default[] retains existing text-only normalization. Distinct names are sorted; nonempty rules create a separate version1 watch/baseline. Records bounded meaningful attributes within the saved selector or filtered page, including same-text link destination changes. Cannot be supplied with watch_id, even[]. Unsafe hrefs are hashed, never fetched. Limits:200 elements,2048 characters/value,32768 evidence bytes; excess fails, never clips silently.",
      +  "items": {
      +    "description": "One explicitly observed HTML attribute: href (a/area only),title,alt or aria-label. No class/style/event attributes; links are inert evidence and never fetched.",
      +    "enum": [
      +      "alt",
      +      "aria-label",
      +      "href",
      +      "title"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 4,
      +  "type": "array"
      +}
  5. Changed1 schema field changed
    • addedInput schema / oneOf
      Added value: +[
      +  {
      +    "required": [
      +      "url"
      +    ]
      +  },
      +  {
      +    "required": [
      +      "watch_id"
      +    ]
      +  }
      +]
  6. Changed1 schema field changed
    • changedInput schema / properties / url / description
      Previous value: -"Supply exactly one of url or watch_id. URL must be absolute public HTTPS on port 443, at most 4096 characters, with no credentials/private targets, e.g. 'https://example.com/docs'. With url, optional content rules identify the watch; an existing watch is reused or a new one is created by this paid Check. Separate registration is not required. No JavaScript rendering."New value: +"Supply exactly one of url or watch_id. URL must be absolute public HTTPS on port 443, at most 4096 characters, with no credentials/private targets, e.g. 'https://example.com/docs'. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. With url, optional content rules identify the watch; an existing watch is reused or a new one is created by this paid Check. Separate registration is not required. No JavaScript rendering."
  7. Changed12 schema fields changed
    • addedInput schema / description
      Added value: +"Paid Check input: exactly one of url or watch_id is required. Content rules are allowed only on the url path; watch_id always reuses saved rules. Optional previous_hash overrides the reference hash; max_age_seconds controls cache reuse and include_diff controls text-diff output."
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "include_diff": true,
      +    "max_age_seconds": 0,
      +    "selector": "main",
      +    "url": "https://example.com/docs"
      +  }
      +]
    • addedInput schema / properties / ignore_json_paths / description
      Added value: +"Optional JSON-only exclusions, up to 20 paths of 1-256 characters starting with '/'; '~0'/'~1' escapes and '*' segments are supported. Example: ['/updated_at']. Accepted only with url; default []. With watch_id, omit entirely (including []): saved paths are reused."
    • addedInput schema / properties / ignore_json_paths / items / description
      Added value: +"JSON Pointer-style path, 1-256 characters, starting with '/'. Decode '~0' as '~' and '~1' as '/'; '*' matches all object keys or array elements. Example: '/items/*/updated_at'."
    • addedInput schema / properties / ignore_selectors / description
      Added value: +"Optional HTML-only exclusion array, up to 20 supported CSS selectors of 1-256 characters each, e.g. ['.timestamp']. Accepted only with url; default []. With watch_id, omit the field entirely (including []): saved exclusions are reused."
    • addedInput schema / properties / ignore_selectors / items / description
      Added value: +"HTML element(s) to remove before normalization: a supported CSS selector, 1-256 characters, e.g. '.timestamp' or 'nav'."
    • addedInput schema / properties / include_diff / description
      Added value: +"Optional boolean; runtime default: true. Request a compact deterministic text diff when content changed and compatible prior text is retained. False omits the diff; true cannot recover unavailable old content and does not enable Smart Diff's structural analysis."
    • addedInput schema / properties / max_age_seconds / description
      Added value: +"Optional integer cache age in seconds, 0-86400; runtime default: 0. A positive value permits reuse of a sufficiently recent watch result without fetching. Zero contacts the source (conditional HTTP may return 304). Cached Checks still require payment; this does not schedule background polling."
    • addedInput schema / properties / previous_hash / description
      Added value: +"Optional previous Fresh402 content hash: exactly 64 hexadecimal characters, case-insensitive. Overrides comparison with the watch's current stored hash. Omit to use that stored hash; a new URL watch without a prior hash returns changed:null. Hash comparison does not require retained old text, but a text diff does; a hash cannot reconstruct missing content."
    • addedInput schema / properties / selector / description
      Added value: +"Optional HTML CSS scope, 1-256 characters, e.g. 'main'; accepted only with url. Omit for the page after built-in noise removal. No match returns 422; not supported for JSON/plain text. With watch_id, omit this field: the saved selector is reused."
    • addedInput schema / properties / url / description
      Added value: +"Supply exactly one of url or watch_id. URL must be absolute public HTTPS on port 443, at most 4096 characters, with no credentials/private targets, e.g. 'https://example.com/docs'. With url, optional content rules identify the watch; an existing watch is reused or a new one is created by this paid Check. Separate registration is not required. No JavaScript rendering."
    • addedInput schema / properties / watch_id / description
      Added value: +"Supply exactly one of watch_id or url. An existing ID returned by fresh402_register (free), POST /v1/register, or a URL-based Check: 'w_' followed by 32 lowercase hexadecimal characters. Reuses that watch's stored URL and rules. When supplied, omit selector, ignore_selectors and ignore_json_paths entirely, even empty arrays. Do not invent an ID."
  8. Changed2 schema fields changed
    • addedInput schema / properties / ignore_json_paths / items / pattern
      Added value: +"^\\/"
    • addedInput schema / properties / url / maxLength
      Added value: +4096
  9. First observed

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, the description discloses that execution can charge USDC or prepaid credits, consume trial quota, update Fresh402 records, require prior spending authorization, return an unpaid quote without credentials, and that 429 responses never authorize payment. It also explains replay behavior, payment-network selection, and recovery expectations, which is unusually rich behavioral context. The destructiveHint=true annotation is consistent with billing side effects even though the observed source document itself is not modified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded, but the description is an extremely long, dense single paragraph covering billing, trial, evaluation, payment networks, recovery, and edge cases. Much of the operational detail is relevant, but the lack of structure and sheer length make it hard for an agent to scan. It is not concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex paid observation tool with billing, trial, evaluation, watch creation, cache, and multi-network payment behavior, the description is highly complete. It covers prerequisites, failure modes, replay semantics, and recovery guidance, and an output schema exists so return-value details need not be repeated. Nothing essential appears missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all ten parameters in detail. The description reinforces key constraints such as exactly one url or watch_id, watch_id forbidding overrides, max_age_seconds defaulting to 0, and html_attributes observing selected same-text attribute changes, but it adds little meaning beyond the schema text. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: "Observes public documents without modifying their source." It further states "Use Check for on-demand changed/unchanged, hash, cache status and optional text diff across sessions" and explicitly contrasts Check with Smart Diff and Website Change Intelligence, so an agent can distinguish it from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit usage conditions: exactly one of url or watch_id, URL-based checks may create a watch, watch_id reuses saved rules and forbids overrides, and Smart Diff should be used for structured changes. It also names billing/trial/evaluation paths and says to choose one billing method and never auto-pay, which is strong when-to-use and when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources