Skip to main content
Glama

Register a free document baseline

fresh402_register

Observes public content without modifying its source. Adds a Fresh402 baseline and uses free registration capacity for new watches; never charges USDC or credits. Use free ($0) Register to save a public HTTPS baseline; no trial key, wallet or payment. Required url plus optional content/attribute rules identifies the watch. Save returned watch_id/hash for Check, Smart Diff or OpenAPI Contract Diff. When flagship workflows are advertised, compatible Website/API workflows accept source_watch_id to adopt this public baseline with its exact rules/time for one separately authorized comparison; it grants no private ownership and performs no extra baseline fetch. Same URL/rules returns existing state without fetching or refreshing; different rules identify another watch. It is not continuous monitoring. HTML/JSON/text only; no JavaScript, private or authenticated targets. DNS/fetch/quota limits apply, including on repeat calls. For walletless first Check inspect root instant_evaluation.enabled and set evaluation:true; separate /v3/agent-trial requires ownership signing. Connection grants no signing or payment authority.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "url": "https://example.com/docs",
      "selector": "main",
      "ignore_selectors": [
        ".timestamp"
      ]
    },
    "name": "fresh402_register"
  }
}

Input Schema

NameRequiredDescriptionDefault
urlYesRequired absolute public HTTPS document URL, at most 4096 characters, e.g. 'https://example.com/docs'. Only port 443; no embedded credentials, private/local targets or authenticated pages. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. HTML, JSON and plain text are supported; JavaScript is not executed. DNS, redirect and size limits also apply.
selectorNoOptional HTML scope: a supported CSS selector, 1-256 characters, e.g. 'main' or 'article .content'. Only matching text is normalized; no match returns 422. Omit to normalize the page after built-in noise removal. Not supported for JSON or plain text.
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.
ignore_selectorsNoOptional array of up to 20 CSS selectors (each 1-256 characters) to remove from HTML in addition to built-in noise filtering. Default: no extra exclusions ([]). HTML only; use ignore_json_paths for JSON. Example: ['.timestamp', '.ad'].
ignore_json_pathsNoOptional array of up to 20 JSON Pointer-style paths to remove before JSON normalization and hashing. Each must start with '/' and be 1-256 characters; supports '*' segments. Default: [] (no exclusions). JSON only. Example: ['/updated_at', '/items/*/request_id'].

Output Schema

