Cursor
Grok Bot
Grok
MuseTitle99/100
Submit URL to Brave Search
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Submit one public http(s) URL to https://search.brave.com/submit-url using a real headless browser, then report what Brave's page actually showed. status=accepted only when an explicit success confirmation was observed; acceptance is not a guarantee of indexing. Takes up to ~80 seconds (typically 10-40). Never retry in a loop.
The description explains the capability, when to use it, and what to expect.
Inputs99/100
Input documentation gives an agent enough context to populate the arguments.
targetUrl
Absolute http(s) URL to submit to Brave Search for (re-)fetching, e.g. https://example.com/. No credentials in the URL; must be publicly reachable.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Output schema94/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"targetUrl",
"status",
"message",
"durationMs"
],
"properties": {
"status": {
"enum": [
"accepted",
"rejected",
"verification_required",
"timeout",
"error"
],
"type": "string",
"description": "accepted = Brave's page showed an explicit success confirmation; rejected = explicit error shown; verification_required = a human challenge persisted; timeout = no definitive state before the deadline; error = the run could not be completed."
},
"message": {
"type": "string",
"description": "What actually happened, in plain words."
},
"errorCode": {
"enum": [
"busy",
"rate_limited",
"recently_submitted",
"browser_launch_failed",
"navigation_failed",
"http_error",
"unexpected_navigation",
"input_not_found",
"input_mismatch",
"submit_button_not_found",
"submit_button_disabled",
"unexpected_error"
],
"type": "string",
"description": "Machine-readable reason when status is error."
},
"targetUrl": {
"type": "string",
"description": "The URL this call was asked to submit."
},
"durationMs": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Wall-clock time spent on this call."
},
"diagnostics": {
"type": "object",
"required": [
"observed",
"screenshotAttached"
],
"properties": {
"finalUrl": {
"type": "string",
"description": "Page URL at the end of the run, with query string and fragment removed."
},
"observed": {
"type": "array",
"items": {
"type": "string"
},
"description": "Compact timeline of distinct page states seen after clicking Submit."
},
"domExcerpt": {
"type": "string",
"description": "Sanitized, truncated visible text of the page at the end of the run."
},
"screenshotAttached": {
"type": "boolean",
"description": "True when a JPEG screenshot is attached as an image content block."
}
},
"description": "Present when status is not accepted.",
"additionalProperties": false
},
"confirmationText": {
"type": "string",
"description": "Verbatim confirmation text observed on Brave's page (accepted only)."
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Earliest sensible retry, for local limit responses.",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}