get_companies is an authenticated Jolts MCP tool. Connect your assistant first.
Retrieve existing company evidence for one to twenty known targets. Supply either ids
(positive integers) or domains (hostnames), never both. A single target uses a one-element
array. This operation does not call providers or AI, discover missing companies, or refresh data.
Arguments
Supply exactly one target array. Unknown arguments are rejected. Use hostnames, not full URLs or
email addresses. See known-account research for a workflow.
Example call
This is theparams object of a JSON-RPC tools/call, not a complete HTTP request.
companies list and a lookups
list accounting for every normalized, distinct target. Outcomes are found, not_found, or
ambiguous; an identical retry can report unavailable when previously delivered support is
no longer eligible. A miss means absent from our permitted dataset, not that the company does not
exist. Shared domains never silently select an arbitrary company.
Each returned company has identity, supported domains and up to three recent observations.
This is not a complete organization profile. Source references and observation dates accompany
the evidence. A completed lookup consumes one request unit and one delivered unit per distinct
company. Missing or ambiguous targets consume no company units. There are no overage charges.
Provide request_key or the Idempotency-Key header. Identical retries reuse the settled
operation; changing targets requires a new key. Current subscription and capacity limits apply.
Read the response
Readresult.structuredContent; text-only clients receive the same JSON in result.content.
Check result.isError before using data. A successful HTTP status alone does not prove tool success.
See response examples and error handling.
For the complete result fields, see the HTTP lookup response.
If the operation is pending, retain
usage.id and call get_usage instead of
submitting another lookup under a new key.