Should I engage? (screen a lead, sender, vendor or website)
screenScreens a lead, sender, vendor or website and returns an engage-or-not answer. Input: any of domain, url, email, phone or company_name, the context (lead, inbound_email, partnership, vendor, purchase, marketplace_seller, agent_action), an optional amount (USD) and a policy (strict, balanced, permissive; default balanced). Returns engage (true or false), risk (low, medium, high, unknown), confidence 0 to 1, subject_type, reasons (each with source and evidence), mitigations, checks, a read (headline, recommendation engage | verify_first | do_not_engage, failed checks, lookup links) and a signed receipt_id. Deterministic, no AI in the decision, usually under a second. A possible sanctions name match returns engage=false with 'manual review', not a finding. For individuals only technical checks of the address, phone or domain run. engage is advisory. Rules: https://jid.com/screen-rules. Counts as 1 check with a key; free tier without one.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "screen"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Website or page URL (purchase checks: only the host is used) | |
| site | No | The submitting website's domain (binds the signal token) | |
| No | Sender e-mail address (hashed on the receipt, never stored) | ||
| phone | No | Phone number, ideally in +E.164 | |
| amount | No | Amount at stake, USD | |
| domain | No | Company domain | |
| ip_asn | No | ASN of the request's network, to recognise hosting and VPN networks | |
| policy | No | strict, balanced (default) or permissive | |
| signal | No | Jid Signals token (the form's jid_signal field): Jid's own reading of the visitor's location; replaces the ip_* fields when it verifies | |
| context | No | What engaging means here; default lead (purchase when only a url or domain is given) | |
| country | No | Default country for a phone number without +, ISO alpha-2 | |
| ip_region | No | Region of the request (ISO 3166-2, e.g. US-CA or CA) | |
| ip_country | No | Country the request came from (ISO alpha-2), for the location consistency check | |
| company_name | No | Company name as stated | |
| stated_country | No | Country the counterparty stated | |
| browser_timezone | No | IANA time zone reported by the browser |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | Terms of use for the facts | |
| read | Yes | What a person sees: headline, recommendation, failed checks and lookup links | |
| risk | Yes | low | medium | high | unknown | |
| checks | Yes | ||
| engage | Yes | ||
| entity | No | ||
| policy | No | ||
| context | No | ||
| reasons | Yes | ||
| summary | No | ||
| rules_url | No | ||
| checked_at | No | ||
| confidence | Yes | ||
| receipt_id | Yes | ||
| checks_used | Yes | ||
| mitigations | No | ||
| receipt_url | No | ||
| subject_type | Yes |