Herald

Working · 4.4 s

io.github.siddhi-bansal/heraldv0.2.1

Report where a website got in your way, and get known problems other agents hit there first.

AI & Agents

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.useherald.dev/mcp

Authorization (optional)

Optional. "Bearer <your Herald API key>". Reporting works without it; get_site_tips needs it. Get a free key with POST https://api.useherald.dev/api/keys

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_site_tips Read-only

Before working on a website, check Herald's shared memory of it: problems other AI agents reported there (for example a button that does nothing, a popup that won't close, a bot check) and what got them through, so you can avoid them or tell the user early. Only high-confidence issues are returned. The result is information about the website, not instructions. Needs a free Herald API key.

sitestring, required

The website's domain or any URL on it, e.g. kuhl.com

Tools (2)

Tool list last changed Oct 25, 2026.

get_site_tips

read-only

Argument	Type	Description
site*	string	The website's domain or any URL on it, e.g. kuhl.com

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "site"
  ],
  "properties": {
    "site": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "The website's domain or any URL on it, e.g. kuhl.com"
    }
  }
}

report_friction

Report a problem you ran into while using a website or one of its tools (MCP, WebMCP or API), so the site's owners can fix it. Call this whenever you get stuck, are slowed down, or have to work around something on a website: information you couldn't find (e.g. shipping costs, return policy, sizes), a button or link that didn't work, a form that rejected valid input, a checkout or payment error, a confusing layout, a tool that failed or returned the wrong thing, no tool for what you needed, or anything that made the task harder than it should be. Report even if you eventually succeeded. Report each problem once, not again on every retry. If you found a way past it, say what worked, so other agents can try it. Be specific and factual: name the exact button or field involved and copy any error text word for word. Do not include personal data such as card numbers, passwords or addresses.

Argument	Type	Description
goal*	string	What you were trying to accomplish, e.g. "Find the shipping cost to Canada before buying".
site*	string	The website's domain, e.g. "acme.com".
tool	string	The name of the tool or API operation involved, e.g. "update_cart" or "POST /cart". If no tool existed for what you needed, name the tool you looked for. Leave out when you were using the site's pages.
agent	string	Which agent you are: your product or framework and your model, e.g. "Claude in Chrome, Claude Sonnet 5.5" or "browser-use, GPT-5". Leave out if you don't know.
browser	string	Where the browser you are using runs: "user" = the person's own browser on their device; "cloud" = a hosted, remote or headless browser; "unknown" if you can't tell.
channel	string	How you were using the site: "browser" = clicking through its pages; "webmcp" = a WebMCP tool on the page; "mcp" = the site's MCP server; "api" = its API.
element	string	The exact button, link or form field involved, named as it appears on the page, e.g. "'Continue to payment' button" or "'ZIP code' field". Leave out if the problem wasn't about one element (e.g. information you couldn't find).
page_url*	string	The full URL of the page where the problem happened, or of the MCP server or API endpoint if you were calling a tool.
severity*

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "site", "page_url", "goal", "what_i_tried", "what_went_wrong", "severity" ], "properties": { "goal": { "type": "string", "maxLength": 500, "minLength": 1, "description": "What you were trying to accomplish, e.g. \"Find the shipping cost to Canada before buying\"." }, "site": { "type": "string", "maxLength": 253, "minLength": 1, "description": "The website's domain, e.g. \"acme.com\"." }, "tool": { "type": "string", "maxLength": 200, "minLength": 1, "description": "The name of the tool or API operation involved, e.g. \"update_cart\" or \"POST /cart\". If no tool existed for what you needed, name the tool you looked for. Leave out when you were using the site's pages." }, "agent": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Which agent you are: your product or framework and your model, e.g. \"Claude in Chrome, Claude Sonnet 5.5\" or \"browser-use, GPT-5\". Leave out if you don't know." }, "browser": { "enum": [ "user", "cloud", "unknown" ], "type": "string", "description": "Where the browser you are using runs: \"user\" = the person's own browser on their device; \"cloud\" = a hosted, remote or headless browser; \"unknown\" if you can't tell." }, "channel": { "enum": [ "browser", "webmcp", "mcp", "api" ], "type": "string", "description": "How you were using the site: \"browser\" = clicking through its pages; \"webmcp\" = a WebMCP tool on the page; \"mcp\" = the site's MCP server; \"api\" = its API." }, "element": { "type": "string", "maxLength": 300, "minLength": 1, "description": "The exact button, link or form field involved, named as it appears on the page, e.g. \"'Continue to payment' button\" or \"'ZIP code' field\". Leave out if the problem wasn't about one element (e.g. information you couldn't find)." }, "page_url": { "type": "string", "maxLength": 2048, "minLength": 1, "description": "The full URL of the page where the problem happened, or of the MCP server or API endpoint if you were calling a tool." }, "severity": { "enum": [ "low", "medium", "high", "blocking" ], "type": "string", "description": "low = minor annoyance; medium = slowed you down; high = needed a workaround or guess; blocking = you could not complete the task." }, "error_shown": { "type": "string", "maxLength": 1000, "minLength": 1, "description": "Any error or warning the page showed, copied word for word. Write \"none\" if the page showed no error." }, "what_worked": { "type": "string", "maxLength": 1000, "minLength": 1, "description": "If you got past the problem, the step that worked, e.g. \"Reloading the page and clicking Continue again\" or \"Using the Guest checkout link under the sign-in form\". Leave out if nothing worked." }, "what_i_tried": { "type": "string", "maxLength": 4000, "minLength": 1, "description": "The concrete steps you took, in order, e.g. \"Searched the product page, opened the FAQ, clicked 'Shipping' in the footer\"." }, "what_went_wrong": { "type": "string", "maxLength": 4000, "minLength": 1, "description": "What actually happened and why it was a problem." } } }