Jid: the trust API for AI agents
Verify a business before an agent pays, signs or buys: registry-cited decision and signed receipt.
Should I use this
Quality & Safety
A
Findings (2)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin screen
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~7,013Tokens (tool definitions)
~10.0 KBTypical response size
Significant attention impact (5.48% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"jid": {
"url": "https://jid.com/mcp"
}
}
}Remote endpoints
https://jid.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢search_business(query)
Finds Jid business files by name or by any registry number (FEI, LEI, SEC CIK, DUNS, NDC labeler code, state licence or entity number). Returns candidate files with status and match evidence.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 2,
"maxLength": 200,
"description": "Business name or registry number"
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Jid file id for verify_business / get_business_file"
},
"name": {
"type": "string"
},
"location": {
"type": "string"
},
"status": {
"type": [
"string",
"null"
]
},
"status_summary": {
"type": [
"string",
"null"
]
},
"facts": {
"type": [
"number",
"null"
]
},
"sources": {
"type": [
"number",
"null"
]
},
"matched_on": {},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"location",
"status",
"url"
],
"additionalProperties": {}
}
},
"next": {
"type": "string"
}
},
"required": [
"query",
"results",
"next"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢get_business_file(id, detail)
The Jid file for one business. Default (compact): status with its flags, identifiers, verified websites, the top facts with source and verification date, counts and the latest changes. With detail "full": every current fact with its source, verification date, next check and confidence, owner statements (labelled self-reported), possible matches and the change history.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Jid file id from search_business, e.g. gland-pharma-limited-j9nehi"
},
"detail": {
"description": "compact (default): the verdict, status, identifiers and top facts with sources; full: every fact with its provenance",
"type": "string",
"enum": [
"compact",
"full"
]
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"file_checked_at": {
"type": [
"string",
"null"
]
},
"owner_status": {
"description": "claimed | public_record",
"type": "string"
},
"status": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"flags": {
"description": "Compact: \"tone: label\" strings; full: objects",
"type": "array",
"items": {}
},
"rules": {
"type": "string"
}
},
"required": [
"status"
],
"additionalProperties": {}
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {}
},
"required": [
"type",
"value"
],
"additionalProperties": {}
}
},
"identifiers_total": {
"type": "number"
},
"websites_verified": {
"type": "array",
"items": {
"type": "string"
}
},
"top_facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"predicate": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {},
"value_truncated": {
"type": "boolean",
"const": true
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"predicate",
"value"
],
"additionalProperties": {}
}
},
"facts_total": {
"type": "number"
},
"full_file": {
"type": "object",
"properties": {
"page": {
"type": "string"
},
"api": {
"type": "string"
},
"detail_full": {
"type": "string"
}
},
"required": [
"page",
"api"
],
"additionalProperties": {}
},
"kind": {
"type": [
"string",
"null"
]
},
"location": {
"type": "object",
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
}
},
"required": [
"country",
"region",
"city"
],
"additionalProperties": {}
},
"counts": {
"type": "object",
"properties": {
"facts": {
"type": "number"
},
"context_facts": {
"type": "number"
},
"self_reported": {
"type": "number"
},
"possible_matches": {
"type": "number"
},
"events": {
"type": "number"
}
},
"required": [
"facts",
"context_facts",
"self_reported",
"possible_matches",
"events"
],
"additionalProperties": {}
},
"recent_changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"occurred_at": {
"type": [
"string",
"null"
]
},
"summary": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
},
"required": [
"occurred_at",
"summary",
"source"
],
"additionalProperties": {}
}
},
"note": {
"type": "string",
"description": "Terms of use for the facts"
}
},
"required": [
"id",
"name",
"url",
"status",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢verify_business(id, query, activity, jurisdiction, amount, ...)
Verifies a business against the registry facts Jid holds. Input: a Jid id (or a name or registry number) and, optionally, an activity, jurisdiction and amount. With an activity it returns a decision (proceed, review, stop or insufficient_data) with reasons: each names the requirement, met (true, false or unknown), the fact ids, source, verified_at and fresh_until, plus a signed receipt_id. Without an activity it returns the status and the top cited facts. Default output is compact (verdict, reasons, status, identifiers, top facts, receipt reference); detail "full" adds every cited fact and the full signed receipt. Activities: general_commerce (General commerce (default)); sell_prescription_drugs (Sell prescription drugs); manufacture_drugs (Manufacture drugs); sell_medical_devices (Sell medical devices); haul_freight (Haul freight (for-hire motor carrier)); broker_freight (Broker freight); sell_alcohol (Sell alcohol (wholesale or import)); produce_spirits (Produce distilled spirits); provide_investment_advice (Provide investment advice); accept_deposits (Accept deposits); lend (Lend); bill_medicare_medicaid (Bill Medicare or Medicaid); healthcare_supplier (Health care supplier); federal_contracting (Federal contracting); charitable_solicitation (Charitable solicitation); construction (Construction or home improvement (contractor)); operate_psilocybin_healing_center (Operate a psilocybin healing or service centre (CO, OR)).
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Jid file id (preferred)",
"type": "string"
},
"query": {
"description": "Name or registry number, used when no id is known",
"type": "string",
"minLength": 2,
"maxLength": 200
},
"activity": {
"description": "What the business is about to do for you. Defaults to general_commerce when jurisdiction or amount is given.",
"type": "string",
"enum": [
"general_commerce",
"sell_prescription_drugs",
"manufacture_drugs",
"sell_medical_devices",
"haul_freight",
"broker_freight",
"sell_alcohol",
"produce_spirits",
"provide_investment_advice",
"accept_deposits",
"lend",
"bill_medicare_medicaid",
"healthcare_supplier",
"federal_contracting",
"charitable_solicitation",
"construction",
"operate_psilocybin_healing_center"
]
},
"jurisdiction": {
"description": "US state as US-XX (for example US-CO) or an ISO country code",
"type": "string",
"maxLength": 5
},
"amount": {
"description": "Transaction amount, recorded on the receipt as context only",
"type": "number",
"minimum": 0
},
"currency": {
"description": "ISO 4217 currency of amount, default USD",
"type": "string",
"minLength": 3,
"maxLength": 3
},
"detail": {
"description": "compact (default): the verdict, status, identifiers and top facts with sources; full: every fact with its provenance",
"type": "string",
"enum": [
"compact",
"full"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"decision": {
"description": "With an activity: the decision object; with no file matched: \"insufficient_data\"",
"anyOf": [
{
"type": "object",
"properties": {
"decision": {
"type": "string",
"description": "proceed | review | stop | insufficient_data"
},
"activity": {
"type": "string"
},
"jurisdiction": {
"type": [
"string",
"null"
]
},
"amount": {
"type": [
"number",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"reasons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"requirement": {},
"met": {
"description": "true, false or \"unknown\"",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"const": "unknown"
},
{
"type": "null"
}
]
},
"effect": {},
"detail": {},
"source": {
"description": "Compact: the source name; full: the source object"
},
"source_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
},
"fresh_until": {
"type": [
"string",
"null"
]
},
"fact_ids": {
"type": "array",
"items": {}
}
},
"required": [
"code"
],
"additionalProperties": {}
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"rules_version": {
"type": "string"
},
"rules_url": {
"type": "string"
},
"not_legal_advice": {},
"receipt_id": {
"type": "string"
}
},
"required": [
"decision",
"activity",
"reasons",
"receipt_id"
],
"additionalProperties": {}
},
{
"type": "string"
}
]
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string"
},
"verify_url": {
"type": "string"
},
"url": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"signature": {
"type": "object",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
}
},
"required": [
"alg",
"kid"
],
"additionalProperties": {}
},
"keys": {
"type": "string"
}
},
"required": [
"receipt_id"
],
"additionalProperties": {},
"description": "Signed receipt reference; get_receipt returns the full signed statement"
},
{
"type": "object",
"properties": {},
"additionalProperties": {}
}
]
},
"file": {
"description": "With an activity: the business the decision is about",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"file_checked_at": {
"type": [
"string",
"null"
]
},
"owner_status": {
"description": "claimed | public_record",
"type": "string"
},
"status": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"flags": {
"description": "Compact: \"tone: label\" strings; full: objects",
"type": "array",
"items": {}
},
"rules": {
"type": "string"
}
},
"required": [
"status"
],
"additionalProperties": {}
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {}
},
"required": [
"type",
"value"
],
"additionalProperties": {}
}
},
"identifiers_total": {
"type": "number"
},
"websites_verified": {
"type": "array",
"items": {
"type": "string"
}
},
"top_facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"predicate": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {},
"value_truncated": {
"type": "boolean",
"const": true
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"predicate",
"value"
],
"additionalProperties": {}
}
},
"facts_total": {
"type": "number"
},
"full_file": {
"type": "object",
"properties": {
"page": {
"type": "string"
},
"api": {
"type": "string"
},
"detail_full": {
"type": "string"
}
},
"required": [
"page",
"api"
],
"additionalProperties": {}
}
},
"required": [
"id",
"name",
"url",
"status"
],
"additionalProperties": {}
},
"resolved_from": {
"anyOf": [
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"chosen": {
"type": "string"
},
"matched_on": {},
"other_candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": {}
}
}
},
"required": [
"query",
"chosen"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"file_checked_at": {
"type": [
"string",
"null"
]
},
"owner_status": {
"description": "claimed | public_record",
"type": "string"
},
"status": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"summary": {
"type": [
"string",
"null"
]
},
"flags": {
"description": "Compact: \"tone: label\" strings; full: objects",
"type": "array",
"items": {}
},
"rules": {
"type": "string"
}
},
"required": [
"status"
],
"additionalProperties": {}
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"value": {}
},
"required": [
"type",
"value"
],
"additionalProperties": {}
}
},
"identifiers_total": {
"type": "number"
},
"websites_verified": {
"type": "array",
"items": {
"type": "string"
}
},
"top_facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"predicate": {
"type": "string"
},
"label": {
"type": "string"
},
"value": {},
"value_truncated": {
"type": "boolean",
"const": true
},
"source": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"predicate",
"value"
],
"additionalProperties": {}
}
},
"facts_total": {
"type": "number"
},
"full_file": {
"type": "object",
"properties": {
"page": {
"type": "string"
},
"api": {
"type": "string"
},
"detail_full": {
"type": "string"
}
},
"required": [
"page",
"api"
],
"additionalProperties": {}
},
"query": {
"type": "string"
},
"result": {
"type": "string",
"const": "no_file"
},
"message": {
"type": "string"
},
"note": {
"type": "string",
"description": "Terms of use for the facts"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢get_receipt(receipt_id)
Returns a stored, Ed25519-signed verification receipt by receipt_id: the inputs, decision, reasons, fact ids and value hashes, rules version and time of the check. Free; does not count as a check.
Input Schema
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"description": "rcpt_... from verify_business"
}
},
"required": [
"receipt_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string"
},
"url": {
"type": "string"
},
"statement": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The signed statement: inputs, decision, reasons, fact ids and value hashes, rules version, time"
},
"signature": {
"type": "object",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
},
"canonicalization": {
"type": "string"
},
"sig": {
"type": "string"
}
},
"required": [
"alg",
"kid",
"sig"
],
"additionalProperties": {}
},
"verify": {
"type": "string"
},
"retained_until_about": {
"type": "string"
}
},
"required": [
"receipt_id",
"url",
"statement",
"signature"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢qualify_counterparty(email, domain, company_name, form_type, message, ...)
Qualifies 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.
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "Sender's e-mail address",
"type": "string",
"maxLength": 254
},
"domain": {
"description": "Company domain, when no e-mail is available",
"type": "string",
"maxLength": 253
},
"company_name": {
"description": "Company name as stated by the sender",
"type": "string",
"maxLength": 200
},
"form_type": {
"type": "string",
"enum": [
"seller_application",
"acquisition_inquiry",
"buyer_registration",
"nda_request",
"sourcing_request",
"listing_request",
"consultation",
"partnership",
"contact",
"other",
"vendor_claim",
"listing_claim",
"sponsor_inquiry",
"advertiser",
"broker_request",
"buyer_inquiry",
"seller_inquiry",
"data_purchase"
],
"description": "What kind of submission this is"
},
"message": {
"description": "The submission's free text (hashed, never stored)",
"type": "string",
"maxLength": 5000
},
"stated_value": {
"description": "Deal or purchase size the sender states, USD",
"type": "number",
"minimum": 0
},
"stated_role": {
"description": "The sender's stated role",
"type": "string",
"enum": [
"buyer",
"seller",
"supplier",
"investor",
"operator"
]
},
"country": {
"description": "Stated country, ISO 3166-1 alpha-2",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"ip_country": {
"description": "Country the submission came from, ISO alpha-2 (location consistency check)",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"ip_region": {
"description": "Region the submission came from (ISO 3166-2, e.g. US-CA or CA)",
"type": "string",
"maxLength": 10
},
"ip_asn": {
"description": "ASN of the submitting network, to recognise hosting and VPN networks",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"browser_timezone": {
"description": "IANA time zone reported by the submitter's browser",
"type": "string",
"maxLength": 60
},
"stated_country": {
"description": "Country the submitter stated (same as country)",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"signal": {
"description": "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",
"type": "string",
"maxLength": 800
},
"site": {
"description": "The submitting website's domain (binds the signal token)",
"type": "string",
"maxLength": 253
},
"activity": {
"description": "Regulated activity whose licences matter, if any",
"type": "string",
"enum": [
"general_commerce",
"sell_prescription_drugs",
"manufacture_drugs",
"sell_medical_devices",
"haul_freight",
"broker_freight",
"sell_alcohol",
"produce_spirits",
"provide_investment_advice",
"accept_deposits",
"lend",
"bill_medicare_medicaid",
"healthcare_supplier",
"federal_contracting",
"charitable_solicitation",
"construction",
"operate_psilocybin_healing_center"
]
},
"claimed_website": {
"description": "For vendor_claim / listing_claim: the website of the business or listing being claimed (enables the affiliation check)",
"type": "string",
"maxLength": 300
},
"summary": {
"description": "Add a short plain-English summary grounded in the signals (with an API key only)",
"type": "boolean"
},
"policy": {
"description": "How cautious `engage` is (default balanced)",
"type": "string",
"enum": [
"strict",
"balanced",
"permissive"
]
},
"detail": {
"description": "compact (default): signals without raw values and a receipt reference; full: raw signal values and the full signed receipt",
"type": "string",
"enum": [
"compact",
"full"
]
}
},
"required": [
"form_type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"assessment": {
"type": "string",
"description": "business | individual_or_unverified"
},
"recommendation": {
"description": "engage | verify_first | do_not_engage, with the reason"
},
"read": {
"type": "object",
"properties": {
"headline": {
"type": "string",
"description": "One line, e.g. \"Passed all 7 checks Jid could run. Recommendation: engage.\""
},
"recommendation": {
"type": "string",
"description": "engage | verify_first | do_not_engage"
},
"passed": {
"type": "number"
},
"total": {
"type": "number"
},
"reason": {
"type": "string"
},
"failed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"lookup": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"label",
"evidence"
],
"additionalProperties": {}
},
"description": "Failed checks, worst first, at most 3"
},
"not_checked": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"headline",
"recommendation",
"passed",
"total",
"failed"
],
"additionalProperties": {},
"description": "What a person sees: headline, recommendation, failed checks and lookup links"
},
"signals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"effect": {},
"detail": {},
"source": {},
"source_url": {
"type": [
"string",
"null"
]
},
"verified_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"name"
],
"additionalProperties": {}
}
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"description": "pass | fail | unknown | not_applicable"
},
"severity": {
"type": "string"
},
"evidence": {
"type": "string"
}
},
"required": [
"id",
"status"
],
"additionalProperties": {}
}
},
"legitimacy": {
"anyOf": [
{
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"reasons": {
"type": "array",
"items": {}
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"capacity": {
"anyOf": [
{
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"reasons": {
"type": "array",
"items": {}
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"consistency": {
"anyOf": [
{
"type": "object",
"properties": {
"score": {
"type": [
"number",
"null"
]
},
"reasons": {
"type": "array",
"items": {}
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"suggested_next_step": {
"type": "string"
},
"questions_to_ask": {
"type": "array",
"items": {
"type": "string"
}
},
"entity": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"relied_on": {
"type": "boolean"
}
},
"required": [
"id"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"summary": {
"type": [
"string",
"null"
]
},
"receipt": {
"anyOf": [
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string"
},
"verify_url": {
"type": "string"
},
"url": {
"type": "string"
},
"issued_at": {
"type": "string"
},
"signature": {
"type": "object",
"properties": {
"alg": {
"type": "string"
},
"kid": {
"type": "string"
}
},
"required": [
"alg",
"kid"
],
"additionalProperties": {}
},
"keys": {
"type": "string"
}
},
"required": [
"receipt_id"
],
"additionalProperties": {},
"description": "Signed receipt reference; get_receipt returns the full signed statement"
},
{
"type": "object",
"properties": {},
"additionalProperties": {}
}
]
},
"checked_at": {
"type": "string"
},
"checks_used": {
"type": "number"
},
"note": {
"type": "string",
"description": "Terms of use for the facts"
}
},
"required": [
"id",
"assessment",
"recommendation",
"read",
"signals",
"checks",
"checks_used",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢screen(domain, url, email, phone, company_name, ...)
Screens 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.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"description": "Company domain",
"type": "string",
"maxLength": 253
},
"url": {
"description": "Website or page URL (purchase checks: only the host is used)",
"type": "string",
"maxLength": 2000
},
"email": {
"description": "Sender e-mail address (hashed on the receipt, never stored)",
"type": "string",
"maxLength": 254
},
"phone": {
"description": "Phone number, ideally in +E.164",
"type": "string",
"maxLength": 40
},
"company_name": {
"description": "Company name as stated",
"type": "string",
"maxLength": 200
},
"context": {
"description": "What engaging means here; default lead (purchase when only a url or domain is given)",
"type": "string",
"enum": [
"lead",
"inbound_email",
"partnership",
"vendor",
"purchase",
"marketplace_seller",
"agent_action"
]
},
"amount": {
"description": "Amount at stake, USD",
"type": "number",
"minimum": 0
},
"policy": {
"description": "strict, balanced (default) or permissive",
"type": "string",
"enum": [
"strict",
"balanced",
"permissive"
]
},
"country": {
"description": "Default country for a phone number without +, ISO alpha-2",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"ip_country": {
"description": "Country the request came from (ISO alpha-2), for the location consistency check",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"ip_region": {
"description": "Region of the request (ISO 3166-2, e.g. US-CA or CA)",
"type": "string",
"maxLength": 10
},
"ip_asn": {
"description": "ASN of the request's network, to recognise hosting and VPN networks",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"browser_timezone": {
"description": "IANA time zone reported by the browser",
"type": "string",
"maxLength": 60
},
"stated_country": {
"description": "Country the counterparty stated",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"signal": {
"description": "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",
"type": "string",
"maxLength": 800
},
"site": {
"description": "The submitting website's domain (binds the signal token)",
"type": "string",
"maxLength": 253
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"engage": {
"type": "boolean"
},
"risk": {
"type": "string",
"description": "low | medium | high | unknown"
},
"confidence": {
"type": "number"
},
"subject_type": {
"type": "string"
},
"policy": {
"type": "string"
},
"context": {
"type": "string"
},
"summary": {
"type": "string"
},
"reasons": {
"type": "array",
"items": {}
},
"mitigations": {
"type": "array",
"items": {}
},
"read": {
"type": "object",
"properties": {
"headline": {
"type": "string",
"description": "One line, e.g. \"Passed all 7 checks Jid could run. Recommendation: engage.\""
},
"recommendation": {
"type": "string",
"description": "engage | verify_first | do_not_engage"
},
"passed": {
"type": "number"
},
"total": {
"type": "number"
},
"reason": {
"type": "string"
},
"failed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"lookup": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"label",
"evidence"
],
"additionalProperties": {}
},
"description": "Failed checks, worst first, at most 3"
},
"not_checked": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"headline",
"recommendation",
"passed",
"total",
"failed"
],
"additionalProperties": {},
"description": "What a person sees: headline, recommendation, failed checks and lookup links"
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"description": "pass | fail | unknown | not_applicable"
},
"severity": {
"type": "string"
},
"evidence": {
"type": "string"
}
},
"required": [
"id",
"status"
],
"additionalProperties": {}
}
},
"entity": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"name",
"url"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"receipt_id": {
"type": "string"
},
"receipt_url": {
"type": "string"
},
"rules_url": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"checks_used": {
"type": "number"
},
"note": {
"type": "string",
"description": "Terms of use for the facts"
}
},
"required": [
"engage",
"risk",
"confidence",
"subject_type",
"reasons",
"read",
"checks",
"receipt_id",
"checks_used",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢check_email(headers)
Checks whether an e-mail is from who it claims. Input: the raw headers of a message (as shown by Show original or View source). Returns checks and a read (headline, recommendation engage | verify_first | do_not_engage, failed checks, lookup links): DMARC/SPF/DKIM as the receiving server recorded them, DKIM alignment with From, Reply-To going to another domain, and a From domain or display name that imitates a known business. The headers are processed in memory and never stored. Deterministic, no AI. Counts as 1 check with a key; free tier without one.
Input Schema
{
"type": "object",
"properties": {
"headers": {
"type": "string",
"maxLength": 65536,
"description": "The raw message headers, as one string (the body is not needed)"
}
},
"required": [
"headers"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"read": {
"type": "object",
"properties": {
"headline": {
"type": "string",
"description": "One line, e.g. \"Passed all 7 checks Jid could run. Recommendation: engage.\""
},
"recommendation": {
"type": "string",
"description": "engage | verify_first | do_not_engage"
},
"passed": {
"type": "number"
},
"total": {
"type": "number"
},
"reason": {
"type": "string"
},
"failed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"evidence": {
"type": "string"
},
"lookup": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"required": [
"label",
"evidence"
],
"additionalProperties": {}
},
"description": "Failed checks, worst first, at most 3"
},
"not_checked": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"headline",
"recommendation",
"passed",
"total",
"failed"
],
"additionalProperties": {},
"description": "What a person sees: headline, recommendation, failed checks and lookup links"
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"description": "pass | fail | unknown | not_applicable"
},
"severity": {
"type": "string"
},
"evidence": {
"type": "string"
}
},
"required": [
"id",
"status"
],
"additionalProperties": {}
}
},
"from_domain": {
"type": [
"string",
"null"
]
},
"reply_to_domain": {
"type": [
"string",
"null"
]
},
"authentication": {
"anyOf": [
{
"type": "object",
"properties": {
"spf": {
"type": [
"string",
"null"
]
},
"dmarc": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"rules_version": {
"type": "string"
},
"checked_at": {
"type": "string"
},
"checks_used": {
"type": "number"
},
"note": {
"type": "string",
"description": "Terms of use for the facts"
}
},
"required": [
"read",
"checks",
"from_domain",
"checks_used",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}Community
Evidence
Recent observations
verifiedversion not recorded7 tools
verifiedversion not recorded7 tools