Jid: the trust API for AI agents

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Verify a business before an agent pays, signs or buys: registry-cited decision and signed receipt.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Jid: the trust API for AI agents": {
      "url": "https://jid.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• search_business read-only

  Finds Jid business files by name or by any registry number (FEI, LEI, SEC CIK, DUNS, NDC labeler code, state licence or entity number, French SIREN or SIRET). Returns candidate files with status and match evidence. For a French company pass country "FR": the SIRENE register is searched live and files are created on demand.

  Parameters:

  • query (required) — string — Business name or registry number
  • country — string — ISO country code. "FR" also searches the French SIRENE register live (a SIREN or SIRET is looked up there anyway).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_business_file read-only

  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.

  Parameters:

  • id (required) — string — Jid file id from search_business, e.g. gland-pharma-limited-j9nehi
  • detail — string — compact (default): the verdict, status, identifiers and top facts with sources; full: every fact with its provenance

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_business read-only

  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)).

  Parameters:

  • id — string — Jid file id (preferred)
  • query — string — Name or registry number, used when no id is known
  • amount — number — Transaction amount, recorded on the receipt as context only
  • detail — string — compact (default): the verdict, status, identifiers and top facts with sources; full: every fact with its provenance
  • activity — string — What the business is about to do for you. Defaults to general_commerce when jurisdiction or amount is given.
  • currency — string — ISO 4217 currency of amount, default USD
  • jurisdiction — string — US state as US-XX (for example US-CO) or an ISO country code

  Hints: read-only yes · destructive no · idempotent no · open-world no

• get_receipt read-only

  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.

  Parameters:

  • receipt_id (required) — string — rcpt_... from verify_business

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• qualify_counterparty read-only

  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.

  Parameters:

  • form_type (required) — string — What kind of submission this is
  • site — string — The submitting website's domain (binds the signal token)
  • email — string — Sender's e-mail address
  • detail — string — compact (default): signals without raw values and a receipt reference; full: raw signal values and the full signed receipt
  • domain — string — Company domain, when no e-mail is available
  • ip_asn — integer — ASN of the submitting network, to recognise hosting and VPN networks
  • policy — string — How cautious `engage` is (default balanced)
  • signal — string — 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 — string — Stated country, ISO 3166-1 alpha-2
  • message — string — The submission's free text (hashed, never stored)
  • summary — boolean — Add a short plain-English summary grounded in the signals (with an API key only)
  • activity — string — Regulated activity whose licences matter, if any
  • ip_region — string — Region the submission came from (ISO 3166-2, e.g. US-CA or CA)
  • ip_country — string — Country the submission came from, ISO alpha-2 (location consistency check)
  • stated_role — string — The sender's stated role
  • company_name — string — Company name as stated by the sender
  • stated_value — number — Deal or purchase size the sender states, USD
  • stated_country — string — Country the submitter stated (same as country)
  • claimed_website — string — For vendor_claim / listing_claim: the website of the business or listing being claimed (enables the affiliation check)
  • browser_timezone — string — IANA time zone reported by the submitter's browser

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• screen read-only

  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.

  Parameters:

  • url — string — Website or page URL (purchase checks: only the host is used)
  • site — string — The submitting website's domain (binds the signal token)
  • email — string — Sender e-mail address (hashed on the receipt, never stored)
  • phone — string — Phone number, ideally in +E.164
  • amount — number — Amount at stake, USD
  • domain — string — Company domain
  • ip_asn — integer — ASN of the request's network, to recognise hosting and VPN networks
  • policy — string — strict, balanced (default) or permissive
  • signal — string — 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 — string — What engaging means here; default lead (purchase when only a url or domain is given)
  • country — string — Default country for a phone number without +, ISO alpha-2
  • ip_region — string — Region of the request (ISO 3166-2, e.g. US-CA or CA)
  • ip_country — string — Country the request came from (ISO alpha-2), for the location consistency check
  • company_name — string — Company name as stated
  • stated_country — string — Country the counterparty stated
  • browser_timezone — string — IANA time zone reported by the browser

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• check_email read-only

  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.

  Parameters:

  • headers (required) — string — The raw message headers, as one string (the body is not needed)

  Hints: read-only yes · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.