check_url
Read-onlyIdempotent
Analyze website URLs for security threats by checking domain age, SSL certificates, redirect chains, brand impersonation, and multiple threat intelligence sources to determine risk levels.
Instructions
Check a website URL for safety. Analyzes domain age, SSL certificate, redirect chains, brand impersonation, Google Web Risk, URLhaus, ThreatFox, and community reports. Returns risk score and detailed signals.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | URL to check (must include protocol, e.g. https://example.com) | |
| force_refresh | No | Force a fresh lookup, bypassing cache (default: false) |
Implementation Reference
- src/index.ts:186-193 (handler)The handler implementation for the 'check_url' tool which sends a POST request to the API.
async ({ url, force_refresh }) => { try { const data = await apiPost('/api/v1/url/lookup', { url, force_refresh }); return jsonResult(data); } catch (err) { return errorResult(err instanceof Error ? err.message : 'URL lookup failed'); } }, - src/index.ts:172-194 (registration)Registration of the 'check_url' tool using server.tool.
server.tool( 'check_url', 'Check a website URL for safety. Analyzes domain age, SSL certificate, redirect chains, brand impersonation, Google Web Risk, URLhaus, ThreatFox, and community reports. Returns risk score and detailed signals.', { url: z.string().describe('URL to check (must include protocol, e.g. https://example.com)'), force_refresh: z.boolean().optional().describe('Force a fresh lookup, bypassing cache (default: false)'), }, { title: 'Check URL Safety', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, async ({ url, force_refresh }) => { try { const data = await apiPost('/api/v1/url/lookup', { url, force_refresh }); return jsonResult(data); } catch (err) { return errorResult(err instanceof Error ? err.message : 'URL lookup failed'); } }, );