NameRequiredDescriptionDefault
urlNo
hashNo
noteNo
createdNo
raw_hashNo
watch_idNo
final_urlNo
next_stepNo
checked_atNo
created_atNo
content_kindNo
fetch_time_msNo
first_seen_atNo
content_lengthNo
html_attributesNo
baseline_createdNo
workflow_baselineNo
normalizer_versionNo
snapshot_truncatedNo
html_attribute_rules_versionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / url / pattern
      Added value: +"^[Hh][Tt][Tt][Pp][Ss]:\\/\\/"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "baseline_created": {
      +          "type": "boolean"
      +        },
      +        "checked_at": {
      +          "type": "string"
      +        },
      +        "content_kind": {
      +          "enum": [
      +            "html",
      +            "json",
      +            "text"
      +          ]
      +        },
      +        "content_length": {
      +          "type": "integer"
      +        },
      +        "created": {
      +          "type": "boolean"
      +        },
      +        "created_at": {
      +          "type": "string"
      +        },
      +        "fetch_time_ms": {
      +          "type": "integer"
      +        },
      +        "final_url": {
      +          "type": "string"
      +        },
      +        "first_seen_at": {
      +          "type": "string"
      +        },
      +        "hash": {
      +          "type": "string"
      +        },
      +        "html_attribute_rules_version": {
      +          "const": 1
      +        },
      +        "html_attributes": {
      +          "items": {
      +            "enum": [
      +              "href",
      +              "title",
      +              "alt",
      +              "aria-label"
      +            ]
      +          },
      +          "type": "array"
      +        },
      +        "next_step": {
      +          "type": "string"
      +        },
      +        "normalizer_version": {
      +          "type": "integer"
      +        },
      +        "note": {
      +          "type": "string"
      +        },
      +        "raw_hash": {
      +          "type": "string"
      +        },
      +        "snapshot_truncated": {
      +          "type": "boolean"
      +        },
      +        "url": {
      +          "type": "string"
      +        },
      +        "watch_id": {
      +          "type": "string"
      +        },
      +        "workflow_baseline": {
      +          "properties": {
      +            "candidates": {
      +              "items": {
      +                "properties": {
      +                  "additional_required_inputs": {
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "additional_validation": {
      +                    "type": "string"
      +                  },
      +                  "adopted_component": {
      +                    "type": "string"
      +                  },
      +                  "endpoint": {
      +                    "type": "string"
      +                  },
      +                  "requires_explicit_paid_authorization": {
      +                    "const": true
      +                  },
      +                  "source_input": {
      +                    "properties": {
      +                      "source_watch_id": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "type": "object"
      +                  },
      +                  "tool": {
      +                    "type": "string"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "compatible_retained_content": {
      +              "type": "boolean"
      +            },
      +            "limitation": {
      +              "type": "string"
      +            },
      +            "normalizer_version": {
      +              "type": "integer"
      +            },
      +            "ownership_granted": {
      +              "const": false
      +            },
      +            "public_evidence": {
      +              "const": true
      +            },
      +            "scope_override_allowed": {
      +              "const": false
      +            },
      +            "selected_snapshot_time": {
      +              "type": "string"
      +            },
      +            "source_watch_id": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "watch_id",
      +        "url",
      +        "created",
      +        "baseline_created",
      +        "hash"
      +      ],
      +      "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": {
      +    "baseline_created": {
      +      "type": "boolean"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "content_kind": {
      +      "enum": [
      +        "html",
      +        "json",
      +        "text"
      +      ]
      +    },
      +    "content_length": {
      +      "type": "integer"
      +    },
      +    "created": {
      +      "type": "boolean"
      +    },
      +    "created_at": {
      +      "type": "string"
      +    },
      +    "fetch_time_ms": {
      +      "type": "integer"
      +    },
      +    "final_url": {
      +      "type": "string"
      +    },
      +    "first_seen_at": {
      +      "type": "string"
      +    },
      +    "hash": {
      +      "type": "string"
      +    },
      +    "html_attribute_rules_version": {
      +      "const": 1
      +    },
      +    "html_attributes": {
      +      "items": {
      +        "enum": [
      +          "href",
      +          "title",
      +          "alt",
      +          "aria-label"
      +        ]
      +      },
      +      "type": "array"
      +    },
      +    "next_step": {
      +      "type": "string"
      +    },
      +    "normalizer_version": {
      +      "type": "integer"
      +    },
      +    "note": {
      +      "type": "string"
      +    },
      +    "raw_hash": {
      +      "type": "string"
      +    },
      +    "snapshot_truncated": {
      +      "type": "boolean"
      +    },
      +    "url": {
      +      "type": "string"
      +    },
      +    "watch_id": {
      +      "type": "string"
      +    },
      +    "workflow_baseline": {
      +      "properties": {
      +        "candidates": {
      +          "items": {
      +            "properties": {
      +              "additional_required_inputs": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "additional_validation": {
      +                "type": "string"
      +              },
      +              "adopted_component": {
      +                "type": "string"
      +              },
      +              "endpoint": {
      +                "type": "string"
      +              },
      +              "requires_explicit_paid_authorization": {
      +                "const": true
      +              },
      +              "source_input": {
      +                "properties": {
      +                  "source_watch_id": {
      +                    "type": "string"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "tool": {
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "compatible_retained_content": {
      +          "type": "boolean"
      +        },
      +        "limitation": {
      +          "type": "string"
      +        },
      +        "normalizer_version": {
      +          "type": "integer"
      +        },
      +        "ownership_granted": {
      +          "const": false
      +        },
      +        "public_evidence": {
      +          "const": true
      +        },
      +        "scope_override_allowed": {
      +          "const": false
      +        },
      +        "selected_snapshot_time": {
      +          "type": "string"
      +        },
      +        "source_watch_id": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  2. 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"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / url / description
      Previous value: -"Required absolute public HTTPS document URL, at most 4096 characters, e.g. 'https://example.com/docs'. Only port 443; no embedded credentials, private/local targets or authenticated pages. HTML, JSON and plain text are supported; JavaScript is not executed. DNS, redirect and size limits also apply."New value: +"Required absolute public HTTPS document URL, at most 4096 characters, e.g. 'https://example.com/docs'. Only port 443; no embedded credentials, private/local targets or authenticated pages. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. HTML, JSON and plain text are supported; JavaScript is not executed. DNS, redirect and size limits also apply."
  4. Changed8 schema fields changed
    • addedInput schema / description
      Added value: +"Register a free baseline using a required URL and optional content rules. The canonical URL plus rules identify the watch; changing rules creates a different watch. Repeating the same registration returns its existing watch_id/hash without fetching or refreshing it. Quotas apply. Reuse the returned watch_id in Check, Smart Diff or OpenAPI Contract Diff."
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "ignore_selectors": [
      +      ".timestamp"
      +    ],
      +    "selector": "main",
      +    "url": "https://example.com/docs"
      +  }
      +]
    • addedInput schema / properties / ignore_json_paths / description
      Added value: +"Optional array of up to 20 JSON Pointer-style paths to remove before JSON normalization and hashing. Each must start with '/' and be 1-256 characters; supports '*' segments. Default: [] (no exclusions). JSON only. Example: ['/updated_at', '/items/*/request_id']."
    • 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 array of up to 20 CSS selectors (each 1-256 characters) to remove from HTML in addition to built-in noise filtering. Default: no extra exclusions ([]). HTML only; use ignore_json_paths for JSON. Example: ['.timestamp', '.ad']."
    • 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 / selector / description
      Added value: +"Optional HTML scope: a supported CSS selector, 1-256 characters, e.g. 'main' or 'article .content'. Only matching text is normalized; no match returns 422. Omit to normalize the page after built-in noise removal. Not supported for JSON or plain text."
    • addedInput schema / properties / url / description
      Added value: +"Required absolute public HTTPS document URL, at most 4096 characters, e.g. 'https://example.com/docs'. Only port 443; no embedded credentials, private/local targets or authenticated pages. HTML, JSON and plain text are supported; JavaScript is not executed. DNS, redirect and size limits also apply."
  5. Changed2 schema fields changed
    • addedInput schema / properties / ignore_json_paths / items / pattern
      Added value: +"^\\/"
    • addedInput schema / properties / url / maxLength
      Added value: +4096
  6. First observed

TDQS

A4.2/5.0
Behavior5/5

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

Beyond the annotations, it discloses a lot of behavior an agent would otherwise have to guess: no USDC or credit charge, DNS/fetch/quota limits including on repeat calls, same URL/rules returning existing state without refetching, different rules creating a separate watch, and the exact rule/version semantics of html_attributes. The 'observes without modifying its source' phrasing reconciles with readOnlyHint=false by making clear the write is to Fresh402's own baseline store, and quota consumption on repeat calls is consistent with idempotentHint=false. It also states that the connection grants no signing or payment authority.

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 core guidance is buried under long semicolon-chained sentences, and the tail (walletless first Check instant_evaluation, /v3/agent-trial signing, 'Connection grants no signing or payment authority') is tangential to registering a baseline and dilutes the front-loaded purpose. The material is accurate but not structured for scanning; key facts such as the watch_id reuse and the no-refresh-on-repeat behavior compete with boilerplate disclaimers.

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?

Given five parameters, an output schema, and annotations covering safety and openness, the description supplies everything needed to call it correctly: cost, prerequisites, target restrictions, repeat-call behavior, and what to do with the return value. Any remaining detail (e.g. response shape) is covered by the output schema, so nothing an agent needs is 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 baseline is 3; the description does add some value by explaining that the canonical URL plus rules jointly identify the watch and that rule changes create a different watch. It does not add anything about url, selector, or the ignore arrays beyond what the schema already documents in detail. The added identity semantics are real but modest relative to a fully documented schema.

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

Purpose4/5

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

The description states the operation concretely: it observes public content without modifying the source, adds a Fresh402 baseline, and consumes free registration capacity to create a watch. It also distinguishes itself from continuous monitoring and from sibling tools that consume the resulting watch_id. The opening sentence is a bit oblique (it leads with 'observes public content' rather than 'registers a watch'), so the exact verb+resource arrives slightly late, but it is unambiguous once read.

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 when-to-use conditions ('Use free ($0) Register to save a public HTTPS baseline; no trial key, wallet or payment') plus concrete exclusions ('It is not continuous monitoring', no JavaScript/private/authenticated targets). It also routes the agent downstream ('Save returned watch_id/hash for Check, Smart Diff or OpenAPI Contract Diff') and explains the walletless trial path with evaluation:true, naming the separate signed /v3/agent-trial as an alternative.

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