Qualify a business lead or counterparty
qualify_counterpartyQualifies a business that made contact (a form submission, an inquiry, an outreach reply). Input: the sender's e-mail (or the company domain), the company name if given, and the context (form type, message, stated value, stated role). Jid checks the domain (MX, SPF, DMARC, registration date over RDAP, the website), matches it to a Jid business file, reads that file's registrations, licences, filings, capital raises, loans and adverse records, and returns signals (each with source, source_url, verified_at), three scores (legitimacy, capacity, consistency, 0 to 100 with reasons), checks (each pass, fail or unknown with one line of evidence) and a read: a one-line headline ("Passed all 7 checks Jid could run. Recommendation: engage."), the recommendation (engage, verify_first, do_not_engage), the failed checks and up to 4 links to verify by hand, plus a signed receipt reference. detail "full" adds each signal's raw value, each check's lookup link and the full signed receipt. Businesses only: personal webmail or no matched business returns individual_or_unverified with no scores. A possible list match is returned as 'review', not as a finding. Counts as 2 checks with a key; free tier without one. Not intended for credit, employment, insurance or housing decisions about any person.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"form_type": "<form_type>"
},
"name": "qualify_counterparty"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | The submitting website's domain (binds the signal token) | |
| No | Sender's e-mail address | ||
| detail | No | compact (default): signals without raw values and a receipt reference; full: raw signal values and the full signed receipt | |
| domain | No | Company domain, when no e-mail is available | |
| ip_asn | No | ASN of the submitting network, to recognise hosting and VPN networks | |
| policy | No | How cautious `engage` is (default balanced) | |
| 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 | |
| country | No | Stated country, ISO 3166-1 alpha-2 | |
| message | No | The submission's free text (hashed, never stored) | |
| summary | No | Add a short plain-English summary grounded in the signals (with an API key only) | |
| activity | No | Regulated activity whose licences matter, if any | |
| form_type | Yes | What kind of submission this is | |
| ip_region | No | Region the submission came from (ISO 3166-2, e.g. US-CA or CA) | |
| ip_country | No | Country the submission came from, ISO alpha-2 (location consistency check) | |
| stated_role | No | The sender's stated role | |
| company_name | No | Company name as stated by the sender | |
| stated_value | No | Deal or purchase size the sender states, USD | |
| stated_country | No | Country the submitter stated (same as country) | |
| claimed_website | No | For vendor_claim / listing_claim: the website of the business or listing being claimed (enables the affiliation check) | |
| browser_timezone | No | IANA time zone reported by the submitter's browser |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| note | Yes | Terms of use for the facts | |
| read | Yes | What a person sees: headline, recommendation, failed checks and lookup links | |
| checks | Yes | ||
| entity | No | ||
| receipt | No | ||
| signals | Yes | ||
| summary | No | ||
| capacity | No | ||
| assessment | Yes | business | individual_or_unverified | |
| checked_at | No | ||
| legitimacy | No | ||
| checks_used | Yes | ||
| consistency | No | ||
| recommendation | Yes | engage | verify_first | do_not_engage, with the reason | |
| questions_to_ask | No | ||
| suggested_next_step | No |